markdown · 3704 bytes Raw Blame History

Hyprland Configuration Reference

Quick reference for current Hyprland keybinds, workspaces, and workflows.

Core Applications & Launchers

Keybind Action
$mainMod + RETURN Terminal (standard)
$mainMod + SHIFT + RETURN Terminal with tmux:main session
$mainMod + SPACE App launcher (wofi)
$mainMod + E File manager
$mainMod + C New VSCode window
$mainMod + J JetBrains app picker
$mainMod + SHIFT + V Clipboard manager
$mainMod + SHIFT + M Exit Hyprland

Window Management

Keybind Action
$mainMod + Q Close window
$mainMod + Y Pin window (all workspaces)
$mainMod + F Toggle fullscreen
$mainMod + V Toggle float/tile
$mainMod + / Toggle split mode
$mainMod + K Toggle group mode
$mainMod + Tab Next window in group
$mainMod + X Toggle flow (disable animations)
$mainMod + LMB drag Move window
$mainMod + RMB drag Resize window

Layouts & Gaps

Keybind Action
$mainMod + F10 Master layout
$mainMod + F11 Dwindle layout
$mainMod + G Remove gaps
$mainMod + SHIFT + G Reset gaps (5/3)

Focus & Movement

Keybind Action
$mainMod + Arrow Keys Move focus
$mainMod + SHIFT + Arrow Keys Move window

Resizing (Multi-tier)

Resize Mode:

  • $mainMod + R → Enter resize mode
  • Arrow keys or h/j/k/l to resize
  • Esc to exit

Quick Resize:

  • $mainMod + CTRL + Arrows → Small resize (25px)
  • $mainMod + CTRL + SHIFT + Arrows → Medium resize (55px)
  • $mainMod + ALT + CTRL + Arrows → Large resize (85px)
  • $mainMod + ALT + CTRL + SHIFT + Arrows → XL resize (115px)

Workspaces (1-10)

Primary Monitor (DP-1): Workspaces 1-5
Secondary Monitor (HDMI-A-1): Workspaces 6-10

Keybind Action
$mainMod + [1-0] Switch workspace
$mainMod + CTRL + [1-0] Move window & switch
$mainMod + SHIFT + [1-0] Move window silently
$mainMod + ,/. Previous/next workspace
$mainMod + mouse scroll Cycle workspaces

Special Workspaces (Scratchpads)

Keybind App Auto-launch
$mainMod + Z Zen Browser
$mainMod + T Terminal (Ghostty)
$mainMod + H Guides -
$mainMod + D Discord
$mainMod + A Audacity
$mainMod + O TickTick
$mainMod + B Bitwarden
$mainMod + M Spotify
$mainMod + N Notes viewer tmux layout
$mainMod + - Default scratchpad -
$mainMod + SHIFT + - Send to scratchpad -

Auto-Workspace Rules

  • Workspace 9: REAPER (auto-launch on create)
  • Workspace 10: LibreWolf (auto-launch on create)

Media & System

Keybind Action
Print Screenshot region
ALT + Print Screenshot screen
CTRL + Print Screenshot window
XF86Audio* Media controls (volume, play/pause)
XF86MonBrightness* Brightness ±5%
$mainMod + L Lock screen
$mainMod + W Reload Waybar
$mainMod + SHIFT + M Exit Hyprland

Custom Scenes

Keybind Action
$mainMod + ALT + 1/2 Toggle scene 1/2

Monitor Setup

  • Primary (DP-1): 3840×2160, workspaces 1-5
  • Secondary (HDMI-A-1): 2560×1440, workspaces 6-10

Window Rules Summary

  • Floating: PiP, dialogs, system tools
  • Opacity: File managers (92%), Discord (96%)
  • Auto-blur disabled: Firefox
  • Smart gaps: Different for tiled vs floating windows
View source
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