Files
Panama/config/dot/quickshell/manual/05-making-it-yours.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

Making it yours

Settings

Super + I. Fifteen categories down the side, covering appearance, displays, sound, input, network, power, accounts and the rest. A category with more than one subject in it opens a row of tabs above the page, which is where the narrower topics live: Printers is a tab of Network & Sharing, Dictation a tab of Input, and About, Software Update, Storage, Snapshots and this manual are tabs of System.

The search box at the top searches the settings themselves rather than page names, and each result says where it will land, so if you know what you want to change you can type it and never touch the sidebar.

Appearance

Panama ships Tokyo Night Moon in a light and a dark variant, with eight accent colours. Changing either repaints the shell, the terminal, GTK applications, the lock screen and the system monitor at once.

The wallpaper is per-monitor if you want it to be.

Applications

panama apps in a terminal offers the optional application categories the installer asked about, so a machine can acquire Slack in March without having wanted Discord in January.

panama app builds the handful of applications no repository carries. It is deliberately not part of installing, because a source build is slow and depends on an upstream that moves.

Autostart and defaults

The Applications settings page controls which application opens which kind of file, and what starts when you log in.

Going further

The compositor is configured in Lua under ~/.config/hypr, and every file there explains what it does and why. overrides.lua is loaded last and is the intended place for per-machine changes, so you can adjust anything without editing a file the repository will update.

The shell is QML under ~/.config/quickshell. Both directories are symlinks into the Panama repository, so an edit is a change to your checkout and panama update will offer to commit it.