Hyprland

Hyprland is intentionally scoped to nix-haxorus. Other hosts keep the shared GNOME/GDM baseline and do not inherit Hyprland, Waybar, rofi, mako, or related user services.

Session Model

Hyprland uses UWSM. In GDM, choose the Hyprland (uwsm-managed) session.

UWSM wraps the compositor as a systemd-managed Wayland session. That gives cleaner environment propagation, XDG autostart behavior, and shutdown handling than launching the compositor as a plain process.

Companion Apps

AppRole
GhosttyDefault terminal.
ZellijTerminal workspace launched through Ghostty.
rofiApp and run launcher.
WaybarPanel.
hyprpaperWallpaper service.
hypridleIdle handling.
hyprlockLock screen.
makoNotifications.
grim, slurp, sattyScreenshot flow.

Ghostty is shared config, but Hyprland binds it directly with Super-Return. Super-Z launches ghostty -e zellij.

Theme

TokenValue
Background#151516
Surface#181818
Border#2a2a2a
Accent#51a4e7
Inner gap4
Outer gap8
Rounding8

The same palette is used by Hyprland, rofi, and the local Zellij marble theme.

Keybinds

KeyAction
Super-ReturnOpen Ghostty
Super-ZOpen Ghostty with Zellij
Super-BOpen Zen Browser
Super-EOpen Nautilus
Super-R, Super-SpaceOpen rofi app launcher
Super-POpen rofi run launcher
Super-Shift-RReload Hyprland config
Super-Shift-LLock session
Super-QClose focused window
Super-Shift-FToggle centered floating
Super-Shift-GToggle fullscreen
Super-Shift-HToggle fake fullscreen
Super-Shift-JToggle Dwindle split
Super-h/j/k/lMove focus
Super-arrow
Super-Ctrl-h/j/k/lResize focused window
Super-Alt-h/j/k/lMove focused window
Super-1..0Switch to workspace 1..10
Super-Shift-1..0Move window to workspace 1..10
Super-SToggle scratch workspace
Super-Shift-SMove window to scratch workspace
Super-mouse1Drag window
Super-mouse2Resize window
PrintRegion screenshot with editor
Shift-PrintFull screenshot with editor
Ctrl-PrintRegion screenshot, no editor
Ctrl-Shift-PrintFull screenshot, no editor

Media keys control PipeWire volume, brightness, and playerctl.

Screenshot paths save to ~/Pictures/Screenshots, copy to clipboard, and notify.

References

  • Hyprland wiki: NixOS
  • Hyprland wiki: Home Manager
  • Hyprland wiki: Systemd startup