Document the Panama Control Center

2026-08-17 13:47:50 -04:00
parent 5f965daa6a
commit f4c3ffed43
2 changed files with 39 additions and 15 deletions
@@ -213,6 +213,38 @@ before a timed event until 5 minutes after it starts. It displays relative time
 (`12m` or `Now`); the event title is available on hover but otherwise stays out
 of the bar. All-day events never trigger the capsule.

+## Control Center
+
+Click the right-side status cluster or press `SUPER + S` for Panama's Control
+Center. It is attached directly beneath the bar and keeps Wi-Fi, Bluetooth,
+Caffeine, Night Light, Focus, audio input/output, user, settings, and power in
+one place. Home and Phone continue the same surface rather than opening extra
+dashboard windows.
+
+Home shows the first four configured Home Assistant favourites as direct
+controls and expands to the complete configured list. Panama reads the current
+GNOME Home Assistant extension configuration and its Secret Service token as a
+compatibility fallback, so the existing setup works without copying a secret.
+The preferred private configuration lives in the gitignored
+`config/bash/env` file:
+
+```sh
+export PANAMA_HOME_ASSISTANT_URL=https://home.example.test
+export PANAMA_HOME_ASSISTANT_TOKEN=replace-with-a-long-lived-token
+export PANAMA_HOME_ASSISTANT_ENTITIES=light.kitchen,light.living_room
+```
+
+The helper reads that file directly. No shell restart is required after editing
+it; close and reopen Control Center to refresh. If Home Assistant is offline,
+the last known values stay visible with a stale-state label and Retry action.
+
+Phone uses KDE Connect for the capabilities the paired iPhone actually
+advertises: Send File, Send Clipboard, and Ring. The device remains visible
+while iOS suspends KDE Connect, but actions stay disabled until it reconnects.
+No battery percentage is invented when iOS reports none, and BlueBubbles
+remains the messaging experience. Active file sends appear in Daybook's
+Ongoing page; successful sends become a quiet recent exchange.
+
 ## Screen Intelligence

 `SUPER + SHIFT + S` opens the capture picker directly in Selection + Read