Files
omarchycn/manual/07-hotkeys.md
T
07fccef41c Add Super + Q as a second chord for closing a window (#7767)
* Add Super + Q as a second chord for closing a window

Super + W stays the documented default. Super + Q is the chord people
arrive with from macOS, where Command + Q quits the app, and typing it
into Omarchy did nothing at all until now.

🤖 Generated by Opus 5 in Claude Code. Reviewed by Codex XHigh.

* Put an action's alternative chord on one keybindings row

Super + W and Super + Q both read "Close window" in the menu, two rows
apart, with nothing to say they were the same thing -- and the
alternative sorted above the default. The scratchpad and the calculator
had the same trouble, each bound to a chord and to a second key.

Four actions are named as having an alternative, one at a time, and the
second chord joins the first one's row. A rule would be wrong here: Alt +
Tab and Shift + Alt + Tab both say "Reveal active window on top" while
cycling opposite ways, and a media key is nobody's idea of an alternative
to a Super chord. Both halves still have to agree on what they dispatch,
since a label is only what a chord is called, and an unresolved
dispatcher never counts as agreement.

Nothing is allowed past the 35-character column: a pair that would
overrun it stays as two rows rather than pushing its arrow out of line.
The menu elides a row that outgrows its card -- 754px of label, 78
monospace characters at the heading size -- and the longest entry already
sits at 74, so widening the column to fit the widest pair would have cost
two dozen rows the end of their description.

Priority ordering reads the rendered row, so the chord sharing it would
otherwise reclassify the entry: XF86Calculator alone belongs in the tail
kept for media keys, and it took the calculator down there with it.
Ranking now reads the chord that leads the row.

The key left of 1 reads as ~ rather than Hyprland's name for it, whether
a bind names it or reports the keycode for the keymap to resolve. Cached
records predate all of this, so the cache version moves with it.

🤖 Generated by Opus 5 in Claude Code. Reviewed by Codex XHigh.

Co-authored-by: Codex XHigh <noreply@openai.com>

---------

Co-authored-by: Codex XHigh <noreply@openai.com>
2026-08-22 16:55:01 +02:00

374 lines
16 KiB
Markdown

# Hotkeys
You can see all the main keyboard bindings with `Super + K` (Tmux bindings with `Super + Alt + K` and Herdr bindings with `Super + Ctrl + K`).
## Navigating
| Hotkey | Function |
| ----------------------- | --------------------- |
| `Super + Space` | Omarchy menu (apps and everything else) |
| `Super + Alt + Space` | Apps menu |
| `Super + Escape` | System menu (suspend, restart, etc) |
| `Super + Ctrl + L` | Lock computer |
| `Super + W` or `Super + Q` | Close window |
| `Ctrl + Alt + Del` | Close all windows |
| `Super + T` | Toggle window between tiling/floating |
| `Super + J` | Toggle window position (horizontal/vertical) |
| `Super + O` | Toggle popping window into sticky'n'floating |
| `Super + L` | Toggle between dwindle and scrolling layout |
| `Super + P` | Toggle pseudo window style (natural v stretch) |
| `Super + F` | Go full screen |
| `Super + Alt + F` | Go full width |
| `Super + Ctrl + F` | Go full screen inside window |
| `Super + 1/2/3/4` | Jump to specific workspace |
| `Super + Tab` | Jump to next workspace |
| `Super + Shift + Tab` | Jump to previous workspace |
| `Super + Ctrl + Tab` | Jump to former workspace |
| `Super + Shift + 1/2/3/4` | Move window to workspace |
| `Super + Shift + Alt + 1/2/3/4` | Move window to workspace without following |
| `Super + S` / `Super + Grave` | Toggle scratchpad |
| `Super + Alt + S` / `Super + Shift + Grave` | Move window to scratchpad |
| `Super + Shift + Alt + Arrows` | Move workspaces to directional monitor |
| `Super + Arrow` | Move focus to window in direction of arrow |
| `Super + Shift + Arrow` | Swap window with another in direction of arrow |
| `Super + Minus` | Expand window left |
| `Super + Equal` | Shrink window left |
| `Super + Shift + Minus` | Shrink window up |
| `Super + Shift + Equal` | Expand window down |
| `Super + Alt + Minus/Equal` | Same resizing in smaller steps |
| `Super + Ctrl + Minus/Equal` | Same resizing in bigger steps |
| `Super + Alt + Home` | Save window width |
| `Super + Home` | Restore saved window width |
| `Super + Left Mouse` | Drag window around |
| `Super + Right Mouse` | Resize window |
| `Super + Scroll Wheel` | Scroll through workspaces |
| `Super + G` | Toggle window grouping |
| `Super + Alt + G` | Move window out of grouping |
| `Super + Alt + Tab` | Cycle between windows in grouping |
| `Super + Alt + Shift + Tab` | Cycle backward between windows in grouping |
| `Super + Alt + 1/2/3/4/5` | Jump to specific window in grouping |
| `Super + Alt + Arrow` | Move window into grouping in direction of arrow |
| `Super + Ctrl + Left/Right` | Move between windows inside a tiling group |
| `Super + Ctrl + Z` | Zoom in on screen (repeat for more zoom) |
| `Super + Ctrl + Alt + Z` | Zoom fully out from screen |
| `Super + /` | Step forward through monitor scaling options |
| `Super + Alt + /` | Step backward through monitor scaling options |
| `Alt + Tab` | Cycle forward through windows on the active workspace |
| `Alt + Shift + Tab` | Cycle backward through windows on the active workspace |
| `Ctrl + Alt + Tab`| Cycle focus forward through monitors |
| `Ctrl + Alt + Shift + Tab`| Cycle focus backwards through monitors |
## System controls
| Hotkey | Function |
| ----------------------- | --------------------- |
| `Super + Ctrl + A` | Audio panel |
| `Super + Ctrl + B` | Bluetooth panel |
| `Super + Ctrl + W` | Wifi/network panel |
| `Super + Ctrl + D` | Display panel |
| `Super + Ctrl + P` | Power panel |
| `Super + Ctrl + Alt + D` | Calendar panel |
| `Super + Ctrl + 1-9` | Toggle bar panel by position |
| `Super + Ctrl + S` | Share menu (via LocalSend) |
| `Super + Ctrl + T` | Activity (btop) |
| `Super + Ctrl + C` | Capture controls (screenshot/-recording/picker) |
| `Super + Ctrl + O` | Toggle menu |
| `Super + Ctrl + H` | Hardware menu |
| `Super + Ctrl + Q` | Calculator |
| `Super + Ctrl + E` | Emoji picker |
| `Super + Ctrl + .` | Transcode media |
| `Super + Shift + Ctrl + A` | Pick an AI agent |
## Adjustments
| Hotkey | Function |
| ----------------------- | --------------------- |
| `Shift + Brightness Up` | Maximum screen brightness |
| `Shift + Brightness Down` | Minimum screen brightness |
| `Alt + Brightness Up/Down` | Precise 1% brightness changes |
| `Alt + Volume Up/Down` | Precise 1% volume changes |
| `Keyboard Brightness Up/Down` | Keyboard backlight brighter/dimmer |
| `Keyboard Backlight` | Cycle the keyboard backlight levels |
| `Alt + Play` | Next track |
| `Alt + Shift + Play` | Previous track |
## Launching apps
| Hotkey | Function |
| ----------------------- | --------------------- |
| `Super + Return` | Terminal |
| `Super + Alt + Return` | Tmux terminal |
| `Super + Ctrl + Return` | Herdr (agent manager) |
| `Super + Shift + Return` | Browser |
| `Super + Shift + Alt + B` | Browser (private/incognito) |
| `Super + Shift + F` | File manager |
| `Super + Shift + Alt + F` | File manager in cwd of terminal |
| `Super + Shift + M` | Music (Spotify) |
| `Super + Shift + Alt + M` | Music (cliamp) |
| `Super + Shift + /` | Password manager (1password) |
| `Super + Shift + N` | Editor (Neovim) |
| `Super + Shift + C` | Calendar ([HEY](https://hey.com/)) |
| `Super + Shift + E` | Email ([HEY](https://hey.com/)) |
| `Super + Shift + Alt + E` | New email ([HEY](https://hey.com/)) |
| `Super + Shift + A` | AI (ChatGPT) |
| `Super + Shift + Alt + A` | AI (Grok) |
| `Super + Shift + G` | Messenger (Signal) |
| `Super + Shift + P` | Google Photos |
| `Super + Shift + S` | Google Maps |
| `Super + Shift + Alt + G` | Messenger (WhatsApp) |
| `Super + Shift + Ctrl + G` | Messenger (Google) |
| `Super + Shift + D` | Docker (LazyDocker) |
| `Super + Shift + O` | Obsidian |
| `Super + Shift + W` | Writing (Omawrite) |
| `Super + Shift + X` | X |
| `Super + Shift + Alt + X` | X Compose |
| `Super + Shift + Y` | YouTube |
Change/add bindings in `~/.config/hypr/bindings.lua`.
## Universal clipboard
| Hotkey | Function |
| ----------------------- | --------------------- |
| `Super + C` | Copy |
| `Super + X` | Cut (not in terminal) |
| `Super + V` | Paste |
| `Super + Ctrl + V` | Clipboard manager |
Usually on Linux, you need `Ctrl + Shift + C/V` to copy'n'paste in the terminal and `Ctrl + C/V` to do it everywhere else. These Omarchy unified clipboard hotkeys work everywhere.
## Capture
| Hotkey | Function |
| ------------------- | ------------------------------ |
| `Super + Ctrl + C` | Capture menu (for keyboards w/o PrintScr button) |
| `Print Screen` | Screenshot |
| `Alt + Print Screen` | Screenrecord |
| `Super + Print Screen` | Color picker |
| `Super + Ctrl + Print Screen` | Text extraction to clipboard |
| `Super + Alt + [` | Make webcam overlay smaller while recording |
| `Super + Alt + ]` | Make webcam overlay larger while recording |
| `Alt + Shift + L` | Copy current URL from webapp or Chromium |
| `Alt + Shift + D` | Download the video on the current page to `~/Videos` |
| `Super + Ctrl + X` | Start/stop dictation (requires _Install > AI > Dictation_) |
| `F9` | Push-to-talk dictation (requires _Install > AI > Dictation_) |
With screenrecordings, the hotkey first asks which audio you want, then starts recording. Hit it again to stop. See [screenshots and recording](12-screenshots-recording.md) for the details.
All capture options are also accessible under _Trigger > Capture_ in the Omarchy menu (`Super + Space`).
## Notifications
| Hotkey | Function |
| ----------------------- | --------------------- |
| `Super + ,` | Dismiss latest notification |
| `Super + Shift + ,` | Dismiss all notifications |
| `Super + Ctrl + ,` | Toggle silencing notifications |
| `Super + Alt + ,` | Invoke most recent notification |
| `Super + Shift + Alt + ,` | Open notification history |
## Style
| Hotkey | Function |
| ----------------------- | --------------------- |
| `Super + Ctrl + Shift + Space` | Pick a new theme |
| `Super + Ctrl + Space` | Pick theme background |
| `Super + Backspace` | Toggle transparency on a window |
| `Super + Ctrl + Backspace` | Toggle single-window square aspect |
Extra background images live in `~/.config/omarchy/backgrounds/<theme name>`. Also available via _Install > Style > Background_ in the Omarchy menu.
All style options are also accessible under _Style_ in the Omarchy menu (`Super + Space`).
## Toggles
| Hotkey | Function |
| ----------------------- | --------------------- |
| `Super + Ctrl + I` | Toggle locking on idle |
| `Super + Ctrl + N` | Toggle nightlight display temperature |
| `Super + Ctrl + Delete` | Toggle laptop display on/off |
| `Super + Ctrl + Alt + Delete` | Toggle laptop display mirroring |
| `Super + Shift + Space` | Toggle the top bar |
| `Shift + Mute` | Switch to next audio output |
| `Shift + Play` | Switch to next media source |
| `Super + Shift + Backspace` | Toggle window gaps |
## Reminders
| Hotkey | Function |
| ----------------------- | --------------------- |
| `Super + Ctrl + R` | Set a reminder |
| `Super + Ctrl + Alt + R` | See all reminders |
| `Super + Ctrl + Shift + R` | Clear all reminders |
## Notices
| Hotkey | Function |
| ----------------------- | --------------------- |
| `Super + Ctrl + Alt + T` | Show time as notification |
| `Super + Ctrl + Alt + B` | Show battery as notification |
| `Super + Ctrl + Alt + W` | Toggle weather as notification |
## Tmux
The prefix key is `Ctrl + Space` (`Ctrl + B` also works). You can change these bindings in `~/.config/tmux/tmux.conf`.
### Panes
| Hotkey | Function |
| ----------------------- | --------------------- |
| `Prefix + v` | Split pane beside (vertical) |
| `Prefix + h` | Split pane below (horizontal) |
| `Prefix + x` | Kill pane |
| `Prefix + z` | Toggle pane zoom (fullscreen) |
| `Alt + Enter` | Split pane below (no prefix) |
| `Alt + Shift + Enter` | Split pane beside (no prefix) |
| `Alt + Escape` | Kill pane (no prefix) |
| `Ctrl + Alt + Arrows` | Move between panes |
| `Ctrl + Alt + Shift + Arrows` | Resize panes |
### Windows
| Hotkey | Function |
| ----------------------- | --------------------- |
| `Prefix + c` | New window |
| `Prefix + k` | Kill window |
| `Prefix + r` | Rename window |
| `Alt + 1-9` | Go to specific window |
| `Alt + Arrow Left/Right` | Move between windows |
| `Alt + Shift + Arrow Left/Right` | Move window left/right |
### Sessions
| Hotkey | Function |
| ----------------------- | --------------------- |
| `Prefix + C` | New session |
| `Prefix + K` | Kill session |
| `Prefix + R` | Rename session |
| `Prefix + N` | Next session |
| `Prefix + P` | Previous session |
| `Alt + Arrow Up/Down` | Move between sessions |
| `Prefix + s` | List sessions |
| `Prefix + d` | Detach from session |
### Copy mode (vi-style)
| Hotkey | Function |
| ----------------------- | --------------------- |
| `Prefix + [` | Enter copy mode |
| `v` | Begin selection (in copy mode) |
| `y` | Copy selection (in copy mode) |
### General
| Hotkey | Function |
| ----------------------- | --------------------- |
| `Prefix + q` | Reload config |
| `Prefix + ?` | Show Tmux keybindings |
| `Prefix + :` | Command prompt |
### Tmux layout functions
These functions must be run inside a Tmux session.
| Command | Function |
| ------- | -------- |
| `tdl <ai> [<second_ai>]` | Create dev layout with editor, AI, and terminal |
| `tdlm <ai> [<second_ai>]` | Create dev layout per subdirectory |
| `tsl <count> <command>` | Create multi-pane swarm layout |
## Ghostty Terminal
Ghostty terminal is installed using _Install > Terminal_ via the Omarchy menu.
| Hotkey | Function |
| ----------------------- | --------------------- |
| `Ctrl + Shift + E` | New split below |
| `Ctrl + Shift + O` | New split besides |
| `Ctrl + Alt + Arrows` | Move between splits |
| `Super + Ctrl + Shift + Arrows` | Resize split by 10 lines |
| `Super + Ctrl + Shift + Alt + Arrows` | Resize split by 100 lines |
| `Ctrl + Shift + T` | New tab |
| `Ctrl + Shift + Arrows` | Move between tabs |
| `Alt + Numbers` | Go to specific tab |
| `Shift + Pg Up/Down` | Scroll the history |
| `Ctrl + Left mouse` | Open link in browser |
## File Manager
| Hotkey | Function |
| ------------------- | ------------------------------ |
| `Ctrl + L` | Go to path |
| `Space` | Preview file (arrows navigate) |
| `Backspace` | Go back one folder |
## Neovim (w/ lazyvim)
### Navigation
| Hotkey | Function |
| ------------------------ | ------------------------------- |
| `Space` | Show command options |
| `Space Space` | Open file via fuzzy search |
| `Space E` | Toggle sidebar |
| `Space G G` | Show git controls |
| `Space S G` | Search file content |
| `Ctrl + W W` | Jump between sidebar and editor |
| `Ctrl + Left/right arrow` | Change size of sidebar |
| `Shift + H` | Go to left file tab |
| `Shift + L` | Go to right file tab |
| `Space B D` | Close file tab |
### While in sidebar
| Hotkey | Function |
| ------------------------ | ------------------------------- |
| `A` | Add new file in parent dir |
| `Shift + A` | Add new subdir in parent dir |
| `D` | Delete highlighted file/dir |
| `M` | Move highlighted file/dir |
| `R` | Rename highlighted file/dir |
| `?` | Show help for all commands |
[See all the Neovim hotkeys configured by LazyVim](https://www.lazyvim.org/keymaps).
## Quick Emojis
You can use `Super + Ctrl + E` to show a complete emoji picker that'll put the selection on the clipboard or you can use these quick access options.
| Hotkey | EM | Clue |
| ------------ | -- | ---------- |
| `CapsLock M S` | 😄 | smile |
| `CapsLock M C` | 😂 | cry |
| `CapsLock M L` | 😍 | love |
| `CapsLock M V` | ✌️ | victory |
| `CapsLock M H` | ❤️ | heart |
| `CapsLock M Y` | 👍 | yes |
| `CapsLock M N` | 👎 | no |
| `CapsLock M F` | 🖕 | fuck |
| `CapsLock M W` | 🤞 | wish |
| `CapsLock M R` | 🤘 | rock |
| `CapsLock M K` | 😘 | kiss |
| `CapsLock M E` | 🙄 | eyeroll |
| `CapsLock M I` | 😉 | wink |
| `CapsLock M P` | 🙏 | pray |
| `CapsLock M D` | 🤤 | drool |
| `CapsLock M M` | 💰 | money |
| `CapsLock M X` | 🎉 | xellebrate |
| `CapsLock M 1` | 💯 | 100% |
| `CapsLock M T` | 🥂 | toast |
| `CapsLock M O` |👌 | ok |
| `CapsLock M G` |👋 | greeting |
| `CapsLock M A` |💪 | arm |
| `CapsLock M B` |🤯 | blowing |
## Quick Completions
| Hotkey | Completion |
| ------------ | ---------- |
| `CapsLock Space Space` | — (mdash) |
| `CapsLock Space N` | Your name (as entered on setup) |
| `CapsLock Space E` | Your email (as entered on setup) |
You can add more of your own by editing `~/.XCompose`, then running `omarchy-restart-xcompose` in the terminal to get the changes picked up.