Files
Panama/config/dot/quickshell/manual/03-windows-and-workspaces.md
T
Gabriel Brown 5490fd285d Fold thirty-one settings pages into fifteen categories with tabs
The sidebar was a flat scan of thirty-one rows; now it reads like a
settings app. Multi-subject categories (Input, Network & Sharing,
Applications, Users & Accounts, Privacy & Security, System) carry an
Appearance-style tab strip above the page, drawn by the shell so the
leaf pages themselves are untouched. The taxonomy lives in one new
file, services/SettingsRoutes.qml; the sidebar, the strip, route
validation, search breadcrumbs, and both generators derive from it.

ShellState.settingsPage still holds leaf ids, so every deep link, IPC
call, and search result keeps working — and now lands on the exact
tab. Dictation moves out of Sound onto its own page under Input, with
a handoff back to Sound for the microphone. The strip scrolls when
System's nine tabs outgrow a tiled window. All 161 contracts pass.

Claude-Session: https://claude.ai/code/session_01Ms2FbjQy31TVf3CEvQhGM8
2026-08-23 20:21:31 -04:00

1.9 KiB

Windows and workspaces

How the split is chosen

A new window splits the space of the window that had focus. Whether it splits beside or below depends on which way that space is longer, which usually matches what you were about to do anyway.

When it does not, Super + Ctrl + G flips the split of the focused window, and Super + Ctrl + Z and Super + Ctrl + V decide the direction the next window will take before you open it.

Resizing

Super + Shift plus Y, O, B, M adjusts width; I, U, N and comma adjust height. These are inverted from what their letters suggest, on purpose, and the reason is written in config/dot/hypr/keybinds.lua next to the binds.

For anything finer, hold Super and drag with the right mouse button.

Fullscreen and floating

Super + U makes the focused window fullscreen. Super + Ctrl + C lifts it out of the layout to float, and Super + Ctrl + Shift + C pins it so it follows you between workspaces. A floating window can be moved by holding Super and dragging with the left button.

Workspaces

Ten of them, on Alt + 1 through Alt + 0. Alt + H and Alt + L step between neighbours, and Alt + Shift plus a number sends the current window somewhere without following it.

On a machine with more than one display, workspaces belong to whichever screen has focus. If you would rather pin workspaces one through ten to your main display and give the second screen its own, that is a switch on the Desktop & Dock settings page.

Projects

A project is the set of windows you open together: which applications, which workspace each was on, and for a terminal, which directory it was in.

Arrange things the way you want them, then run Save Layout as Project from the launcher. Open Project lays it out again on free workspaces, so it never lands on top of what you are already doing. An application that refuses to open twice is moved into place rather than launched again.