Hyprland

Estimated reading: 3 minutes 269 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.
OSD → NudgeOSD.
Blue light filter → Hyprsunset.

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.
Super + Shift + N → Restart SwayNC.

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.
~/.config/hypr/hyprsunset.conf → Blue light filter configuration.

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.