From f4c3ffed43109cd30c7fde163dc3fb709c838986 Mon Sep 17 00:00:00 2001 From: Gabriel Brown Date: Mon, 17 Aug 2026 13:47:50 -0400 Subject: [PATCH] Document the Panama Control Center --- config/dot/hypr/DESKTOP-PARITY.md | 22 +++++++-------------- config/dot/hypr/README.md | 32 +++++++++++++++++++++++++++++++ 2 files changed, 39 insertions(+), 15 deletions(-) diff --git a/config/dot/hypr/DESKTOP-PARITY.md b/config/dot/hypr/DESKTOP-PARITY.md index 99417c5..1a3bd56 100644 --- a/config/dot/hypr/DESKTOP-PARITY.md +++ b/config/dot/hypr/DESKTOP-PARITY.md @@ -23,7 +23,7 @@ Last live audit: 2026-08-17, Fedora 44, Hyprland 0.56.2, Quickshell 0.3.0. | Date menu | Two-column Daybook with Agenda, Ongoing activity, Notifications, month calendar, weather, and media | Live | | Ongoing activity | Focus, Caffeine, recording, screen sharing, camera, and microphone state with direct controls | Live | | Calendar agenda | Existing GNOME, Google, iCloud, and Nextcloud sources through Evolution Data Server | Live | -| Quick settings | Wi-Fi, Bluetooth, audio input/output, caffeine, night light, focus | Live | +| Control Center | Wi-Fi, Bluetooth, audio input/output, Caffeine, Night Light, Focus, Home Assistant favourites, and KDE Connect phone continuity | Live | | Focus sessions | Persistent workspace-bound timer, DND/caffeine coordination, Signal Glass controls | Live | | Brightness | Appears only when a backlight device exists | Live, not applicable on this monitor | | AppIndicator / tray | Native StatusNotifierItem host and themed menus | Live | @@ -35,6 +35,7 @@ Last live audit: 2026-08-17, Fedora 44, Hyprland 0.56.2, Quickshell 0.3.0. | Portals and screen sharing | xdg-desktop-portal-hyprland plus GTK portal | Live | | Removable media | udiskie plus udisks notifications | Live | | Autostart apps | Nextcloud, Bitwarden, and RustDesk system service/tray | Live | +| Printer administration | CUPS with the `system-config-printer` graphical interface | Live | | System settings | Panama Settings for display policy, appearance, desktop, sound, focus, shortcuts, and services; labelled GNOME hardware/account handoffs | Live | ## GNOME extension migration @@ -52,8 +53,8 @@ Last live audit: 2026-08-17, Fedora 44, Hyprland 0.56.2, Quickshell 0.3.0. | Blur My Shell / Openbar / User Theme | Replaced by the Prism shell and compositor blur | | Bluetooth Quick Connect | Replaced by the full Bluetooth picker | | Wi-Fi QR | Deliberately omitted; it is not useful enough to justify another credential-reading surface | -| GSConnect | No paired phone profile was present; KDE Connect is installed and awaiting pairing | -| Home Assistant | Useful integration, but needs a purpose-built panel and secure credential migration | +| GSConnect | Replaced by capability-aware KDE Connect phone continuity in Control Center; the paired iPhone exposes file, clipboard, and Ring actions when reachable | +| Home Assistant | Replaced by secure favourites in Control Center; explicit private environment values take precedence over the existing GNOME extension and Secret Service setup | | Custom Hot Corners Extended | No action was configured, so there is no behavior to port | | App Hider | Hidden app list is now applied in Vicinae | | Allow Locked Remote Desktop | Mutter-specific patch; RustDesk is independent, but lock-screen access needs a real remote test | @@ -63,20 +64,11 @@ Last live audit: 2026-08-17, Fedora 44, Hyprland 0.56.2, Quickshell 0.3.0. These are not blockers for normal use, but they are the remaining places where a polished general-purpose desktop can go beyond the current shell. -1. Home Assistant favourites in a dedicated, secure quick panel. The token must - stay in the keyring or a private state file, never in this repository. -2. Phone integration through KDE Connect, including battery/share status in the - tray. The package is installed and ready for a new pairing. -3. A printer administration GUI. CUPS is already active; the - `system-config-printer` package supplies the missing UI. -4. A real external RustDesk test while hyprlock is active. Local process state +1. A real external RustDesk test while hyprlock is active. Local process state cannot prove what a remote client sees or whether input is accepted. -Supporting packages tracked in `setup/packages/hyprland-packages`: - -```sh -sudo dnf install kde-connect system-config-printer tesseract zbar -``` +KDE Connect, the printer UI, Tesseract, and ZBar are installed and remain +tracked in `setup/packages/hyprland-packages`. ## Global menu decision diff --git a/config/dot/hypr/README.md b/config/dot/hypr/README.md index bbe1cd4..34c11a0 100644 --- a/config/dot/hypr/README.md +++ b/config/dot/hypr/README.md @@ -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