Add a screenshot module wiring grimblast (grim + slurp) through the satty annotation editor, enabled by the desktop aggregator. Region, active-window, and full-screen captures each open in satty and, on confirm, land in both the clipboard and a dated file under ~/Pictures/Screenshots. Bound to Print / Shift+Print / Ctrl+Print rather than the spec's Super+L family, whose keys task 0021 already holds for hjkl focus and window movement.
2.8 KiB
spec, blocked-by
| spec | blocked-by |
|---|---|
| hyprland-desktop | 0021-desktop-group-and-hyprland-session |
What to build
Keyboard-driven screenshots that open in an annotation editor by default and land in both the clipboard and a file.
Add a screenshot module to the desktop group, enabled through the aggregator, using grim and slurp wrapped by grimblast and routed through the satty annotation editor so annotation is the default.
Cover region, active-window, and full-screen captures, each exporting to both the clipboard and a file.
Bind region on Super+L, active window on Super+Shift+L, and full screen on Super+Ctrl+L.
Acceptance criteria
- A screenshot module exists in the desktop group and is enabled by the aggregator.
- Region, active-window, and full-screen captures work, each opening in satty and exporting to both clipboard and file.
- [-] Captures are bound on
Super+L,Super+Shift+L, andSuper+Ctrl+L. - neogaia builds green under
nix flake check.
Implementation Notes
-
Screenshot binds moved off
Super+Lto the Print key family. Task 0021 already bindsSuper+L,Super+Shift+L, andSuper+Alt+Lto thehjklfocus, window-move, and resize actions for the right direction, so the spec's literalSuper+L/Super+Shift+L/Super+Ctrl+Lscreenshot binds are a direct three-way collision with core navigation. Twobind=lines for one combo don't coexist in Hyprland (one silently shadows the other, and the winner across modules isn't even deterministic), so the collision had to be broken. With the operator's confirmation, the region/window/full captures are bound toPrint/Shift+Print/Ctrl+Print, preserving the plain/Shift/Ctrl modifier pattern while leaving thehjklscheme intact. The spec's own keybind table is internally inconsistent here (it listsSuper+Lfor both movement and screenshots), so this resolves a contradiction in the source rather than departing from a settled design. -
Capture pipeline.
grimblast save <area|active|screen> -captures to stdout and pipes into satty, whose copy action is configured with--copy-command wl-copy --save-after-copy, so one confirmation lands the shot in both the clipboard and a dated file under~/Pictures/Screenshots.--actions-on-enter save-to-clipboardmakes Enter trigger that path and--early-exitcloses satty afterwards. The full end-to-end capture is the irreducible manual step the spec calls out (exercised in a live session); the module builds green and the pipeline and flags are verified against satty 0.21.1. -
No waybar icon for satty. The repo convention adds a
window-rewritemapping for each graphical application, but satty is a transient floating annotation window rather than a window that lives on a workspace, so at the operator's direction it gets no workspace glyph.