Files
Panama/config/dot/quickshell/manual/05-making-it-yours.md
T
Gabriel Brown 7578348db1 Merge Home & Phone into a three-tab Home that knows your house
Home is now Overview | My Home | Phone. Overview leads with quick-action
tiles (focus, Do Not Disturb, health, snapshots, storage), keeps the
findings card — updates fold in, the reclaim-space prompt is gone on
purpose — and adds glance cards, the next calendar event, and weather.

My Home groups every light by Home Assistant area: the helper gained an
`areas` command (one REST template render, no websocket), and the rooms
degrade to a flat list on setups without areas. The favorites editor and
connection card moved intact. Phone gains a vitals strip — battery and
cell signal read from KDE Connect's plugin D-Bus objects, where absence
is data, not an error — beside ring, clipboard, send-a-file, and the
BlueBubbles handoff.

The retired home-phone id resolves to my-home forever via a new alias
map in SettingsRoutes (with a hasOwnProperty guard so prototype names
cannot leak into settingsPage). Storage no longer claims 0 B free — the
old page read a field the disks helper never emitted.

Contracts updated alongside; per the new workflow, the full suite runs
once at the end of the redesign (see the test backlog note).

Claude-Session: https://claude.ai/code/session_01Ms2FbjQy31TVf3CEvQhGM8
2026-08-23 22:06:18 -04:00

54 lines
2.2 KiB
Markdown

# Making it yours
## Settings
`Super + I`. Fourteen 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.
Home is the first of them, and the page `Super + I` lands on. Its Overview tab
is the one you already know; My Home lists your Home Assistant lights by room
alongside the accessories Control Center shows, and Phone holds the iPhone
handoffs — battery, ring it, send it the clipboard or a file, and Messages.
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.