4.2 KiB
configs/fwbook/hypr/
Host-specific Hyprland configuration for fwbook. Symlinked to ~/.config/hypr
by the skyg.nixos.desktop.tiler.hyprland module, which defaults its
configName to the machine hostName (configs/${hostName}/hypr).
Why it lives here (and not configs/hypr)
The Hyprland module links configs/<configName>/hypr -> ~/.config/hypr, with
configName defaulting to the hostName. Keeping the config under
configs/fwbook/ lets each host own its own Hyprland tweaks (monitors, etc.)
without stepping on other machines. The old shared configs/hypr/ (waybar +
hyprpanel) was removed when this replaced it.
Config format: Lua
Written in Lua (hyprland.lua), not hyprlang. Hyprland 0.55+ deprecated
hyprlang in favor of Lua, and reads ~/.config/hypr/hyprland.lua. Files are
split under conf/ and pulled in with require().
The folder is named
conf, nothyprland.d, because Hyprland'srequire()treats.as a path separator —require("hyprland.d/env")would resolve tohyprland/d/env.
Design
- Layout: Hyprland's native
scrollinglayout (0.54+), no plugins required. This mirrors niri's scrollable-tiling model. Seeconf/general.lua. - Shell: noctalia (
noctalia-shell), autostarted inconf/autostart.luaviahl.on("hyprland.start", ...). There is intentionally no waybar/hyprpanel. - Keybinds:
conf/keybindings.luamirrorsconfigs/niri/shared/binds.kdlandconfigs/niri/noctalia/binds.kdlas closely as Hyprland allows. - Overview: there is no native Hyprland overview, and no overview plugin that
reliably builds against current Hyprland (hyprexpo was retired from the
official plugins repo; the community fork chases
main).Mod+Tabfalls back tocyclenextinstead of niri'stoggle-overview.
Files
hypr/
├── hyprland.lua # entry point; require()s conf/*.lua in order
├── screen-record.sh # wf-recorder toggle (bound to Mod+R)
└── conf/
├── env.lua # cursor size + Wayland/Qt/Electron env hints (hl.env)
├── general.lua # scrolling layout, gaps/border/rounding (hl.config)
├── monitors.lua # hl.monitor per display (from configs/niri/.../outputs.kdl)
├── inputs.lua # touchpad tap + natural scroll, kb us, hl.gesture
├── window-rules.lua # hl.window_rule floats for small dialogs/utilities
├── keybindings.lua # niri + noctalia binds, scrolling dispatchers (hl.bind/hl.dsp)
└── autostart.lua # noctalia, hypridle via UWSM (hl.on hyprland.start)
Bindings without a clean 1:1 niri mapping
Mod+Shift+H(show-hotkey-overlay) — no native Hyprland equivalent; left commented.Mod+Escape(toggle-keyboard-shortcuts-inhibit) — no native equivalent; omitted.Mod+W(toggle-column-tabbed-display) — mapped tohl.dsp.group.toggle()as the nearest analog.Mod+Tab(toggle-overview) — no native overview / no buildable plugin; mapped tocyclenext.
Touchpad gestures (niri parity)
niri's 3-finger swipes are mirrored in conf/inputs.lua:
- Horizontal →
scroll_move(scroll through columns along the tape) - Vertical →
workspace(switch workspaces up/down) - Mod + swipe (any direction) → move the whole workspace to the monitor in
that direction (
movecurrentworkspacetomonitor), mirroring niri'sMod+TouchpadScroll*binds. This replaced the oldMod + mouse wheelapproach.
The gesture action is
scroll_move(underscore), notscrollmove. Themods = "SUPER"mask is what lets the Mod + swipe variants coexist with the plain swipes. Both require a Hyprland new enough to expose configurable Lua gestures (0.55+). The olderscrollmovename and thescrollmoveaction do not exist — they error with "unknown action".
Behavior deltas from the old hyprlang config
Ctrl+Alt+Deleterunsuwsm stop(not theexitdispatcher). The Hyprland wiki warns UWSM users thatexitbreaks the ordered shutdown sequence.Mod+Shift+-/=(window height) uses a fixed pixel delta instead of a percent, since the Luawindow.resizedispatcher takes pixels, not%.