Hyprland

Estimated reading: 3 minutes 112 views

Nitrux ships with a preconfigured Hyprland environment.

Appearance

Gaps → 5px inner, 10px outer.
Border → 1px, gradient from cyan to green (active), gray (inactive).
Corner rounding → 12px.
Opacity → 100% active, 80% inactive.
Blur → Enabled, three passes.
Animations → Enabled.
Layout → Dwindle.

Input

Keyboard layout → US.
Mouse sensitivity → Default (0).
Touchpad natural scroll → Disabled.
Focus follows mouse → Enabled.

Idle and Lock (hypridle)

5 minutes (300s) → Screen dims.
5 min 50s (350s) → Lock screen activates.
8 min 20s (500s) →Display turns off.
10 min 50s (650s) → System suspends.

The lock screen activates automatically before sleep and when the lid is closed.

Lock Screen (hyprlock)

Wallpaper → /usr/share/wallpapers/Aqua/contents/images/2560x1440.png
Color scheme → Catppuccin Mocha.
Font → Switzer.
Elements → Time, date, user avatar, password input, battery status, media player.

Wallpaper (hyprpaper)

Default wallpaper: /usr/share/wallpapers/Aqua/contents/images/2560x1440.png

Autostart

The following services and applications start automatically:

Display → Hyprscreend, Hyprextscreend, Hyprpaper.
Bar and dock → Waybar, Crystal Dock.
Session → Hypridle, Hyprlock (on idle/lid close).
Notifications → SwayNC.
Clipboard → Clipvault.
Audio → PipeWire.
Portals → XDG portals.
Background services → NX AppHub daemon, GameMode, OpenRazer daemon, NX Dynamic PPD, NX Battery Notify.

Keybinds

These are the default keybinds in our Hyprland configuration. Nitrux uses Super (Windows key) as the main modifier.

Applications

Super + Q → Terminal (Station).
Super + E → File manager (Index).
Super + W → Web browser (Fiery).
Super + R → Application launcher (Wofi).

Windows

Super + C → Close window.
Super + V → Toggle floating.
Super + F → Fullscreen.
Super + P → Pseudotile (dwindle).
Super + J → Toggle split (dwindle).
Super + Arrow keys → Move focus.
Super + LMB drag → Move window.
Super + RMB drag → Resize window.

Workspaces

Hyprland does not use “maximize” or “minimize”; windows are either regular size, floating, or full screen. To hide a window, move it to another workspace

Super + 1–0 → Switch to workspace 1–10.
Super + Shift + 1–0 → Move window to workspace 1–10.

Session

Super + L → Lock screen.
Super + M → Terminate session.
Super + Shift + P → Session options (wlogout).

Screenshots

Print → Full screenshot.
Super + Print → Selection screenshot.
Shift + Print → Window screenshot.

Clipboard

Super + Shift + V → Show clipboard history.
Super + Shift + C → Clear the clipboard.

Media Keys

XF86AudioRaiseVolume → Volume up.
XF86AudioLowerVolume → Volume down.
XF86AudioMute → Toggle mute.
XF86AudioPlay → Play/pause.
XF86AudioNext → Next track.
XF86AudioPrev → Previous track.
XF86MonBrightnessUp → Brightness up.
XF86MonBrightnessDown → Brightness down.

Utilities

Super + Shift + D → Restart Crystal Dock.
Super + Shift + S → Restart system tray.
Super + Shift + W → Restart Waybar.

Configuration Files

~/.config/hypr/hyprland.conf → Main Hyprland configuration.
~/.config/hypr/hypridle.conf → Idle behavior.
~/.config/hypr/hyprlock.conf → Lock screen appearance.
~/.config/hypr/hyprlock_colors.conf → Lock screen color scheme.
~/.config/hypr/hyprpaper.conf → Wallpaper.

Important Notes

Hyprland Documentation: https://wiki.hypr.land/

Display configuration is handled automatically by Hyprscreend, a set of daemons that change the screen refresh rate based on the power source developed by Nitrux.