Hyprland
The Genesi Hyprland edition — a Wayland tiling compositor with the Caelestia shell.
Hyprland is a dynamic tiling Wayland compositor: windows arrange themselves automatically and you drive everything from the keyboard. Genesi's Hyprland edition pairs it with Caelestia, a Quickshell-based shell that provides the bar, launcher, and notifications — a keyboard-first alternative to KDE that still inherits the full Genesi experience.
Pick Hyprland-Desktop in the installer, or install it later and select the Hyprland session at login.
Where the config lives
~/.config/hypr/hyprland.conf # Hyprland — monitors, input, keybinds, rules
~/.config/caelestia/ # the Caelestia shell (bar, launcher, theming)Edit hyprland.conf and Hyprland reloads on save; to force a reload:
hyprctl reloadFinding your keybinds
Rather than memorize a list, read the ones your config actually defines — they're
the bind = lines:
grep -h '^bind' ~/.config/hypr/*.confBindings use the SUPER (Windows) key as the modifier. Common patterns you'll
see are SUPER + Q to close a window, SUPER + Return for a terminal, arrow
keys to move focus, and SUPER + [1-9] to switch workspaces — but always trust
your own config over any list, since Caelestia sets its own.
Hyprland is powerful and deeply configurable — animations, window rules, per-monitor layouts. The Hyprland wiki is the reference, and the Caelestia project documents the shell. The CachyOS Hyprland guide also applies to the underlying compositor.
On a hybrid-GPU laptop, a Wayland compositor like Hyprland needs the GPU set up correctly — see Dual GPU and GPU Drivers if you get a black screen on the Hyprland session.