07fccef41c
* 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>
4.7 KiB
Navigation
Everything in Omarchy happens via the keyboard — EVERYTHING! When the system first starts, you literally can't do a thing with the mouse alone. But you can hit Super + Space to reveal the Omarchy Menu and from here you to do just about everything.
But the Omarchy menu is not even intended to be the main way to operate the system most of the time. We can get faster than that! All the most important applications are bound directly to individual hotkeys. You start the terminal with Super + Return and a browser with Super + Shift + Return. Try doing one after the other, and you'll see the magic of Hyprland's tiling in action:
You can then hit Super + J to stack them on top of each other instead of side by side:
Hit Super + J again to return them to their side-by-side positions. Then try Super + Shift + Arrow Right while on the browser to swap the windows.
Now try Super + Ctrl + T to start the Activity monitor. That'll appears as a floating window. You can tile it using Super + T (and hit that again to make it floating again). Now press Super + Shift + F to open the files manager. You'll have a neat four-way setup:
You navigate between the window you want to be active with Super + Arrow. This will switch focus and move the cursor to the center of the new application.
If you hit Super + Shift + 2, you'll move the current focused application onto the second workspace. Super + Shift + 1 moves it back. (And Super + Shift + Alt + 2 will move the current focused application onto the second workspace without switching to it).
If you hold down Super and use the mouse to click on a window, you'll be able to rearrange where it sits. If you hold Super and use the right button on the mouse, you can freely resize the window.
You close a window on Super + W or Super + Q (and close all windows on Ctrl + Alt + Delete).
You can also go full screen with Super + F or even just full-width (keeping the top bar) with Super + Alt + F or full-screen within a window with Super + Ctrl + F (good for YouTube!).
Dwindle vs scrolling layout
Omarchy's default layout is called dwindle. It keeps all the windows you open on a single workspace visible at all time, even if it has to shrink them down.
But you can also choose to turn a workspace into the scrolling layout where windows are lined up side-by-side, beyond the visible edge of the display. You turn a single workspace into this layout via Super + L.
The choice is per workspace, and it sticks. So you can keep workspace 1 on dwindle for browsing and workspace 2 on scrolling for code, and they'll come back that way after a restart. (The same toggle is under Trigger > Toggle > Workspace Layout in the Omarchy menu).
If you wish to use the scrolling layout as the default, you can set that in ~/.config/hypr/looknfeel.lua:
hl.config({
general = {
layout = "scrolling",
},
})
Grouping windows
Windows can be grouped using Super + G. Once you're in a group, every window you start while that's active will belong to the group. You can move between these grouped windows using Super + Ctrl + Arrow Left/Right or Super + Alt + 1/2/3/4 to go directly to grouped window in order.
You can move a window out of the grouping with Super + Alt + G or disassemble the entire group by hitting Super + G again. Finally, you can move windows outside the group into it with Super + Alt + Arrows.
Popping windows
You can pop a window out of its workspace allocation with Super + O. That'll pin it as a floating window that follows you on whatever workspace you go to. Great for video players and the like.
Scratchpad workspace
Finally, there's a special scratchpad workspace that drops down over whatever workspace you're currently on, much like a Quake console. Toggle it with Super + Grave or Super + S, and place a window there using Super + Shift + Grave or Super + Alt + S.
It works especially well for a terminal running an agent, or for controls you want to interact with quickly without leaving the current workspace. To move a window off the scratchpad, send it directly to another workspace with something like Super + Shift + 1.
It takes some getting used to!
It takes a little while to get used to navigating your desktop like this, but once you do, it'll be hard to go back to a traditional mouse-driven desktop experience!