5.0 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 browsed 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,
Mcycles to the next monitor's overview, number keys 1-9 jump straight to the Nth monitor (sorted by Hyprland's monitor id) — also clickable via the monitor bar at the top of the screen. Hovering a window card also recenters the carousel on it (selection-only, doesn't focus/close). No drag/resize. - Monitor browsing vs. real focus: a single overlay window, anchored once
(per open) to whichever monitor was actually focused when the overview
opened, and never moved after that. Switching monitors while browsing (M /
number keys / the monitor bar) only updates local UI state
(
shell.browsedMonitorinshell.qml) that changes which monitor's workspace data this one fixed window displays — it never touches Hyprland's real focused monitor. This isn't just a style choice: aPanelWindow'sHyprlandFocusGrabrequires Hyprland's real seat focus to follow the window that holds it, so a one-overlay-per-screen design (switching which screen's overlay is visible) would force a real focus/cursor jump to whichever monitor you browsed to, every time. Only activating a window or workspace (Enter/click) dispatches a real Hyprland focus change. - 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: this Hyprland build's
hyprctl dispatch <name> <args>no longer accepts classic freeform dispatch text at all — every request is evaluated as Lua (hl.dispatch(<text>)), so the text must already be a validhl.dsp.*call. Verified forms:hl.dsp.focus({workspace = N}),hl.dsp.focus({window = "address:0x..."}),hl.dsp.focus({monitor = "name"})— sent viaQuickshell.execDetached(["hyprctl", "dispatch", ...])sinceHyprland.dispatch()hits the exact same broken classic-syntax path.
Files
overview/
├── shell.qml # ShellRoot: IpcHandler (target "overview": toggle/open/close),
│ # sets browsedMonitor + anchorScreen on open, owns the single
│ # OverviewWindow instance
├── OverviewWindow.qml # the one PanelWindow (layer-shell overlay), anchored to
│ # anchorScreen for the whole open session; builds the browsed
│ # monitor's workspace/window model from Quickshell.Hyprland,
│ # owns selection state, key handling, and HyprlandFocusGrab
├── MonitorBar.qml # row of clickable per-monitor pills, highlights browsedMonitor
├── WorkspaceRow.qml # one workspace = carousel Row of WindowCards + label
├── WindowCard.qml # live ScreencopyView preview + icon/title footer + selection ring
└── Theme.qml # plain QtObject with colors/sizes/carousel tuning, 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