# 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`)