a59afb9659
The scratchpad spanned the whole screen whatever was on it, which reads as a band rather than a console when it holds the single agent it is usually opened for. It now sizes to a centered panel twice as wide as it is tall, and hands the full width back as soon as a second app is on the scratchpad: two windows splitting a half-width column is worse than the band this replaced. The panel is still drawn with workspace gaps rather than a window rule, because Hyprland resolves a rule's size once as the window maps and the console has to survive a rescale. It is always flush with the top and always centered, so two numbers describe it, and the memo that suppresses no-op rewrites compares those rather than four edges. The window count is read on window.open and window.destroy, the two events that run after the workspace's count has settled; window.close and window.move_to_workspace both still count the window on its way out, so refitting from either reads one too many and strands the console at full width. The count is only chased while the console is on screen, since a hidden one is refitted on its way in by workspace.special_active, and every window opened anywhere on the desktop would otherwise rewrite the rule. Monitor width and height are the panel's own pixels, so an output turned on its side still reports them the way the panel is built rather than the way it hangs. The odd transforms are the quarter turns and those swap the work area: without that a rotated 1920x1080 sized its console from 1920x1080 instead of 1080x1920 and left a 214x1367 sliver. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Co-Authored-By: Codex XHigh <noreply@openai.com>
4.9 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.
While the scratchpad holds a single window, it drops down as a centered panel rather than spanning the screen. Put a second app on it and it goes back to the full width, so the two have room to sit side by side.
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!