mw-pfeddersheim-workstation/docs/screenshot-cheatsheet.md

Screenshot Cheatsheet — Hyprland + grimblast + satty

Quick Reference (German Keyboard Layout)

Key Combo	Action	Tool	Pipeline
Print	Select area → save to file + clipboard	grimblast	area → copysave
SUPER + Print	Active window → save to file + clipboard	grimblast	active window → copysave
SUPER + SHIFT + Print	Full monitor → save to file + clipboard	grimblast	output → copysave
SUPER + ALT + Print	Select area → open in satty for annotation	grim+satty	area → satty editor

Test Checklist

Run through these to verify everything works:

Test 1: Area Screenshot (Print)

1. Press Print
2. Drag to select a region
3. Expected: Screenshot saved to ~/Pictures/ AND copied to clipboard
4. Verify: Paste clipboard into a test doc

Test 2: Current Window (SUPER+Print)

1. Focus any window
2. Press SUPER+Print
3. Expected: That window captured, saved + copied

Test 3: Full Monitor (SUPER+SHIFT+Print)

1. Press SUPER+SHIFT+Print
2. Expected: Current monitor captured, saved + copied

Test 4: Annotate in Satty (SUPER+ALT+Print)

1. Press SUPER+ALT+Print
2. Drag to select a region
3. Expected: Satty window opens with the screenshot
4. Try these Satty actions:
   • Freehand drawing (left toolbar)
   • Rectangle/Arrow annotations
   • Blur/redact sections
   • Copy annotated result to clipboard
   • Save annotated result to file
5. Exit Satty with Esc or Ctrl+Q

Manual CLI Commands

If keybindings fail, test tools directly:

# Capture area and save to specific file
grim -g "$(slurp)" ~/Pictures/test-area.png

# Capture area and pipe to satty for editing
grim -g "$(slurp)" - | satty -f -

# Capture full screen and pipe to satty
grim - | satty -f -

# Copy area screenshot to clipboard
grim -g "$(slurp)" - | wl-copy

# grimblast manual modes
grimblast copysave area          # area
grimblast copysave active         # current window
grimblast copysave output         # current monitor
grimblast save area ~/Pictures/test-grimblast.png  # save only

Satty Editor Shortcuts

Action	Shortcut
Freehand	F
Rectangle	R
Ellipse	E
Line/Arrow	L
Text	T
Blur	B
Crop	C
Undo	Ctrl+Z
Redo	Ctrl+Shift+Z
Copy to clipboard	Ctrl+C
Save to file	Ctrl+S
Save As	Ctrl+Shift+S
Quit	Esc or Ctrl+Q

Dependencies

Tool	Purpose	Status
grim	Wayland screenshot capture	Installed
slurp	Region/window selection	Installed
wl-clipboard	Clipboard support	Installed
satty	Annotation editor	Installed
grimblast	Hyprland screenshot helper	Installed
hyprshot	Alternative screenshot tool	Installed (not used in keybinds)

Troubleshooting

• Print key not working: Verify binding with hyprctl binds | grep Print
• satty won't open: Check which satty and echo $XDG_SESSION_TYPE (must be wayland)
• slurp selector invisible: Check if grim and slurp are in PATH
• Screenshots not saving: Check ~/Pictures/ directory exists
• Clipboard empty: Verify wl-copy and wl-paste work (echo test | wl-copy && wl-paste)