Document Home accessory customization
This commit is contained in:
+16
-19
@@ -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
|
||||
|
||||
|
||||
Reference in New Issue
Block a user