| 1 |
# Hyprland Configuration Reference |
| 2 |
|
| 3 |
Quick reference for current Hyprland keybinds, workspaces, and workflows. |
| 4 |
|
| 5 |
## Core Applications & Launchers |
| 6 |
|
| 7 |
| Keybind | Action | |
| 8 |
|---------|--------| |
| 9 |
| `$mainMod + RETURN` | Terminal (standard) | |
| 10 |
| `$mainMod + SHIFT + RETURN` | Terminal with tmux:main session | |
| 11 |
| `$mainMod + SPACE` | App launcher (wofi) | |
| 12 |
| `$mainMod + E` | File manager | |
| 13 |
| `$mainMod + C` | New VSCode window | |
| 14 |
| `$mainMod + J` | JetBrains app picker | |
| 15 |
| `$mainMod + SHIFT + V` | Clipboard manager | |
| 16 |
| `$mainMod + SHIFT + M` | Exit Hyprland | |
| 17 |
|
| 18 |
## Window Management |
| 19 |
|
| 20 |
| Keybind | Action | |
| 21 |
|---------|--------| |
| 22 |
| `$mainMod + Q` | Close window | |
| 23 |
| `$mainMod + Y` | Pin window (all workspaces) | |
| 24 |
| `$mainMod + F` | Toggle fullscreen | |
| 25 |
| `$mainMod + V` | Toggle float/tile | |
| 26 |
| `$mainMod + /` | Toggle split mode | |
| 27 |
| `$mainMod + K` | Toggle group mode | |
| 28 |
| `$mainMod + Tab` | Next window in group | |
| 29 |
| `$mainMod + X` | Toggle flow (disable animations) | |
| 30 |
| `$mainMod + LMB drag` | Move window | |
| 31 |
| `$mainMod + RMB drag` | Resize window | |
| 32 |
|
| 33 |
## Layouts & Gaps |
| 34 |
|
| 35 |
| Keybind | Action | |
| 36 |
|---------|--------| |
| 37 |
| `$mainMod + F10` | Master layout | |
| 38 |
| `$mainMod + F11` | Dwindle layout | |
| 39 |
| `$mainMod + G` | Remove gaps | |
| 40 |
| `$mainMod + SHIFT + G` | Reset gaps (5/3) | |
| 41 |
|
| 42 |
## Focus & Movement |
| 43 |
|
| 44 |
| Keybind | Action | |
| 45 |
|---------|--------| |
| 46 |
| `$mainMod + Arrow Keys` | Move focus | |
| 47 |
| `$mainMod + SHIFT + Arrow Keys` | Move window | |
| 48 |
|
| 49 |
## Resizing (Multi-tier) |
| 50 |
|
| 51 |
**Resize Mode:** |
| 52 |
- `$mainMod + R` → Enter resize mode |
| 53 |
- Arrow keys or `h/j/k/l` to resize |
| 54 |
- `Esc` to exit |
| 55 |
|
| 56 |
**Quick Resize:** |
| 57 |
- `$mainMod + CTRL + Arrows` → Small resize (25px) |
| 58 |
- `$mainMod + CTRL + SHIFT + Arrows` → Medium resize (55px) |
| 59 |
- `$mainMod + ALT + CTRL + Arrows` → Large resize (85px) |
| 60 |
- `$mainMod + ALT + CTRL + SHIFT + Arrows` → XL resize (115px) |
| 61 |
|
| 62 |
## Workspaces (1-10) |
| 63 |
|
| 64 |
**Primary Monitor (DP-1):** Workspaces 1-5 |
| 65 |
**Secondary Monitor (HDMI-A-1):** Workspaces 6-10 |
| 66 |
|
| 67 |
| Keybind | Action | |
| 68 |
|---------|--------| |
| 69 |
| `$mainMod + [1-0]` | Switch workspace | |
| 70 |
| `$mainMod + CTRL + [1-0]` | Move window & switch | |
| 71 |
| `$mainMod + SHIFT + [1-0]` | Move window silently | |
| 72 |
| `$mainMod + ,/.` | Previous/next workspace | |
| 73 |
| `$mainMod + mouse scroll` | Cycle workspaces | |
| 74 |
|
| 75 |
## Special Workspaces (Scratchpads) |
| 76 |
|
| 77 |
| Keybind | App | Auto-launch | |
| 78 |
|---------|-----|--------------| |
| 79 |
| `$mainMod + Z` | Zen Browser | ✓ | |
| 80 |
| `$mainMod + T` | Terminal (Ghostty) | ✓ | |
| 81 |
| `$mainMod + H` | Guides | - | |
| 82 |
| `$mainMod + D` | Discord | ✓ | |
| 83 |
| `$mainMod + A` | Audacity | ✓ | |
| 84 |
| `$mainMod + O` | TickTick | ✓ | |
| 85 |
| `$mainMod + B` | Bitwarden | ✓ | |
| 86 |
| `$mainMod + M` | Spotify | ✓ | |
| 87 |
| `$mainMod + N` | Notes viewer | tmux layout | |
| 88 |
| `$mainMod + -` | Default scratchpad | - | |
| 89 |
| `$mainMod + SHIFT + -` | Send to scratchpad | - | |
| 90 |
|
| 91 |
## Auto-Workspace Rules |
| 92 |
|
| 93 |
- **Workspace 9:** REAPER (auto-launch on create) |
| 94 |
- **Workspace 10:** LibreWolf (auto-launch on create) |
| 95 |
|
| 96 |
## Media & System |
| 97 |
|
| 98 |
| Keybind | Action | |
| 99 |
|---------|--------| |
| 100 |
| `Print` | Screenshot region | |
| 101 |
| `ALT + Print` | Screenshot screen | |
| 102 |
| `CTRL + Print` | Screenshot window | |
| 103 |
| `XF86Audio*` | Media controls (volume, play/pause) | |
| 104 |
| `XF86MonBrightness*` | Brightness ±5% | |
| 105 |
| `$mainMod + L` | Lock screen | |
| 106 |
| `$mainMod + W` | Reload Waybar | |
| 107 |
| `$mainMod + SHIFT + M` | Exit Hyprland | |
| 108 |
|
| 109 |
## Custom Scenes |
| 110 |
|
| 111 |
| Keybind | Action | |
| 112 |
|---------|--------| |
| 113 |
| `$mainMod + ALT + 1/2` | Toggle scene 1/2 | |
| 114 |
|
| 115 |
## Monitor Setup |
| 116 |
|
| 117 |
- **Primary (DP-1):** 3840×2160, workspaces 1-5 |
| 118 |
- **Secondary (HDMI-A-1):** 2560×1440, workspaces 6-10 |
| 119 |
|
| 120 |
## Window Rules Summary |
| 121 |
|
| 122 |
- **Floating:** PiP, dialogs, system tools |
| 123 |
- **Opacity:** File managers (92%), Discord (96%) |
| 124 |
- **Auto-blur disabled:** Firefox |
| 125 |
- **Smart gaps:** Different for tiled vs floating windows |