dotfiles/docs/superpowers/specs/2026-04-28-screenshot-interactive-design.md

Interactive Screenshot Script Design

Date: 2026-04-28 Status: Approved

Summary

Replace the current minimal screenshot script with an interactive post-capture flow: a mako notification confirms the capture and offers an "Actions" button; clicking it opens a wofi dmenu with five options. Dismissing the notification requires no further interaction.

Current Behaviour

FILE=~/Pictures/screenshot-$(date +%s).png
grim -g "$(slurp)" "$FILE"
wl-copy < "$FILE"

Captures a region, saves to ~/Pictures/, copies to clipboard. No feedback, no post-capture options.

Flow

slurp (region select)
  └─ cancelled (exit ≠ 0)? → exit silently
grim → ~/Pictures/screenshot-<timestamp>.png
wl-copy → copy image bytes to clipboard
notify-send --wait
  title:  "Screenshot captured"
  body:   "Saved · Copied to clipboard"
  icon:   $FILE (mako shows thumbnail)
  action: "actions:Actions"
  timeout: 10 000 ms
  └─ dismissed / timed out → done
  └─ "Actions" clicked → wofi --dmenu --prompt "Screenshot"
      ├─ Annotate with swappy   (default, top)
      ├─ Annotate with satty
      ├─ Open in imv
      ├─ Copy path
      └─ Delete

Actions

Choice	Command	Follow-up
Annotate with swappy	swappy -f "$FILE" &	swappy handles its own save
Annotate with satty	satty --filename "$FILE" &	satty handles its own save
Open in imv	imv "$FILE" &	none
Copy path	printf '%s' "$FILE" | wl-copy	notification: "Path copied"
Delete	rm "$FILE"	notification: "Screenshot deleted"

Annotation tools are launched in background so the script does not block waiting for them.

Edge Cases

• slurp cancelled: grim exits non-zero; script checks $? and exits cleanly with no notification or file.
• No selection made: same as above — slurp exits non-zero if the user escapes.
• wofi dismissed (Escape): no action taken; file and clipboard copy are preserved.
• Delete: immediate, no undo. A confirmation notification fires so the user knows it happened.

Files Changed

• scripts/screenshot.sh — rewrite
• packages.txt — add satty, swappy (already installed manually)

Tools Used

Tool	Purpose
grim	screen capture
slurp	region selection
wl-copy	clipboard
notify-send	notification (mako daemon)
wofi --dmenu	action picker
swappy	annotation (default)
satty	annotation (alternative)
imv	image viewer