feat(docs): add Hyprland keybindings and screenshot cheatsheet

2026-05-21 09:25:30 +02:00
parent 2bf5f5c005
commit f81c789683
2 changed files with 222 additions and 0 deletions
@@ -0,0 +1,102 @@
+# 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:
+
+```bash
+# 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`)