103 lines
3.2 KiB
Markdown
103 lines
3.2 KiB
Markdown
# 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`)
|