3.4 KiB
configs/fwbook/quickshell/
Host-specific Quickshell configs for fwbook. Symlinked to ~/.config/quickshell
by the skyg.nixos.desktop.tiler.quickshell module, which defaults its
configName to the machine hostName (configs/${hostName}/quickshell).
Quickshell resolves each subdirectory as an independently named config, run
via qs -c <name> (or qs -p <path> for direct path testing without the
symlink). This is deliberately not part of noctalia/DMS — each qs -c <name>
here is its own standalone process/shell.
overview/
A niri-like scrolling overview for Hyprland, standing in for a native overview
plugin (Hyprland has none maintained against tagged releases — see
modules/nixos/desktop/tiler/ABOUTME.md).
- Model: the current monitor's workspaces are vertical rows, each row a
horizontal strip of that workspace's windows (columns), sorted by x-position
to match the Hyprland
scrollinglayout's tape order. - Controls: Arrow keys move the selection (Left/Right = window in the row, Up/Down = workspace row), Enter focuses the selection and closes, Esc cancels. No mouse-driven drag/resize.
- Previews: live via
Quickshell.Wayland.ScreencopyView, capturing each window'sHyprlandToplevel.waylandhandle. Capture only runs while the overview is visible (liveis bound to the window's visibility). - Focus dispatch: classic
hyprctl-style dispatcher strings ("workspace " + id,"focuswindow address:" + addr) viaHyprland.dispatch(...)— these work regardless of whether Hyprland's config is Lua or hyprlang, unlike the Lua-eval dispatch form.
Files
overview/
├── shell.qml # ShellRoot: IpcHandler (target "overview": toggle/open/close)
│ # + Variants { model: Quickshell.screens } instantiating one
│ # OverviewWindow per monitor
├── OverviewWindow.qml # per-monitor PanelWindow (layer-shell overlay); builds the
│ # workspace/window model from Quickshell.Hyprland, owns
│ # selection state, key handling, and HyprlandFocusGrab
├── WorkspaceRow.qml # one workspace = horizontal Row of WindowCards + label
├── WindowCard.qml # live ScreencopyView preview + icon/title footer + selection ring
└── Theme.qml # plain QtObject with colors/sizes, instantiated once per
# OverviewWindow and prop-drilled down (no singleton/qmldir)
Theme.qml and the other sibling .qml files are used without explicit
imports — Quickshell (like plain QML) makes same-directory files visible as
types automatically, no qmldir needed for single-directory configs like this
one.
Wiring (Hyprland side, configs/fwbook/hypr/)
conf/keybindings.lua—Mod+Tabrunsqs -c overview ipc call overview toggleconf/inputs.lua— 4-finger swipe up/down open/close it (discrete gesture, no swipe-progress animation)conf/autostart.lua— the daemon is started viasetpriv --ambient-caps -all -- qs -c overview(D-Bus calls in quickshell-based apps fail silently without this wrapper under this Hyprland/UWSM setup)
Testing without a rebuild
Since ~/.config/quickshell is a symlink into this repo, edits are live.
Test directly by path before relying on the installed symlink:
qs -p ~/nixos-setup/configs/fwbook/quickshell/overview
qs -p ~/nixos-setup/configs/fwbook/quickshell/overview ipc call overview toggle