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

49 lines
1.9 KiB
Markdown

# 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.