Document Home accessory customization

This commit is contained in:
Gabriel Brown
2026-08-17 19:18:45 -04:00
parent 3213a0989a
commit b5c9156e64
2 changed files with 60 additions and 63 deletions
+16 -19
View File
@@ -221,29 +221,26 @@ 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:
Home shows the first four selected favourites at rest and every selected light
when expanded. Use **Panama Settings → Home & Phone** to choose favourites,
set Panama-only aliases, and arrange their order. Dragging a brightness control
only previews the value; releasing it sends one brightness request. A normal
power toggle leaves Home Assistant responsible for restoring its previous
level.
```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.
Credentials stay private in the gitignored `config/bash/env` file, with the
existing GNOME extension and Secret Service setup retained as a compatibility
fallback. Favourites, aliases, and order live in Quickshell state. No shell
restart is required after changing credentials; 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.
while iOS suspends KDE Connect, but those actions stay disabled until it
reconnects. Messages opens BlueBubbles independently of KDE Connect. No battery
percentage is invented when iOS reports none. Active file sends appear in
Daybook's Ongoing page; successful sends become a quiet recent exchange.
## Screen Intelligence