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,120 @@
+# Hyprland Keybindings — Full Cheatsheet
+
+**Layout:** German (de) | **Mod key:** SUPER (Windows key) | **Source:** `hyprctl binds` live
+
+---
+
+## General
+
+| Shortcut | Action | Details |
+|----------|--------|---------|
+| `SUPER+Q` | Open terminal | kitty |
+| `SUPER+C` | Kill active window | killactive |
+| `SUPER+M` | Exit Hyprland | exit |
+| `SUPER+E` | File manager | dolphin |
+| `SUPER+V` | Toggle floating | togglefloating |
+| `SUPER+D` | App launcher | hyprlauncher |
+| `SUPER+P` | Toggle pseudo-split | pseudo |
+| `SUPER+J` | Toggle split direction | layoutmsg togglesplit |
+| `SUPER+F` | Toggle fullscreen | fullscreen 0 |
+| `SUPER+R` | Reload config | hyprctl reload |
+| `SUPER+SPACE` | Toggle float (popup) | togglefloating |
+| `SUPER+TAB` | Cycle next window | cyclenext |
+| `SUPER+SHIFT+TAB` | Cycle previous window | cyclenext prev |
+| `SUPER+` `` ` `` (Grave) | Toggle scratchpad | togglespecialworkspace |
+| `SUPER+SHIFT+` `` ` `` | Send window to scratchpad | movetoworkspace special |
+| `SUPER+CTRL+K` | Keybind cheat menu | *(broken — pipelines to grep+fuzzel)* |
+| `SUPER+CTRL+L` | Lock screen | hyprlock |
+| `SUPER+B` | Web browser | google-chrome-stable |
+
+## Navigation / Focus
+
+| Shortcut | Action |
+|----------|--------|
+| `SUPER+TAB` | Cycle next window |
+| `SUPER+SHIFT+TAB` | Cycle previous window |
+| `SUPER+H` | Move focus left |
+| `SUPER+L` | Move focus right |
+| `SUPER+left arrow` | Move focus left |
+| `SUPER+right arrow` | Move focus right |
+| `SUPER+up arrow` | Move focus up |
+| `SUPER+down arrow` | Move focus down |
+
+## Window Movement
+
+| Shortcut | Action |
+|----------|--------|
+| `SUPER+SHIFT+H` | Move window left |
+| `SUPER+SHIFT+L` | Move window right |
+| `SUPER+SHIFT+K` | Move window up |
+| `SUPER+SHIFT+J` | Move window down |
+| `SUPER+SHIFT+left` | Move window left |
+| `SUPER+SHIFT+right` | Move window right |
+| `SUPER+SHIFT+up` | Move window up |
+| `SUPER+SHIFT+down` | Move window down |
+
+## Window Resize
+
+| Shortcut | Action |
+|----------|--------|
+| `SUPER+ALT+H` | Resize active: width -40 |
+| `SUPER+ALT+L` | Resize active: width +40 |
+| `SUPER+ALT+K` | Resize active: height -40 |
+| `SUPER+ALT+J` | Resize active: height +40 |
+
+## Screenshots
+
+| Shortcut | Action | Tool |
+|----------|--------|------|
+| `Print` | Area select → save + copy | grimblast copysave area |
+| `SUPER+Print` | Active window → save + copy | grimblast copysave active |
+| `SUPER+SHIFT+Print` | Full monitor → save + copy | grimblast copysave output |
+| `SUPER+ALT+Print` | Area select → annotate | grim | slurp | satty |
+
+## Workspaces
+
+| Shortcut | Action |
+|----------|--------|
+| `SUPER+1..9` | Switch to workspace 1-9 |
+| `SUPER+SHIFT+1..9` | Move active window to workspace 1-9 |
+| `SUPER+` `` ` `` | Toggle scratchpad (togglespecialworkspace) |
+| `SUPER+SHIFT+` `` ` `` | Move to scratchpad (movetoworkspace special) |
+
+### Workspace Layout
+
+| Workspace | Monitor | Position |
+|-----------|---------|----------|
+| 1 | DP-1 (TERRA 3280W) | Left, 2560x1440@144 |
+| 2 | DVI-D-1 (BenQ BL2405) | Center, 1920x1080@60 rotated 90deg |
+| 3 | HDMI-A-1 (TERRA 3280W) | Right, 2560x1440@144 |
+
+## Notes
+
+- `SUPER+CTRL+K` (keybind menu) does **not work** — the `sed` pipeline breaks. Needs fix.
+- The `sed` pipeline `sed 's/^bind\s*=\s*\$mainMod/SUPER/;s/\s*#/#/'` fails silently because the unescaped `$` in the `sed` command gets interpreted as a variable.
+
+## Troubleshooting
+
+| Issue | Check |
+|-------|-------|
+| Print key not working | `hyprctl binds | grep Print` |
+| `SUPER+R` not working | `hyprctl binds | grep 'reload'` |
+| Screenshots fail | `which grimblast satty slurp grim` |
+| Clipboard empty | `echo test | wl-copy && wl-paste` |
+
+## 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 | Ctrl+C |
+| Save | Ctrl+S |
+| Quit | Esc or Ctrl+Q |