Make display confirmation test deterministic

Super+Tab already cycled windows, but nothing was drawn, so you chose
blind and could only confirm the choice by arriving. A visible switcher
is muscle memory for anyone arriving from macOS or GNOME, and it was the
last item of roadmap phase 03 that did not need coordination.

Ordered most-recently-used, not by creation, because that is what makes
the gesture useful: one Tab returns to the window you just came from.
Hyprland does not report an MRU order, so it is tracked from focus
changes and keyed by address, which is the only property stable for a
window's lifetime.

The gesture needs three binds rather than two. Tab steps the selection,
and the switch is committed on Super RELEASE -- the only way the
compositor can say the gesture is over. That bind is on the bare
modifier, so it fires on every Super release in the session; commit()
returns immediately when nothing is open, which is what makes it
affordable.

A list of names rather than thumbnails: at a glance you are looking for
"the other terminal", and a row of live previews is slower to read and
far more expensive to draw than this gesture deserves.

The interesting part is the bug. The overlay was built, mapped nothing,
and logged absolutely nothing -- because it declared `required property
var screen` while Variants supplies `modelData`. shell.qml has carried a
comment warning about exactly this since the Bar hit it, and I read that
comment earlier in the same session and still walked into it. A comment
that does not stop the person who read it is an argument for a test, so
per-screen-surface-contract now checks every per-screen delegate takes
its screen from modelData. Verified it catches the exact mistake.

Also fixes a regression from 8be3fc2: settings-pages-contract still
required vitalsIntervalMs on Home, where it no longer is. That contract
was pinning the split-across-two-pages arrangement the same commit
fixed, and I pushed without running it.

Claude-Session: https://claude.ai/code/session_01BRvzt4H8XXLPVH5MyYdk9L

.gitignore

@@ -6,3 +6,19 @@
 /config/wg/**
 # Ignore Neovim lazy-lock file
 /config/dot/nvim/lazy-lock.json
+# Local visual-companion sessions and generated design mocks.
+/.superpowers/
+# Local linked worktrees used for reviewed feature development.
+/.worktrees/
+# Python helper bytecode is local runtime state.
+__pycache__/
+*.py[cod]
+
+# Generated from the colour scheme; machine state, not configuration.
+/config/dot/kitty/current-theme.conf
+
+# Generated from the colour scheme; machine state, not configuration.
+/config/dot/gtk-3.0/settings.ini
+/config/dot/gtk-4.0/settings.ini
+/config/dot/tmux/current-theme.conf
+/config/dot/hypr/hyprlock.conf

README.md

@@ -1,2 +1,62 @@
 # Panama
-## Formerly Sunhat, this is a personal config for Fedora, with the intention of helping a user set up their Fedora system with one command.
+
+Formerly Sunhat. A personal config for Fedora, with the intention of helping a
+user set up their Fedora system with one command.
+
+```sh
+git clone https://git.gbrown.org/gib/Panama.git ~/.local/share/Panama
+~/.local/share/Panama/install
+```
+
+`install` runs everything in `setup/scripts/` in order:
+
+| Script | Does |
+|---|---|
+| `install-packages` | Repos (RPM Fusion, Terra, Hyprland COPR), then the four package lists in `setup/packages/` |
+| `link-dotfiles` | Symlinks `config/dot/<name>` → `~/.config/<name>` |
+| `change-settings` | Copies `config/copy/` over `/`, applies gsettings, enables user services |
+
+Existing configs are moved to `config/old/` rather than overwritten.
+
+## Desktops
+
+Panama configures **two** desktops that coexist. Both sessions stay available in
+GDM, so you can switch back and forth while you settle in.
+
+### GNOME
+The original setup: Forge for tiling, Dash-to-Dock, Openbar, Vitals,
+AppIndicator support. Configured through `config/dot/forge/` and gsettings.
+
+### Hyprland
+A from-scratch replacement built to reproduce the GNOME setup closely enough
+that muscle memory transfers — same keybinds, same panel contents, same dock,
+same Tokyo Night Moon palette.
+
+| Piece | What it is |
+|---|---|
+| `config/dot/hypr/` | Compositor config. **Lua, not hyprlang** — see its README |
+| `config/dot/quickshell/` | The shell: bar, dock, Continuum overview, Settings, Screen Intelligence, focus sessions, quick settings, notifications, screenshot UI |
+| `config/dot/vicinae/` | Raycast-style launcher, themed |
+| `config/dot/uwsm/` | Session environment (see the uwsm caveat in the hypr README) |
+| `config/dot/wofi/` | Fallback launcher, in case the shell fails to start |
+| `config/dot/xdg-desktop-portal/` | Portal backend routing |
+
+**Start here: [`config/dot/hypr/README.md`](config/dot/hypr/README.md)** — it
+covers the Lua migration, the uwsm environment gotcha, the HDR decision, the
+full keymap, and troubleshooting.
+
+Log in as **"Hyprland (uwsm-managed)"**, not plain "Hyprland".
+
+## Layout
+
+```
+bin/            Small user-facing commands on PATH
+config/
+  bash/         .bashrc, aliases, env (env is gitignored)
+  copy/         Files copied verbatim over / (needs sudo)
+  dot/          Symlinked into ~/.config
+  old/          Backups of whatever was replaced (gitignored)
+setup/
+  packages/     One package per line
+  scripts/      Run in order by ./install
+```

config/bash/.bashrc

@@ -24,3 +24,8 @@ else
   fi
   export PATH
 fi
+. "$HOME/.cargo/env"
+
+# >>> Codex installer >>>
+export PATH="/home/gib/.local/bin:$PATH"
+# <<< Codex installer <<<

config/copy/etc/udev/rules.d/99-panama-gpu.rules

@@ -0,0 +1,18 @@
+# Stable, colon-free symlinks for the DRM devices.
+#
+# Why this exists: Hyprland's AQ_DRM_DEVICES selects which GPU renders, but
+#   - /dev/dri/cardN numbering is assigned at boot and is not stable, and
+#   - /dev/dri/by-path/ names contain colons, which AQ_DRM_DEVICES itself uses
+#     as its separator, so they cannot be used.
+#
+# These rules are keyed to specific PCI addresses and simply do not match on
+# other machines; hypr/env.lua checks that the symlink exists before setting
+# AQ_DRM_DEVICES, so a non-match is harmless.
+#
+# Apply without rebooting:  sudo udevadm control --reload && sudo udevadm trigger
+
+# desktop-gib: Radeon RX 7800 XT (discrete, drives DP-2)
+KERNEL=="card*", KERNELS=="0000:03:00.0", SUBSYSTEM=="drm", SUBSYSTEMS=="pci", SYMLINK+="dri/amd-dgpu"
+
+# desktop-gib: Granite Ridge integrated graphics
+KERNEL=="card*", KERNELS=="0000:12:00.0", SUBSYSTEM=="drm", SUBSYSTEMS=="pci", SYMLINK+="dri/amd-igpu"

config/dot/btop/themes/tokyonight-day.theme

@@ -0,0 +1,57 @@
+# Tokyo Night Day for btop, the light counterpart to tokyonight-moon.
+#
+# btop ships no Tokyo Night light variant at all, and the nearest stock light
+# theme (flat-remix-light) is a different palette that happens to have a similar
+# background. Same colours as kitty/themes/tokyonight-day.conf so the terminal
+# and what runs inside it cannot disagree.
+#
+# Gradients keep the same low -> middle -> high meaning as the dark theme, using
+# Day's darker, more saturated accents: the light versions of these hues are too
+# faint to read as a filled meter.
+
+theme[main_bg]="#e1e2e7"
+theme[main_fg]="#3760bf"
+theme[title]="#3760bf"
+theme[hi_fg]="#2e7de9"
+theme[selected_bg]="#c4c8da"
+theme[selected_fg]="#2e7de9"
+theme[inactive_fg]="#7079a8"
+theme[proc_misc]="#587539"
+
+theme[cpu_box]="#a8aecb"
+theme[mem_box]="#a8aecb"
+theme[net_box]="#a8aecb"
+theme[proc_box]="#a8aecb"
+theme[div_line]="#c4c8da"
+
+theme[temp_start]="#2e7de9"
+theme[temp_mid]="#8c6c3e"
+theme[temp_end]="#f52a65"
+
+theme[cpu_start]="#2e7de9"
+theme[cpu_mid]="#9854f1"
+theme[cpu_end]="#f52a65"
+
+theme[free_start]="#c4c8da"
+theme[free_mid]="#007197"
+theme[free_end]="#2e7de9"
+
+theme[cached_start]="#007197"
+theme[cached_mid]="#2e7de9"
+theme[cached_end]="#9854f1"
+
+theme[available_start]="#8c6c3e"
+theme[available_mid]="#b15c00"
+theme[available_end]="#f52a65"
+
+theme[used_start]="#587539"
+theme[used_mid]="#8c6c3e"
+theme[used_end]="#f52a65"
+
+theme[download_start]="#c4c8da"
+theme[download_mid]="#2e7de9"
+theme[download_end]="#007197"
+
+theme[upload_start]="#c4c8da"
+theme[upload_mid]="#9854f1"
+theme[upload_end]="#7847bd"

config/dot/btop/themes/tokyonight-moon.theme

@@ -0,0 +1,56 @@
+# Tokyo Night Moon for btop, matched to Panama's palette.
+#
+# btop ships a "tokyo-night" theme, but it is the Night variant (#1a1b26). The
+# rest of this desktop is Moon (#222436), and two Tokyo Nights side by side read
+# as a mistake rather than as a choice.
+#
+# The *_start/_mid/_end triples are gradients btop draws meters with: low,
+# middle, and high. They run blue -> yellow -> red so a saturated resource is
+# obvious at a glance without reading the number.
+
+theme[main_bg]="#222436"
+theme[main_fg]="#c8d3f5"
+theme[title]="#c8d3f5"
+theme[hi_fg]="#82aaff"
+theme[selected_bg]="#3b4261"
+theme[selected_fg]="#82aaff"
+theme[inactive_fg]="#636da6"
+theme[proc_misc]="#a5e8b5"
+
+theme[cpu_box]="#4d5685"
+theme[mem_box]="#4d5685"
+theme[net_box]="#4d5685"
+theme[proc_box]="#4d5685"
+theme[div_line]="#3b4261"
+
+theme[temp_start]="#82aaff"
+theme[temp_mid]="#ffc777"
+theme[temp_end]="#ff757f"
+
+theme[cpu_start]="#82aaff"
+theme[cpu_mid]="#c099ff"
+theme[cpu_end]="#ff757f"
+
+theme[free_start]="#3b4261"
+theme[free_mid]="#589ed7"
+theme[free_end]="#86e1fc"
+
+theme[cached_start]="#86e1fc"
+theme[cached_mid]="#82aaff"
+theme[cached_end]="#c099ff"
+
+theme[available_start]="#ffc777"
+theme[available_mid]="#ff966c"
+theme[available_end]="#ff757f"
+
+theme[used_start]="#a5e8b5"
+theme[used_mid]="#ffc777"
+theme[used_end]="#ff757f"
+
+theme[download_start]="#3b4261"
+theme[download_mid]="#82aaff"
+theme[download_end]="#86e1fc"
+
+theme[upload_start]="#3b4261"
+theme[upload_mid]="#c099ff"
+theme[upload_end]="#fca7ea"

config/dot/forge/config/windows.json

@@ -67,6 +67,10 @@
         {
             "wmClass": "Spotify",
             "mode": "float"
+        },
+        {
+            "wmClass": "bitwarden",
+            "mode": "float"
         }
     ]
 }

config/dot/forge/stylesheet/forge/stylesheet.css

@@ -107,7 +107,7 @@
 }
 
 .window-floated-border {
-  border-width: 1px;
+  border-width: 3px;
   border-color: rgb(98,160,234);
   border-style: solid;
   border-radius: 14px;

config/dot/forge/stylesheet/forge/stylesheet.css.bak

@@ -29,41 +29,47 @@
 }
 
 .window-tiled-border {
-  border-width: 4px;
-  border-color: rgb(130,170,255);
+  border-width: 3px;
+  border-color: rgb(98,160,234);
   border-style: solid;
   border-radius: 14px;
 }
 
 .window-split-border {
-  border-width: 4px;
-  border-color: rgb(130,170,255);
+  border-width: 3px;
+  border-color: rgb(98,160,234);
   border-style: solid;
   border-radius: 14px;
 }
 
+/* forge-36le: St does not paint an asymmetric (single-side) border when a
+ * border-radius is set, so the directional hint never rendered. Drop the radius
+ * on the one-edge variants; St paints a straight single-side border reliably. */
+
 .window-split-horizontal {
   border-left-width: 0;
   border-top-width: 0;
   border-bottom-width: 0;
+  border-radius: 0;
 }
 
 .window-split-vertical {
   border-left-width: 0;
   border-top-width: 0;
   border-right-width: 0;
+  border-radius: 0;
 }
 
 .window-stacked-border {
-  border-width: 4px;
-  border-color: rgb(130,170,255);
+  border-width: 3px;
+  border-color: rgb(98,160,234);
   border-style: solid;
   border-radius: 14px;
 }
 
 .window-tabbed-border {
-  border-width: 4px;
-  border-color: rgb(130,170,255);
+  border-width: 3px;
+  border-color: rgb(98,160,234);
   border-style: solid;
   border-radius: 14px;
 }
@@ -74,7 +80,7 @@
 
 .window-tabbed-tab {
   background-color: rgba(54, 47, 45, 1);
-  border-color: rgba(130,170,255,0.6);
+  border-color: rgba(98,160,234,0.6);
   border-width: 1px;
   border-radius: 8px;
   color: white;
@@ -83,7 +89,7 @@
 }
 
 .window-tabbed-tab-active {
-  background-color: rgb(130,170,255);
+  background-color: rgb(98,160,234);
   color: black;
   box-shadow: 0 0 0 1px rgba(0, 0, 0, 0.2);
 }
@@ -101,32 +107,84 @@
 }
 
 .window-floated-border {
-  border-width: 4px;
-  border-color: rgb(130,170,255);
+  border-width: 1px;
+  border-color: rgb(98,160,234);
   border-style: solid;
   border-radius: 14px;
 }
 
 .window-tilepreview-tiled {
   border-width: 1px;
-  border-color: rgba(130,170,255,0.3);
+  border-color: rgba(98,160,234,0.3);
   border-style: solid;
   border-radius: 14px;
-  background-color: rgba(130,170,255,0.2);
+  background-color: rgba(98,160,234,0.2);
 }
 
 .window-tilepreview-stacked {
   border-width: 1px;
-  border-color: rgba(130,170,255,0.3);
+  border-color: rgba(98,160,234,0.3);
   border-style: solid;
   border-radius: 14px;
-  background-color: rgba(130,170,255,0.2);
+  background-color: rgba(98,160,234,0.2);
+}
+
+.window-tilepreview-swap {
+  border-width: 1px;
+  border-color: rgba(162, 247, 43, 0.4);
+  border-style: solid;
+  border-radius: 14px;
+  background-color: rgba(162, 247, 43, 0.4);
 }
 
 .window-tilepreview-tabbed {
   border-width: 1px;
-  border-color: rgba(130,170,255,0.3);
+  border-color: rgba(98,160,234,0.3);
   border-style: solid;
   border-radius: 14px;
-  background-color: rgba(130,170,255,0.2);
+  background-color: rgba(98,160,234,0.2);
+}
+
+/* Keybindings Cheatsheet Overlay */
+
+.forge-cheatsheet {
+  background-color: #2d2d2d;
+  border-radius: 16px;
+  padding: 24px 32px;
+  border: 1px solid #4d4d4d;
+  box-shadow: 0 4px 16px rgba(0, 0, 0, 0.4);
+}
+
+.forge-cheatsheet-title {
+  font-size: 16px;
+  font-weight: bold;
+  color: #ffffff;
+  margin-bottom: 20px;
+  text-align: center;
+}
+
+.forge-cheatsheet-category {
+  font-size: 13px;
+  font-weight: bold;
+  color: #78aeed;
+  margin-top: 16px;
+  margin-bottom: 8px;
+}
+
+.forge-cheatsheet-row {
+  font-size: 12px;
+  color: #eeeeec;
+  margin: 4px 0;
+  padding: 2px 0;
+}
+
+.forge-cheatsheet-key {
+  font-family: monospace;
+  font-weight: bold;
+  color: #f5c211;
+  min-width: 180px;
+}
+
+.forge-cheatsheet-desc {
+  color: #d0cfcc;
 }

config/dot/gtk-3.0/bookmarks

@@ -1,8 +1,8 @@
-file:///home/gib/Documents
-file:///home/gib/Downloads
-file:///home/gib/Music
-file:///home/gib/Pictures
-file:///home/gib/Videos
-file:///home/gib/Documents/Code
+file:///home/gib/Documents Documents
+file:///home/gib/Documents/Code Code
+file:///home/gib/Downloads Downloads
+file:///home/gib/Music Music
+file:///home/gib/Pictures Pictures
+file:///home/gib/Videos Videos
 file:///home/gib/.local/share/Panama Panama
-smb://server.gib/ Gib's Server
+smb://server-gib.local/homes/ Gib's Server

config/dot/gtk-3.0/settings.ini

@@ -1,17 +0,0 @@
-[Settings]
-gtk-theme-name=Tahoe-Dark
-gtk-icon-theme-name=Adwaita
-gtk-font-name=Cantarell 11
-gtk-cursor-theme-name=WhiteSur-cursors
-gtk-cursor-theme-size=24
-gtk-toolbar-style=GTK_TOOLBAR_ICONS
-gtk-toolbar-icon-size=GTK_ICON_SIZE_LARGE_TOOLBAR
-gtk-button-images=0
-gtk-menu-images=0
-gtk-enable-event-sounds=1
-gtk-enable-input-feedback-sounds=0
-gtk-xft-antialias=1
-gtk-xft-hinting=1
-gtk-xft-hintstyle=hintslight
-gtk-xft-rgba=rgb
-gtk-application-prefer-dark-theme=0

config/dot/gtk-3.0/settings.ini.template

@@ -0,0 +1,34 @@
+# GENERATED FILE -- edit settings.ini.template instead.
+#
+# The theme name and dark preference below follow Panama's colour
+# scheme, so this file is regenerated on every switch and is not
+# committed. Under GNOME, gnome-settings-daemon publishes these over
+# XSETTINGS and this file is ignored; under Hyprland there is no
+# settings daemon, so for GTK3 it is authoritative -- which is why it
+# has to change with the scheme rather than being pinned to dark.
+#
+[Settings]
+# These values must match `gsettings get org.gnome.desktop.interface ...`.
+#
+# Under GNOME, gnome-settings-daemon publishes settings over XSETTINGS and this
+# file is effectively ignored. Under Hyprland there is no settings daemon, so
+# this file becomes authoritative for GTK3 — which is why it previously named
+# themes that aren't installed (Tahoe-Dark, WhiteSur-cursors) without anything
+# appearing broken.
+gtk-theme-name=@GTK_THEME@
+gtk-icon-theme-name=Adwaita
+gtk-font-name=Adwaita Sans 11
+gtk-cursor-theme-name=oreo_blue_cursors
+gtk-cursor-theme-size=24
+gtk-application-prefer-dark-theme=@PREFER_DARK@
+
+gtk-toolbar-style=GTK_TOOLBAR_ICONS
+gtk-toolbar-icon-size=GTK_ICON_SIZE_LARGE_TOOLBAR
+gtk-button-images=0
+gtk-menu-images=0
+gtk-enable-event-sounds=1
+gtk-enable-input-feedback-sounds=0
+gtk-xft-antialias=1
+gtk-xft-hinting=1
+gtk-xft-hintstyle=hintslight
+gtk-xft-rgba=rgb

config/dot/gtk-4.0/settings.ini

@@ -1,2 +0,0 @@
-[Settings]
-gtk-application-prefer-dark-theme=0

config/dot/gtk-4.0/settings.ini.template

@@ -0,0 +1,20 @@
+# GENERATED FILE -- edit settings.ini.template instead.
+#
+# The theme name and dark preference below follow Panama's colour
+# scheme, so this file is regenerated on every switch and is not
+# committed. Under GNOME, gnome-settings-daemon publishes these over
+# XSETTINGS and this file is ignored; under Hyprland there is no
+# settings daemon, so for GTK3 it is authoritative -- which is why it
+# has to change with the scheme rather than being pinned to dark.
+#
+[Settings]
+# libadwaita apps normally take their dark preference from the
+# org.freedesktop.appearance portal (served by xdg-desktop-portal-gtk, which
+# reads gsettings). This file is the fallback for plain GTK4 apps and for the
+# window before the portal answers.
+gtk-application-prefer-dark-theme=@PREFER_DARK@
+gtk-theme-name=@GTK_THEME@
+gtk-icon-theme-name=Adwaita
+gtk-font-name=Adwaita Sans 11
+gtk-cursor-theme-name=oreo_blue_cursors
+gtk-cursor-theme-size=24

config/dot/hypr/DESKTOP-PARITY.md

@@ -0,0 +1,114 @@
+# Panama desktop parity
+
+This is the living inventory for the GNOME-to-Hyprland transition. It records
+real behavior, not a one-for-one count of extensions: an enabled extension with
+no configured action is not treated as missing functionality.
+
+Last live audit: 2026-08-17, Fedora 44, Hyprland 0.56.2, Quickshell 0.3.0.
+
+## Daily desktop surfaces
+
+| Capability | Panama implementation | Status |
+|---|---|---|
+| App launcher and run dialog | Vicinae; Wofi emergency fallback | Live |
+| App grid | Vicinae applications provider | Live |
+| Hidden applications | GNOME App Hider list in Vicinae provider config | Live |
+| Tiling and dynamic workspaces | Hyprland Lua config, Forge keymap preserved | Live |
+| Overview | Continuum filmstrip, large workspace preview, cross-workspace search | Live |
+| Minimise | `SUPER+SHIFT+X` sends to scratchpad; `SUPER+X` restores | Live |
+| Dock | Quickshell dock with GNOME favourites and intellihide | Live |
+| Panel | Workspaces, CPU/RAM/GPU, clock, weather, quiet event capsule, media, clipboard, tray, status | Live |
+| Clipboard history | Vicinae owns capture/storage; Quickshell provides the panel | Live |
+| Notifications | Quickshell server, toasts, grouped history, DND, clear actions | Live |
+| 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 |
+| 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 |
+| Screenshot and recording | Quickshell picker, grim/slurp/satty/wf-recorder | Live |
+| Screen text and code recognition | Local Tesseract/ZBar Read mode, selectable Prism result sheet | Live after package install |
+| Lock, idle, and power | hyprlock, hypridle, login1, Quickshell power menu | Live |
+| Wallpaper | hyprpaper | Live |
+| Keyring and authorization | gnome-keyring and hyprpolkitagent | Live |
+| 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 | The Settings app for display policy, appearance, desktop, sound, focus, shortcuts, and services; labelled GNOME hardware/account handoffs | Live |
+| System health and recovery | Settings → System Health, `Panama: Check System Health` in Vicinae, a degraded-only bar indicator, redacted reports, and bounded Panama-owned repairs | Live |
+
+## System health and recovery
+
+Panama stays silent while the desktop is healthy. A compact bar indicator
+appears only for actionable warnings or errors and opens the same **System
+Health** page available from Settings and the Vicinae command **Panama: Check
+System Health**. The terminal summary is available with:
+
+```bash
+~/.config/quickshell/scripts/panama-doctor --summary
+```
+
+The doctor reports authored, redacted observations about Panama-owned services,
+tools, links, and configured integrations. It does not read secrets, clipboard
+or notification contents, calendar events, SSIDs, or device addresses. Repairs
+are a small allow-list: Panama user services, Panama-owned links and launcher
+commands, duplicate Panama Caffeine inhibitors, and a confirmed shell restart.
+They never install packages, invoke `sudo`, delete user data, or rewrite
+arbitrary configuration.
+
+Generic Fedora configuration remains with the system tools that own it. The
+final System Health card hands network settings, users, sharing, colour
+profiles, and digital wellbeing to their exact GNOME Settings panels rather
+than presenting inert Hyprland controls.
+
+## GNOME extension migration
+
+| GNOME extension | Result |
+|---|---|
+| Forge | Replaced by Hyprland tiling and the original keymap |
+| Dash to Dock | Replaced by the Quickshell dock |
+| AppIndicator | Replaced by the Quickshell system tray |
+| Clipboard Indicator | Replaced by the bar clipboard panel and Vicinae history |
+| Emoji Copy | Replaced by Vicinae emoji search on `SUPER+.` |
+| Vitals | Replaced by the CPU, memory, and GPU bar readouts |
+| Weather O'Clock | Replaced by bar weather and the date-menu weather card |
+| Caffeine | Replaced by a real logind inhibitor in quick settings |
+| 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 | 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 |
+
+## System UI still worth adding
+
+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. A real external RustDesk test while hyprlock is active. Local process state
+   cannot prove what a remote client sees or whether input is accepted.
+
+KDE Connect, the printer UI, Tesseract, and ZBar are installed and remain
+tracked in `setup/packages/hyprland-packages`.
+
+## Global menu decision
+
+A macOS-style global application menu is not being shipped. Quickshell can
+render a `DBusMenu` that an application already exports, but it does not provide
+an application-menu registrar or a reliable focused-window-to-menu association.
+Hyprland has no cross-toolkit global-menu protocol, and the daily applications
+audited here do not consistently export one: GTK 4/Nautilus and Electron apps
+are the important failures.
+
+That would produce a premium-looking empty strip for most windows and a working
+menu for a minority, which is worse than omitting it. Relevant references:
+
+- <https://quickshell.org/docs/v0.3.0/types/Quickshell/DBusMenu/>
+- <https://github.com/hyprwm/Hyprland/discussions/1358>
+
+A future focused-window menu could expose compositor actions such as float,
+move, fullscreen, and close. It should not be labelled as an application menu.

config/dot/hypr/README.md

@@ -0,0 +1,409 @@
+# Panama :: Hyprland
+
+A Hyprland desktop built to reproduce the GNOME + Forge setup it replaces, so
+that muscle memory transfers unchanged.
+
+## The one thing to know first
+
+**Hyprland 0.55 replaced hyprlang with Lua.** `hyprland.conf` still loads on
+0.56 as a legacy fallback and is removed in 0.57. Everything here is Lua.
+
+The authoritative option reference for the installed build is on disk:
+
+| File | What it is |
+|---|---|
+| `/usr/share/hypr/stubs/hl.meta.lua` | Generated type stub — the exact option list for this build |
+| `/usr/share/hypr/hyprland.lua` | Upstream example config |
+
+Wire the stub into your editor with `.luarc.json` in this directory for
+autocomplete.
+
+**The Hypr ecosystem tools did NOT move to Lua.** `hyprlock.conf`,
+`hypridle.conf`, `hyprpaper.conf` and `hyprtoolkit.conf` are still hyprlang.
+Don't "fix" them.
+
+## Layout
+
+| File | Contents |
+|---|---|
+| `hyprland.lua` | Entry point. Each `require()` is its own error scope |
+| `prefs.lua` | Reads the settings file the Settings app writes. See below |
+| `env.lua` | Environment. Note the uwsm caveat below |
+| `monitors.lua` | DP-2 geometry, scaling, and the HDR decision |
+| `looks.lua` | Colours, blur, glow, shadows, animations, VRR, scanout |
+| `input.lua` | Keyboard/mouse. Click-to-focus, like GNOME |
+| `rules.lua` | Window rules, gaming rules, layer rules for the shell |
+| `keybinds.lua` | The full keymap |
+| `autostart.lua` | Session startup |
+| `overrides.lua` | Per-machine escape hatch, loaded last |
+| `hyprlock.conf` / `hypridle.conf` / `hyprpaper.conf` / `hyprtoolkit.conf` | Ecosystem tools (hyprlang) |
+
+Validate any change without leaving your session:
+
+```sh
+Hyprland --verify-config
+```
+
+## Generated configuration
+
+Two ecosystem tools cannot read the shared settings file, and their configs live
+in this directory — which is a symlink into the Panama repository, so writing to
+them at runtime would put machine state into a tracked file. Both are therefore
+generated elsewhere:
+
+| Tool | Generated to | Pointed there by |
+|---|---|---|
+| `hypridle` | `$XDG_STATE_HOME/panama/hypridle.conf` | a systemd user drop-in installed by `panama-idle install` |
+| `hyprpaper` | not generated — the wallpaper is applied over IPC and re-applied at shell start | — |
+
+`quickshell/scripts/panama-idle` regenerates the hypridle config from the
+settings store and restarts the daemon. `hypridle.conf` in this directory
+remains the shipped default and is what runs when the drop-in is not installed;
+The Settings app shows which of the two states you are in rather than presenting
+controls that quietly do nothing.
+
+Remove the drop-in and go back to the shipped config with:
+
+```sh
+~/.config/quickshell/scripts/panama-idle remove
+```
+
+## Settings: one file, both sides
+
+`~/.config/panama/settings.json` is shared with the Quickshell side. The
+relationship is:
+
+- **This config is the default.** Every adjustable value is written
+  `prefs.get("key", <shipped value>)`, so the config still works standalone with
+  no settings file at all.
+- **The JSON is the truth.** Hyprland and Quickshell both read it.
+- **The Settings app is the editor.** It writes the file *and* applies the change
+  live, so nothing needs a reload and the two sides cannot drift apart.
+
+To add an adjustable setting: add an entry to
+`quickshell/config/PreferenceSchema.qml` with a `hypr` block naming the
+`hl.config` path, then read it here with `prefs.get`. Nothing else is needed —
+persistence, validation, reset, and the live write are all derived from that
+entry.
+
+`prefs.lua` never raises. A missing, empty, truncated, malformed, or
+wrong-typed settings file costs you your customisations and nothing else;
+`tests/hypr/prefs-fallback-contract.sh` pins that, including that Hyprland still
+accepts the config in each of those states.
+
+### Adding a keybind: use `bind`, not `hl.bind`
+
+Every bind in `keybinds.lua` goes through a local `bind()` wrapper that
+substitutes the chord from a stored override, so shortcuts can be moved from
+the Settings app without editing this file.
+
+```lua
+bind(mod .. " + Q", hl.dsp.window.close(), { description = "Close window" })
+```
+
+Only the **chord** is ever taken from settings — the action is always the Lua
+value written here. A stored override can therefore move a shortcut but can
+never make one do something else, which is what makes reading overrides from a
+file the user can edit safe.
+
+Overrides are keyed by the **shipped chord**, not the description. Descriptions
+are not unique: "Calculator" is both `SUPER + C` and the `XF86Calculator`
+hardware key, and keying by description moved both onto the same new chord,
+silently costing the hardware key.
+
+An override whose value is not a plausible chord is ignored in favour of the
+shipped one, so a hand-edited `settings.json` cannot cost you a keymap.
+
+### Keybind descriptions are required
+
+Every `hl.bind` must pass a `description`. Hyprland reports Lua-defined binds
+with dispatcher `__lua` and a bytecode offset as the argument, so a bind without
+one has nothing readable beside its chord, and the Settings app drops it from the
+Input & Shortcuts page rather than showing a mystery row.
+`tests/quickshell/keybinds-contract.sh` fails if any bind lacks a description, so
+this cannot regress silently.
+
+```lua
+hl.bind(mod .. " + Q", hl.dsp.window.close(), { description = "Close window" })
+```
+
+The page groups shortcuts by what the description says they do, so a new bind
+lands in the right section with no change to the UI.
+
+### Never use `hyprctl keyword`
+
+On a Lua-configured Hyprland it refuses the write, prints
+`keyword can't work with non-legacy parsers` to **stdout**, and still **exits 0**:
+
+```sh
+$ hyprctl getoption decoration:rounding -j     # → "int": 18
+$ hyprctl keyword decoration:rounding 4        # → the refusal above
+$ echo $?                                      # → 0
+$ hyprctl getoption decoration:rounding -j     # → "int": 18, unchanged
+```
+
+Use `hyprctl eval 'hl.config({ ... })'` instead. Note that `eval` *also* exits 0
+on syntax and runtime errors, reporting them as an `error:` line on stdout — so
+for either command, the only trustworthy signal that a write landed is reading
+the value back with `hyprctl getoption`.
+
+## The look
+
+Tokyo Night Moon, with two accents that come from the tmux theme:
+
+| Token | Value | Role |
+|---|---|---|
+| `accent` | `#82aaff` | Carries every state meaning — focused, active, on |
+| `accentSecondary` | `#b172b0` | Never used alone; only the far end of a gradient |
+
+The signature is **the prism**: the two accents meeting. It appears in exactly
+four places, and nowhere else —
+
+1. A one-pixel hairline along the top edge of every glass surface (the bar,
+   dock, popovers), running blue on the left to orchid on the right and fading
+   out before the corners. See `quickshell/widgets/PrismEdge.qml`.
+2. The focused window's border — `general.col.active_border`, blue→orchid at
+   115°. Unfocused windows get no colour at all, because the gradient only
+   means something if one window on screen is wearing it.
+3. The active workspace pill in the bar.
+4. Slider fills.
+
+The restraint is the point. The pink stops being special the moment it's used
+as a flat fill, so it never is.
+
+### Typography
+
+**Adwaita Sans for everything the user reads as text — no monospace in the UI.**
+A monospaced clock or percentage reads as terminal output pasted into a panel,
+which is the opposite of the intent.
+
+The Nerd Font is still used, but only to draw **icon glyphs** — it is the
+pragmatic alternative to freedesktop symbolic icons, which ship with a
+hardcoded `#2e3436` fill that Qt (unlike GTK) will not recolour. Where a
+themed freedesktop icon is wanted instead, `quickshell/widgets/ThemedIcon.qml`
+paints a palette colour through the icon's alpha.
+
+Anything whose digits change in place — the clock, the vitals percentages, the
+recording timer, the selection readout — sets `font.features:
+Theme.tabularFigures`. Tabular figures share one advance width, so the text
+stops twitching as numbers tick without reaching for a monospaced face.
+
+Window rounding is 18, matching the shell's popover radius, so a window and a
+panel next to each other read as the same family of object.
+
+**On animated gradient borders:** Hyprland can rotate the border gradient
+continuously with `borderangle` + `style = "loop"`. Don't. The wiki is explicit
+that it forces a full-refresh-rate repaint forever, even when no border is
+visible — at 4500×3000 that is pure idle GPU burn. This config uses
+`style = "once"`, so the gradient sweeps into place when a window takes focus
+and then costs nothing.
+
+## Session: use the uwsm one
+
+Log in as **"Hyprland (uwsm-managed)"**, not plain "Hyprland".
+
+`xdg-desktop-portal-hyprland`'s systemd unit requires `graphical-session.target`,
+and Fedora ships no `hyprland-session.target`. Without uwsm that target never
+activates and **screen sharing in OBS, Sunshine and Zoom silently fails.**
+
+### The uwsm environment gotcha
+
+`hl.env()` in `env.lua` exports into the *compositor's* environment, **not** the
+systemd user manager. Anything started as a user unit — `vicinae.service`,
+`hyprpaper.service`, `hyprpolkitagent.service`, `hypridle.service` — and every
+app those launch will not see it.
+
+That is why `~/.config/uwsm/env` and `~/.config/uwsm/env-hyprland` exist and
+duplicate the important variables. Keep them in sync with `env.lua`; `env.lua`
+remains the fallback for the plain session.
+
+## HDR — read this before turning it on
+
+GNOME ran this panel in bt2100/HDR. This config deliberately does not.
+
+On Hyprland 0.56.x, `cm = "hdr"` currently breaks **screencopy**: `grim`
+screenshots come back empty, and OBS/Sunshine capture and hyprlock's blurred
+background go with them. Root cause is still open upstream.
+
+So the desktop runs SDR at 10-bit (`cm = "auto"`) and HDR is handed to
+fullscreen games only, via `render.cm_auto_hdr = 1` in `looks.lua`. Games get
+HDR; screenshots keep working.
+
+To try full-time HDR anyway, `overrides.lua` has the block and the ordered list
+of workarounds to reach for when things break.
+
+## Keymap
+
+The mental model is unchanged from Forge:
+
+- **SUPER** acts on windows
+- **ALT** acts on workspaces
+- **SUPER + CTRL** changes layout structure
+
+### Windows
+| Key | Action |
+|---|---|
+| `SUPER + H/J/K/L` (or arrows) | Focus |
+| `SUPER + SHIFT + H/J/K/L` | Move window |
+| `SUPER + CTRL + H/J/K/L` | Swap window |
+| `SUPER + SHIFT + Y/O` · `B/M` | Wider · narrower |
+| `SUPER + SHIFT + I/U` · `P/N` | Taller · shorter |
+| `SUPER + [` / `]` / `=` | Shrink / expand / reset split |
+| `SUPER + Q` | Close |
+| `SUPER + U` | Fullscreen |
+| `SUPER + CTRL + C` | Toggle float |
+| `SUPER + CTRL + SHIFT + C` | Pin (nearest thing to Forge's "always float") |
+| `SUPER + CTRL + G` / `Z` / `V` | Toggle split / preselect right / preselect down |
+| `SUPER + Tab` / `SHIFT + Tab` | Cycle windows |
+| `SUPER + SHIFT + grave` | Last window |
+| `SUPER + X` / `SUPER + SHIFT + X` | Restore scratchpad / minimise to scratchpad |
+
+### Workspaces (dynamic, like GNOME)
+| Key | Action |
+|---|---|
+| `ALT + H` / `ALT + L` | Previous / next workspace |
+| `ALT + SHIFT + H/L` | Move window to previous / next |
+| `ALT + 1..9`, `ALT + 0` | Jump to workspace |
+| `ALT + SHIFT + 1..9` | Send window to workspace |
+| `SUPER + scroll` | Change workspace |
+
+### Launcher and shell
+| Key | Action |
+|---|---|
+| `SUPER + A` / `R` / `Space` | Launcher (vicinae) — all three, pick your favourite |
+| `SUPER + SHIFT + R` | Fallback launcher (wofi) if the shell is broken |
+| `SUPER + V` | Clipboard history |
+| `SUPER + .` | Emoji picker |
+| `SUPER + S` | Quick settings |
+| `SUPER + I` | Settings |
+| `SUPER + SHIFT + F` | Start or reveal focus session |
+| `SUPER + B` | Notification centre |
+| `SUPER + grave` | Workspace overview |
+| `Print` | Screenshot / record picker |
+| `SHIFT` / `ALT + Print` | Screenshot screen / window immediately |
+| `SUPER + SHIFT + S` | Screen Intelligence — read text and codes from a selection |
+| `SUPER + SHIFT + P` | Colour picker |
+| `CTRL + ALT + L` | Lock (SUPER+L is "focus right") |
+| `CTRL + ALT + Delete` | Power menu |
+
+### Apps
+`SUPER + T` terminal · `N` neovim · `W` browser · `F` files · `C` calculator ·
+`E` mail · `I` Settings · `CTRL + SHIFT + Esc` system monitor. GNOME
+Settings remains searchable in Vicinae for hardware and account panels.
+
+## Calendar and notifications
+
+Click the clock to open the two-column Daybook on **Agenda**. The month grid,
+today's schedule, Up Next, weather, and conditional media controls stay visible
+together. Its right pane has three first-class pages:
+
+- **Agenda** — the selected day's calendar.
+- **Ongoing** — Focus, Caffeine, recording, screen sharing, camera, and
+  microphone activity, visible until each state ends.
+- **Notifications** — grouped history, Do Not Disturb, and clear actions.
+
+`SUPER + B` opens Notifications directly. Switching pages preserves the
+selected date and visible month. Brief completed events such as screenshots and
+device changes remain in Signal Glass instead of accumulating in Ongoing.
+
+Calendar data comes from Evolution Data Server, so the Google, iCloud,
+Nextcloud, and local calendars already configured for GNOME remain the source
+of truth. Panama never stores account credentials. Use GNOME Calendar or Online
+Accounts to add and manage accounts, and click an event in Daybook to hand off
+editing and full detail to GNOME Calendar.
+
+The right side of the bar shows a small calendar capsule only from 15 minutes
+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 selected favourites at rest and every selected light
+when expanded. Use **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.
+
+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 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
+
+`SUPER + SHIFT + S` opens the capture picker directly in Selection + Read
+mode. Read is also available beside Screenshot and Record under `Print`, and
+works on a whole display, a window, or a region. Tesseract recognizes English
+text locally; ZBar recognizes QR codes and barcodes. The result sheet can copy
+text, search it, translate it, or open a detected web address. No pixels leave
+the workstation unless one of those explicit network actions is selected.
+
+## Deliberate deviations from GNOME
+
+These are the places a 1:1 port was impossible, and what was done instead:
+
+- **Per-edge resize.** Forge resized one named edge; Hyprland resizes along an
+  axis and lets the layout pick the edge. The eight Forge keys collapse to four
+  behaviours, keeping the horizontal/vertical and grow/shrink pairing.
+- **Overview on `SUPER + grave`, not a bare SUPER tap.** Tap-detection on a
+  modifier misfires when you're quick with SUPER combos.
+- **Lock on `CTRL + ALT + L`.** `SUPER + L` is "focus right" in this keymap.
+- **`SUPER + grave` was Forge's "cycle windows of same app"**, which Hyprland
+  has no equivalent for. "Last window" moved to `SUPER + SHIFT + grave`.
+- **`gnome-control-center` is launched with `XDG_CURRENT_DESKTOP=GNOME`**,
+  because it hard-refuses to start otherwise. Panels backed by system services
+  work; panels backed by GNOME Shell (Displays, Keyboard Shortcuts,
+  Multitasking, Appearance) are inert — Hyprland owns those now.
+
+## Gaming
+
+`content = "game"` on the window rules in `rules.lua` is the keystone — it is
+what `misc.vrr = 3`, `render.direct_scanout = 2` and `cursor.no_break_fs_vrr = 2`
+key off. Games additionally get blur, animation, shadow and dim disabled, plus
+`immediate` for tearing.
+
+Tearing only takes effect when the game is fullscreen and the only thing on
+screen — no bar, no notifications.
+
+## Do not install a notification daemon
+
+`mako`, `dunst` and `SwayNotificationCenter` all register
+`Name=org.freedesktop.Notifications` for D-Bus activation. Installing any of
+them creates a startup race against Quickshell's notification server, and
+whoever wins keeps the name. If one gets installed as a dependency,
+`systemctl --user mask <name>.service`.
+
+## Troubleshooting
+
+**Nothing autostarts** — check `systemctl --user status hyprland-session.target`
+and `systemctl --user show-environment | grep WAYLAND_DISPLAY`. An empty
+environment means uwsm didn't export it and units with
+`ConditionEnvironment=WAYLAND_DISPLAY` silently skip.
+
+**Screen sharing missing** — `busctl --user list | grep impl.portal` should show
+`xdg-desktop-portal-hyprland`.
+
+**Qt apps look wrong** — `QT_QPA_PLATFORMTHEME` must be `gtk3`. It is a single
+value, not a list: Qt splits on `:` and uses only the first token.
+
+**Wrong GPU / won't start** — `AQ_DRM_DEVICES` points at
+`/dev/dri/amd-dgpu`, created by `config/copy/etc/udev/rules.d/99-panama-gpu.rules`.
+Both `env.lua` and `uwsm/env-hyprland` guard on the symlink existing, so a
+missing rule degrades to "let aquamarine choose" rather than failing to start.

config/dot/hypr/autostart.lua

@@ -0,0 +1,60 @@
+-- ─────────────────────────────────────────────────────────────────────────────
+-- Autostart
+--
+-- `exec-once` no longer exists in 0.56; startup is an event handler.
+--
+-- Session: Fedora installs two sessions, "Hyprland" and "Hyprland
+-- (uwsm-managed)". Panama targets the uwsm one, because
+-- xdg-desktop-portal-hyprland's systemd unit requires graphical-session.target
+-- and Fedora ships no hyprland-session.target -- without uwsm, screen sharing
+-- in OBS/Sunshine/Zoom silently fails. The target is started explicitly below
+-- so the plain session works too.
+--
+-- Anything that ships a systemd user unit is started as a unit rather than as
+-- a compositor child. That is not cosmetic: under uwsm, units get the correct
+-- activation environment (see uwsm/env), they restart on failure, and they
+-- shut down in order. Panama's `change-settings` script enables them once;
+-- the explicit starts here make a fresh clone work before that has run.
+-- ─────────────────────────────────────────────────────────────────────────────
+
+hl.on("hyprland.start", function()
+    -- Publish the session environment to systemd and D-Bus so user units and
+    -- the portals can see WAYLAND_DISPLAY. Cheap, and essential without uwsm.
+    hl.exec_cmd("dbus-update-activation-environment --systemd WAYLAND_DISPLAY XDG_CURRENT_DESKTOP=Hyprland")
+    hl.exec_cmd("systemctl --user start hyprland-session.target")
+
+    -- Units: polkit prompts, wallpaper, launcher daemon, idle/lock.
+    hl.exec_cmd("systemctl --user start hyprpolkitagent.service hyprpaper.service vicinae.service hypridle.service")
+
+    -- The shell: bar, dock, overview, quick settings, notifications, capture.
+    -- No systemd unit ships with quickshell, so it runs as a compositor child.
+    hl.exec_cmd("quickshell --daemonize")
+
+    -- Removable-media automounting. GNOME did this invisibly via gvfs+udisks;
+    -- outside GNOME something has to ask udisks to mount. No tray icon: the
+    -- Quickshell bar already has a tray, and udiskie's own icon would be
+    -- redundant. -f opens Nautilus when you click the mount notification.
+    hl.exec_cmd("udiskie --automount --notify --no-tray --file-manager nautilus")
+
+    -- Keyring unlock, for Nextcloud and Bitwarden credential storage.
+    hl.exec_cmd("/usr/bin/gnome-keyring-daemon --start --components=secrets,ssh,pkcs11")
+
+    -- Tray applications carried over from ~/.config/autostart. These need the
+    -- Quickshell tray (an SNI host) to be up, hence starting after it.
+    --
+    -- Commands are copied verbatim from the GNOME .desktop files rather than
+    -- guessed: Bitwarden is a flatpak with no `bitwarden` binary on PATH, and
+    -- its autostart entry launches a specific script with --autostart.
+    --
+    -- RustDesk is deliberately absent: it ships an enabled *system* service
+    -- (`rustdesk --service`) that spawns --server and --tray for the session on
+    -- its own. Starting it here as well would give you two trays.
+    hl.exec_cmd("nextcloud --background")
+    hl.exec_cmd("flatpak run --command=bitwarden.sh com.bitwarden.desktop --autostart")
+end)
+
+hl.on("hyprland.shutdown", function()
+    hl.exec_cmd("systemctl --user stop hyprland-session.target")
+end)
+
+return true

config/dot/hypr/env.lua

@@ -0,0 +1,86 @@
+-- ─────────────────────────────────────────────────────────────────────────────
+-- Environment
+--
+-- hl.env() sets variables before the display server initialises, which is what
+-- makes it valid for AQ_* and cursor variables.
+--
+-- NOTE for uwsm sessions: if you log in via "Hyprland (uwsm-managed)", uwsm
+-- prefers these live in ~/.config/uwsm/env and ~/.config/uwsm/env-hyprland
+-- instead. They still work here; see the session notes in autostart.lua.
+-- ─────────────────────────────────────────────────────────────────────────────
+
+local prefs = require("prefs")
+
+-- ── GPU selection ───────────────────────────────────────────────────────────
+-- This box has a discrete RX 7800 XT (0000:03:00.0) and a Granite Ridge iGPU
+-- (0000:12:00.0). The monitor hangs off the dGPU, so the dGPU must render.
+--
+-- /dev/dri/cardN numbering is not stable across boots, and the by-path names
+-- contain colons -- which are AQ_DRM_DEVICES' own separator, so they cannot be
+-- used directly. Panama installs a udev rule creating colon-free stable
+-- symlinks (/dev/dri/amd-dgpu, /dev/dri/amd-igpu); see
+-- config/copy/etc/udev/rules.d/99-panama-gpu.rules
+--
+-- First entry is the primary renderer. The iGPU stays in the list so anything
+-- plugged into its outputs still lights up.
+--
+-- Guarded on the symlink actually existing: this config is shared across
+-- machines, and pointing AQ_DRM_DEVICES at a device that isn't there stops
+-- Hyprland from starting at all. If the udev rule hasn't been installed (or
+-- this is a different box), we say nothing and let aquamarine choose.
+local function exists(path)
+    local f = io.open(path, "r")
+    if f then f:close() return true end
+    return false
+end
+
+if exists("/dev/dri/amd-dgpu") then
+    local devices = "/dev/dri/amd-dgpu"
+    if exists("/dev/dri/amd-igpu") then
+        devices = devices .. ":/dev/dri/amd-igpu"
+    end
+    hl.env("AQ_DRM_DEVICES", devices)
+end
+
+-- ── Cursor ──────────────────────────────────────────────────────────────────
+-- Theme carried over from GNOME.
+--
+-- Deliberately no HYPRCURSOR_THEME: oreo_blue_cursors is a plain XCursor theme
+-- (it has cursors/ + index.theme and no hyprcursors/ directory or manifest.hl),
+-- so setting it would point hyprcursor at nothing. Hyprland falls back to the
+-- XCursor path, which is what we want.
+hl.env("XCURSOR_THEME", prefs.get("cursorTheme", "oreo_blue_cursors"))
+hl.env("XCURSOR_SIZE", "24")
+
+-- ── Toolkits ────────────────────────────────────────────────────────────────
+-- Wayland first, X11 only as a fallback for apps that genuinely need it.
+hl.env("QT_QPA_PLATFORM", "wayland;xcb")
+
+-- "gtk3" makes Qt derive its palette from the live GTK3 theme via the qgtk3
+-- platform plugin, so Qt apps match adw-gtk3-dark exactly rather than
+-- approximating it -- and it gives them GTK file/font/colour dialogs. It also
+-- covers Qt5 and Qt6 with one value.
+--
+-- Note this is a single value, NOT a fallback list: Qt splits on ":" and uses
+-- only the first token, so the commonly-copied "qt5ct:qt6ct" silently means
+-- just "qt5ct".
+hl.env("QT_QPA_PLATFORMTHEME", "gtk3")
+hl.env("QT_WAYLAND_DISABLE_WINDOWDECORATION", "1")
+hl.env("QT_AUTO_SCREEN_SCALE_FACTOR", "1")
+hl.env("GDK_BACKEND", "wayland,x11")
+hl.env("SDL_VIDEODRIVER", "wayland")
+hl.env("CLUTTER_BACKEND", "wayland")
+hl.env("MOZ_ENABLE_WAYLAND", "1")
+
+-- Electron apps (Slack, Obsidian, Claude, Codex, BlueBubbles, Podman Desktop)
+-- pick Wayland from this rather than needing per-app flags.
+hl.env("ELECTRON_OZONE_PLATFORM_HINT", "auto")
+
+-- ── Desktop identity ────────────────────────────────────────────────────────
+-- Portals and some GNOME apps key off these. uwsm sets them itself, so these
+-- are only load-bearing for the plain (non-uwsm) session.
+hl.env("XDG_CURRENT_DESKTOP", "Hyprland")
+hl.env("XDG_SESSION_TYPE", "wayland")
+hl.env("XDG_SESSION_DESKTOP", "Hyprland")
+
+return true

config/dot/hypr/hypridle.conf

@@ -0,0 +1,39 @@
+# ─────────────────────────────────────────────────────────────────────────────
+# hypridle — idle behaviour
+#
+# Mirrors the GNOME power profile this replaces, exactly:
+#   org.gnome.desktop.session idle-delay          = 300   (screen off at 5min)
+#   org.gnome.desktop.screensaver lock-delay      = 300   (lock 5min after that)
+#   org.gnome.settings-daemon.plugins.power
+#       sleep-inactive-ac-type                    = nothing  (never auto-suspend)
+#       power-button-action                       = nothing
+#
+# So: screen off at 5 minutes, lock at 10, never suspend. This is a desktop.
+#
+# hyprlang syntax, not Lua — hypridle is a separate project from Hyprland.
+# ─────────────────────────────────────────────────────────────────────────────
+
+general {
+    # `pidof` guard prevents stacking lockers if this fires twice.
+    lock_cmd = pidof hyprlock || ~/.config/quickshell/scripts/panama-lock run
+    before_sleep_cmd = loginctl lock-session
+    after_sleep_cmd = hyprctl dispatch 'hl.dsp.dpms({ action = "on" })'
+
+    # 2 = auto. Holds off sleep until the locker is actually up.
+    inhibit_sleep = 2
+}
+
+# 5 minutes -> screen off.
+listener {
+    timeout = 300
+    on-timeout = hyprctl dispatch 'hl.dsp.dpms({ action = "off" })'
+    on-resume = hyprctl dispatch 'hl.dsp.dpms({ action = "on" })'
+}
+
+# 10 minutes -> lock. Matches GNOME's lock-delay of 300s after blanking.
+listener {
+    timeout = 600
+    on-timeout = loginctl lock-session
+}
+
+# Deliberately no suspend listener: sleep-inactive-ac-type was 'nothing'.

config/dot/hypr/hyprland.lua

@@ -0,0 +1,31 @@
+-- ─────────────────────────────────────────────────────────────────────────────
+-- Panama :: Hyprland
+--
+-- Hyprland 0.55 replaced hyprlang (hyprland.conf) with Lua. The .conf format
+-- still loads as a legacy fallback in 0.56 but is removed in 0.57, so this
+-- config is Lua-native. Reference for every option below:
+--   /usr/share/hypr/stubs/hl.meta.lua   <- authoritative for THIS build
+--   /usr/share/hypr/hyprland.lua        <- upstream example
+--
+-- Entry point only. Each require() is its own error scope, so a mistake in one
+-- module doesn't take the whole config down with it.
+--
+-- Reload:  hyprctl reload
+-- Check:   Hyprland --verify-config
+-- ─────────────────────────────────────────────────────────────────────────────
+
+-- Shared preferences first: looks/input/monitors read their defaults through it.
+-- It never raises, so a missing or malformed settings file costs customisations
+-- and nothing else.
+require("prefs")
+
+require("env")
+require("monitors")
+require("looks")
+require("input")
+require("rules")
+require("keybinds")
+require("autostart")
+
+-- Per-machine overrides, loaded last so it wins. Ships effectively empty.
+require("overrides")

config/dot/hypr/hyprlock.conf.template

@@ -0,0 +1,123 @@
+# ─────────────────────────────────────────────────────────────────────────────
+# hyprlock — lock screen.
+#
+# GENERATED FILE. Edit hyprlock.conf.template and re-run
+# quickshell/scripts/panama-theme-apps; editing this copy is overwritten on the
+# next colour scheme change.
+#
+# The colours here follow the desktop's light/dark setting. They used to be
+# hardcoded Tokyo Night Moon, which meant the one screen you see most often
+# stayed dark when everything else went light.
+#
+# hyprlock takes rgba(r, g, b, a) in DECIMAL rather than hex, which is why the
+# template carries "R, G, B" triples where the rest of Panama uses hex. The two
+# Pango markup values are the exception and want ##rrggbb.
+#
+# hyprlang syntax, not Lua — hyprlock is a separate project from Hyprland.
+# ─────────────────────────────────────────────────────────────────────────────
+
+general {
+    hide_cursor = true
+
+    # 2 = auto. Matters at the 1.5x fractional scale this display runs.
+    fractional_scaling = 2
+
+    # 0 = GPU-accelerated screencopy. 1 is a CPU fallback and is very slow at
+    # 4500x3000.
+    screencopy_mode = 0
+
+    fail_timeout = 2000
+}
+
+auth {
+    pam:enabled = true
+    pam:module = hyprlock
+}
+
+# ── Background ──────────────────────────────────────────────────────────────
+# `path = screenshot` grabs the desktop at lock time and blurs it in place,
+# which is what GNOME does.
+#
+# Caveat: this uses screencopy. If the desktop is ever switched to full-time
+# HDR (see hypr/overrides.lua), this background may come back black — that is
+# the same upstream screencopy bug, not a hyprlock misconfiguration.
+background {
+    monitor =
+    path = screenshot
+
+    blur_passes = 3
+    blur_size = 8
+    noise = 0.0117
+    contrast = 0.9
+    brightness = 0.8
+    vibrancy = 0.17
+    vibrancy_darkness = 0.05
+
+    # Shown if the screenshot is unavailable.
+    color = rgba(@BG@, 1.0)
+
+    zindex = -1
+}
+
+# ── Clock ───────────────────────────────────────────────────────────────────
+label {
+    monitor =
+    text = cmd[update:1000] date +"%-I:%M"
+    color = rgba(@FG@, 1.0)
+    font_size = 120
+    font_family = Adwaita Sans Light
+    position = 0, 260
+    halign = center
+    valign = center
+}
+
+label {
+    monitor =
+    text = cmd[update:60000] date +"%A, %B %-d"
+    color = rgba(@MUTED@, 1.0)
+    font_size = 24
+    font_family = Adwaita Sans
+    position = 0, 160
+    halign = center
+    valign = center
+}
+
+# ── Password field ──────────────────────────────────────────────────────────
+input-field {
+    monitor =
+    size = 340, 52
+    position = 0, -40
+    halign = center
+    valign = center
+
+    outline_thickness = 2
+    rounding = 26
+
+    outer_color = rgba(@ACCENT@, 0.9)
+    inner_color = rgba(@FIELD@, 0.85)
+    font_color = rgba(@FG@, 1.0)
+    check_color = rgba(@ACCENT@, 1.0)
+    fail_color = rgba(@ERROR@, 1.0)
+
+    dots_size = 0.25
+    dots_spacing = 0.3
+    dots_center = true
+
+    placeholder_text = <span foreground="##@MUTED_HEX@"><i>Password</i></span>
+    fail_text = <span foreground="##@ERROR_HEX@"><i>$FAIL ($ATTEMPTS)</i></span>
+
+    fade_on_empty = false
+    hide_input = false
+}
+
+# ── User ────────────────────────────────────────────────────────────────────
+label {
+    monitor =
+    text = $USER
+    color = rgba(@FG@, 0.9)
+    font_size = 16
+    font_family = Adwaita Sans
+    position = 0, -110
+    halign = center
+    valign = center
+}

config/dot/hypr/hyprpaper.conf

@@ -0,0 +1,36 @@
+# ─────────────────────────────────────────────────────────────────────────────
+# hyprpaper — static wallpaper
+#
+# NOTE: hyprpaper, hypridle, hyprlock and hyprtoolkit are separate projects and
+# still use hyprlang. Only Hyprland itself moved to Lua. Don't "fix" these.
+#
+# SYNTAX NOTE: hyprpaper 0.8 was rewritten on hyprtoolkit/hyprwire and replaced
+# the old flat syntax with blocks. The pre-0.8 form
+#
+#     preload   = /path/to.jpg
+#     wallpaper = DP-2,/path/to.jpg
+#
+# is silently ignored — it parses, then logs "Monitor DP-2 has no target: no wp
+# will be created" and shows nothing. Almost every guide online still uses it.
+#
+# Static only, by choice: animated wallpapers repaint continuously and cost
+# frame time for nothing.
+# ─────────────────────────────────────────────────────────────────────────────
+
+wallpaper {
+    monitor = DP-2
+    path = ~/Pictures/Wallpapers/faroe_islands.jpg
+    # cover = fill the output, cropping overflow. Matches the "zoom" picture
+    # option this setup used under GNOME.
+    fit_mode = cover
+}
+
+# Fallback for any output without its own block above.
+wallpaper {
+    monitor =
+    path = ~/Pictures/Wallpapers/faroe_islands.jpg
+    fit_mode = cover
+}
+
+ipc = on
+splash = false

config/dot/hypr/hyprtoolkit.conf

@@ -0,0 +1,34 @@
+# ─────────────────────────────────────────────────────────────────────────────
+# hyprtoolkit — shared theme for the first-party Hypr GUI apps
+#
+# One file themes all of these, which is why they're preferred over the usual
+# grab-bag of GTK/Qt utilities:
+#   hyprshutdown      session exit dialog (bound to the power menu)
+#   hyprpwcenter      PipeWire / audio routing GUI  (replaces a pavucontrol/TUI)
+#   hyprsysteminfo    system info panel
+#   hyprland-guiutils hyprland-dialog / hyprland-run
+#   hyprpolkitagent   authentication prompts (via hyprland-qt-support)
+#
+# Colours are Tokyo Night Moon, matching quickshell/config/Theme.qml and
+# hypr/looks.lua. Format is hyprlang; path is fixed at
+# $XDG_CONFIG_HOME/hypr/hyprtoolkit.conf (confirmed in libhyprtoolkit).
+# ─────────────────────────────────────────────────────────────────────────────
+
+background = 0xFF1E2030        # bg_dark   — window background
+base = 0xFF222436              # bg        — raised surfaces
+alternate_base = 0xFF2F334D    # bg_highlight — rows, hover
+text = 0xFFC8D3F5              # fg
+bright_text = 0xFFFFFFFF
+link_text = 0xFF82AAFF         # blue
+
+accent = 0xFF82AAFF            # blue      — same accent as everything else
+accent_secondary = 0xFFC099FF  # magenta
+
+font_family = Adwaita Sans
+font_family_monospace = VictorMono Nerd Font
+
+icon_theme = Adwaita
+
+# Match the rounding used by the Quickshell popovers and the Hyprland windows.
+rounding_large = 18
+rounding_small = 8

config/dot/hypr/input.lua

@@ -0,0 +1,50 @@
+-- ─────────────────────────────────────────────────────────────────────────────
+-- Input
+--
+-- Deliberately GNOME-like: click-to-focus, no focus-follows-mouse, no mouse
+-- acceleration changes. The goal is that muscle memory transfers untouched.
+-- ─────────────────────────────────────────────────────────────────────────────
+
+local prefs = require("prefs")
+
+hl.config({
+    input = {
+        kb_layout  = prefs.get("keyboardLayout", "us"),
+        kb_variant = prefs.get("keyboardVariant", ""),
+        kb_model   = "",
+        kb_options = prefs.get("keyboardOptions", "caps:escape_shifted_capslock"),
+        kb_rules   = "",
+
+        numlock_by_default = prefs.get("numlockByDefault", true),
+
+        -- GNOME's defaults are 500ms delay / 33Hz repeat.
+        repeat_delay = prefs.get("keyRepeatDelay", 500),
+        repeat_rate  = prefs.get("keyRepeatRate", 33),
+
+        -- 1 = FOLLOW. The window under the pointer takes focus. This comment
+        -- previously claimed 1 was "click to focus, GNOME's behaviour", which
+        -- is the opposite of what Hyprland does -- `hyprctl descriptions` gives
+        -- map: [{"separate":3},{"detached":2},{"follow":1},{"disabled":0}],
+        -- so click-to-focus is 0. Changing the shipped value is a behaviour
+        -- decision rather than a correction, so the value is left alone and
+        -- only the description is fixed; Settings exposes all four.
+        follow_mouse = prefs.getInt("followMouse", 1),
+
+        -- Softens follow_mouse: with this off, focus changes only when the
+        -- pointer crosses a window boundary, not on every movement inside one.
+        -- Still focus-follows-pointer, just less twitchy.
+        mouse_refocus = false,
+
+        -- Flat pointer response, no acceleration. Matters for gaming.
+        sensitivity   = prefs.get("pointerSensitivity", 0),
+        accel_profile = "flat",
+
+        -- Clicking a floating window raises and focuses it.
+        float_switch_override_focus = 2,
+    },
+})
+
+-- Desktop machine: no touchpad, no gestures worth wiring. If a laptop ever
+-- runs this config, add touchpad settings in overrides.lua.
+
+return true

config/dot/hypr/keybinds.lua

@@ -0,0 +1,296 @@
+-- ─────────────────────────────────────────────────────────────────────────────
+-- Keybindings
+--
+-- Ported 1:1 from the GNOME + Forge setup this replaces. Where Hyprland has no
+-- equivalent, the deviation is called out in a comment rather than silently
+-- dropped.
+--
+-- The mental model, unchanged from Forge:
+--   SUPER            -> act on windows (focus / move / swap / resize)
+--   ALT              -> act on workspaces
+--   SUPER + CTRL     -> change layout structure (split, float, swap)
+-- ─────────────────────────────────────────────────────────────────────────────
+
+local prefs = require("prefs")
+
+local mod = "SUPER"
+
+-- Programs, matched to the GNOME custom keybindings and media-key settings.
+local terminal    = "kitty"
+local editor      = "kitty nvim ."
+local browser     = "helium-browser-bin"
+local files       = "nautilus --new-window"
+local calculator  = "gnome-calculator"
+local mail        = "flatpak run org.mozilla.thunderbird_esr"
+-- Panama owns the Hyprland and shell controls. GNOME Settings remains installed
+-- and searchable in Vicinae for its hardware/account panels.
+local settings    = "qs ipc call settings toggle"
+local sysmonitor  = "flatpak run io.missioncenter.MissionCenter"
+
+-- Vicinae is the Raycast-style launcher. `vicinae toggle` shows/hides the
+-- window against the already-running server (started in autostart.lua).
+local launcher    = "vicinae toggle"
+local osd = function(action)
+    return "$HOME/.config/quickshell/scripts/panama-osd " .. action
+end
+
+-- Quickshell IPC targets. See quickshell/shell.qml for the handlers.
+local qs = function(target, fn) return "qs ipc call " .. target .. " " .. fn end
+
+-- ── Applications ────────────────────────────────────────────────────────────
+-- ── User rebinding ──────────────────────────────────────────────────────────
+-- Every bind below goes through `bind` rather than `hl.bind` directly, so a
+-- chord can be replaced from Panama Settings without this file changing.
+--
+-- Overrides are keyed by the bind's SHIPPED chord, and ONLY the chord is taken
+-- from settings -- the action is always the Lua value written here. A stored
+-- override can therefore move a shortcut but can never make one do something
+-- else, which is the property that makes reading them from a JSON file the
+-- user can edit safe.
+--
+-- Keyed by chord rather than by description because chords are unique and
+-- descriptions are not: "Calculator" is both SUPER+C and the XF86Calculator
+-- hardware key, and keying by description moved both of them onto the same new
+-- chord, silently costing the hardware key.
+--
+-- An override whose chord is not a plausible chord is ignored and the shipped
+-- one is used, so a hand-edited settings file cannot cost you a keymap.
+
+local overrides = prefs.get("keybindOverrides", {})
+
+local function valid_chord(chord)
+    if type(chord) ~= "string" or chord == "" or #chord > 64 then
+        return false
+    end
+    -- "SUPER + SHIFT + K", "XF86AudioPlay", "Print", "SUPER + mouse:272"
+    return chord:match("^[%w_+%s:]+$") ~= nil
+end
+
+local function bind(chord, action, opts)
+    local override = overrides[chord]
+    if valid_chord(override) then
+        chord = override
+    end
+    return hl.bind(chord, action, opts)
+end
+
+bind(mod .. " + T", hl.dsp.exec_cmd(terminal), { description = "Terminal" })
+bind(mod .. " + N", hl.dsp.exec_cmd(editor), { description = "Neovim" })
+bind(mod .. " + W", hl.dsp.exec_cmd(browser), { description = "Browser" })
+bind(mod .. " + F", hl.dsp.exec_cmd(files), { description = "Files" })
+bind(mod .. " + C", hl.dsp.exec_cmd(calculator), { description = "Calculator" })
+bind(mod .. " + E", hl.dsp.exec_cmd(mail), { description = "Mail" })
+bind(mod .. " + I", hl.dsp.exec_cmd(settings), { description = "Settings" })
+bind("CTRL + SHIFT + Escape", hl.dsp.exec_cmd(sysmonitor), { description = "System monitor" })
+
+-- ── Launcher ────────────────────────────────────────────────────────────────
+-- All three keys open the same launcher, on purpose: SUPER+A and SUPER+R were
+-- the GNOME app-grid and run-dialog shortcuts, and SUPER+SPACE is here as a
+-- third option to settle on. Vicinae covers apps, calculator, files, clipboard,
+-- emoji and window switching, so a separate run dialog and app grid are gone.
+bind(mod .. " + A", hl.dsp.exec_cmd(launcher), { description = "Launcher" })
+bind(mod .. " + R", hl.dsp.exec_cmd(launcher), { description = "Launcher" })
+bind(mod .. " + Space", hl.dsp.exec_cmd(launcher), { description = "Launcher" })
+
+-- Emergency fallback launcher. Vicinae runs as a systemd user service and the
+-- bar is Quickshell; if either fails to come up, this is how you start an
+-- application without dropping to a TTY. Depends on nothing but wofi itself.
+bind(mod .. " + SHIFT + R", hl.dsp.exec_cmd("wofi"), { description = "Fallback launcher" })
+
+-- Clipboard history and emoji, straight into the relevant launcher view.
+-- Deeplink form is the one from vicinae's own Hyprland quickstart.
+bind(mod .. " + V", hl.dsp.exec_cmd("vicinae vicinae://launch/clipboard/history"),
+    { description = "Clipboard history" })
+bind(mod .. " + Period", hl.dsp.exec_cmd("vicinae vicinae://launch/emoji/search"),
+    { description = "Emoji picker" })
+
+-- ── Shell surfaces (Quickshell) ─────────────────────────────────────────────
+-- SUPER+S was GNOME's quick settings; kept.
+bind(mod .. " + S", hl.dsp.exec_cmd(qs("quicksettings", "toggle")), { description = "Quick settings" })
+
+-- Start a 45-minute focus session on the current workspace, or reveal its
+-- Signal Glass controls if one is already running.
+bind(mod .. " + SHIFT + F", hl.dsp.exec_cmd(qs("focus", "reveal")), { description = "Focus session" })
+
+-- Workspace overview. GNOME put this on a bare SUPER tap; tap-detection on a
+-- modifier misfires when you're fast with SUPER+key combos, so it lives on a
+-- real chord instead. SUPER+grave was Forge's "cycle windows of same app",
+-- which Hyprland has no equivalent for.
+bind(mod .. " + grave", hl.dsp.exec_cmd(qs("overview", "toggle")), { description = "Overview" })
+
+-- Notification centre.
+bind(mod .. " + B", hl.dsp.exec_cmd(qs("notifications", "toggle")), { description = "Notifications" })
+
+-- Screenshot / screen record. One key, then pick screen / window / region and
+-- whether to capture or record -- reproducing GNOME's Print-screen UI.
+bind("Print", hl.dsp.exec_cmd(qs("capture", "open")), { description = "Screenshot / record" })
+-- The GNOME direct-capture variants, kept as shortcuts past the picker.
+bind("SHIFT + Print", hl.dsp.exec_cmd(qs("capture", "screenNow")), { description = "Screenshot: whole screen" })
+bind("ALT + Print", hl.dsp.exec_cmd(qs("capture", "windowNow")), { description = "Screenshot: window" })
+
+-- Local OCR and QR/barcode recognition through the same region picker. This
+-- opens directly in Selection + Read mode; Print still exposes every mode.
+bind(mod .. " + SHIFT + S", hl.dsp.exec_cmd(qs("screen-intelligence", "open")),
+    { description = "Screen Intelligence" })
+
+-- Colour picker: copies the hex under the cursor to the clipboard.
+bind(mod .. " + SHIFT + P", hl.dsp.exec_cmd("hyprpicker -a -f hex"), { description = "Colour picker" })
+
+-- ── Window management ───────────────────────────────────────────────────────
+bind(mod .. " + Q", hl.dsp.window.close(), { description = "Close window" })
+bind(mod .. " + U", hl.dsp.window.fullscreen({ mode = "fullscreen" }), { description = "Fullscreen" })
+
+-- Forge: window-toggle-float / window-toggle-always-float.
+-- "Always float" has no Hyprland equivalent (it wrote a persistent rule); pin
+-- is the nearest useful thing -- the window floats above every workspace.
+bind(mod .. " + CTRL + C", hl.dsp.window.float({ action = "toggle" }), { description = "Toggle float" })
+bind(mod .. " + CTRL + SHIFT + C", hl.dsp.window.pin({ action = "toggle" }), { description = "Pin window" })
+
+-- Forge: con-split-layout-toggle / con-split-horizontal / con-split-vertical.
+bind(mod .. " + CTRL + G", hl.dsp.layout("togglesplit"), { description = "Toggle split direction" })
+bind(mod .. " + CTRL + Z", hl.dsp.layout("preselect r"), { description = "Next window splits right" })
+bind(mod .. " + CTRL + V", hl.dsp.layout("preselect d"), { description = "Next window splits down" })
+
+-- Forge: window-shrink / window-expand / window-reset-sizes.
+bind(mod .. " + bracketleft", hl.dsp.layout("splitratio -0.05"), { repeating = true, description = "Shrink" })
+bind(mod .. " + bracketright", hl.dsp.layout("splitratio +0.05"), { repeating = true, description = "Expand" })
+bind(mod .. " + equal", hl.dsp.layout("splitratio exact 0.5"), { description = "Reset split" })
+
+-- Focus (Forge: window-focus-*). Both vim keys and arrows, as in Forge.
+bind(mod .. " + H", hl.dsp.focus({ direction = "l" }), { description = "Focus left" })
+bind(mod .. " + J", hl.dsp.focus({ direction = "d" }), { description = "Focus down" })
+bind(mod .. " + K", hl.dsp.focus({ direction = "u" }), { description = "Focus up" })
+bind(mod .. " + L", hl.dsp.focus({ direction = "r" }), { description = "Focus right" })
+bind(mod .. " + left", hl.dsp.focus({ direction = "l" }), { description = "Focus left" })
+bind(mod .. " + down", hl.dsp.focus({ direction = "d" }), { description = "Focus down" })
+bind(mod .. " + up", hl.dsp.focus({ direction = "u" }), { description = "Focus up" })
+bind(mod .. " + right", hl.dsp.focus({ direction = "r" }), { description = "Focus right" })
+
+-- Move (Forge: window-move-*).
+bind(mod .. " + SHIFT + H", hl.dsp.window.move({ direction = "l" }), { description = "Move window left" })
+bind(mod .. " + SHIFT + J", hl.dsp.window.move({ direction = "d" }), { description = "Move window down" })
+bind(mod .. " + SHIFT + K", hl.dsp.window.move({ direction = "u" }), { description = "Move window up" })
+bind(mod .. " + SHIFT + L", hl.dsp.window.move({ direction = "r" }), { description = "Move window right" })
+
+-- Swap (Forge: window-swap-*).
+bind(mod .. " + CTRL + H", hl.dsp.window.swap({ direction = "l" }), { description = "Swap left" })
+bind(mod .. " + CTRL + J", hl.dsp.window.swap({ direction = "d" }), { description = "Swap down" })
+bind(mod .. " + CTRL + K", hl.dsp.window.swap({ direction = "u" }), { description = "Swap up" })
+bind(mod .. " + CTRL + L", hl.dsp.window.swap({ direction = "r" }), { description = "Swap right" })
+
+-- Resize (Forge: window-resize-<edge>-<increase|decrease>).
+--
+-- Forge resized one named edge at a time. Hyprland resizes the active window
+-- along an axis and lets the layout decide which edge actually moves, so the
+-- eight Forge keys collapse onto four behaviours. The pairing is kept
+-- consistent with the original: Y/B/O/M are horizontal, I/P/U/N are vertical,
+-- and "increase" always grows while "decrease" always shrinks.
+local step = 60
+bind(mod .. " + SHIFT + Y", hl.dsp.window.resize({ x = step, y = 0, relative = true }), { repeating = true, description = "Wider" })
+bind(mod .. " + SHIFT + O", hl.dsp.window.resize({ x = step, y = 0, relative = true }), { repeating = true, description = "Wider" })
+bind(mod .. " + SHIFT + B", hl.dsp.window.resize({ x = -step, y = 0, relative = true }), { repeating = true, description = "Narrower" })
+bind(mod .. " + SHIFT + M", hl.dsp.window.resize({ x = -step, y = 0, relative = true }), { repeating = true, description = "Narrower" })
+bind(mod .. " + SHIFT + I", hl.dsp.window.resize({ x = 0, y = step, relative = true }), { repeating = true, description = "Taller" })
+bind(mod .. " + SHIFT + U", hl.dsp.window.resize({ x = 0, y = step, relative = true }), { repeating = true, description = "Taller" })
+bind(mod .. " + SHIFT + P", hl.dsp.window.resize({ x = 0, y = -step, relative = true }), { repeating = true, description = "Shorter" })
+bind(mod .. " + SHIFT + N", hl.dsp.window.resize({ x = 0, y = -step, relative = true }), { repeating = true, description = "Shorter" })
+
+-- Window cycling (GNOME: cycle-windows on SUPER+Tab), now with an overlay
+-- showing what you are choosing between.
+--
+-- The gesture needs three binds, not two. Tab steps the selection, and the
+-- switch is only COMMITTED when the modifier is released -- which is the sole
+-- way the compositor can tell the gesture is finished. That release bind is on
+-- the bare modifier, so it fires on EVERY Super release in the session; the
+-- handler returns immediately when no switch is open, which is why this is
+-- affordable.
+--
+-- The release bind carries no description on purpose: it is not a shortcut
+-- anyone would look up or rebind, and the Shortcuts page lists what it finds.
+bind(mod .. " + Tab", hl.dsp.exec_cmd(qs("switcher", "next")), { description = "Next window" })
+bind(mod .. " + SHIFT + Tab", hl.dsp.exec_cmd(qs("switcher", "previous")), { description = "Previous window" })
+bind(mod, hl.dsp.exec_cmd(qs("switcher", "commit")), { release = true, description = "Commit window switch" })
+-- Jump back to the previously focused window.
+bind(mod .. " + SHIFT + grave", hl.dsp.focus({ last = true }), { description = "Last window" })
+
+-- Mouse: drag to move, right-drag to resize.
+bind(mod .. " + mouse:272", hl.dsp.window.drag(), { mouse = true, description = "Move window with pointer" })
+bind(mod .. " + mouse:273", hl.dsp.window.resize(), { mouse = true, description = "Resize window with pointer" })
+
+-- ── Workspaces ──────────────────────────────────────────────────────────────
+-- ALT is the workspace modifier, matching the GNOME setup.
+--
+-- Plain relative selectors ("+1" / "-1") reproduce GNOME's dynamic workspaces:
+-- moving right past the last workspace creates a new one, and moving left from
+-- the first clamps instead of wrapping.
+bind("ALT + H", hl.dsp.focus({ workspace = "-1" }), { description = "Workspace left" })
+bind("ALT + L", hl.dsp.focus({ workspace = "+1" }), { description = "Workspace right" })
+bind("ALT + SHIFT + H", hl.dsp.window.move({ workspace = "-1" }), { description = "Move window to workspace left" })
+bind("ALT + SHIFT + L", hl.dsp.window.move({ workspace = "+1" }), { description = "Move window to workspace right" })
+
+-- GNOME also had these on CTRL+ALT+Up/Down.
+bind("CTRL + ALT + up", hl.dsp.focus({ workspace = "-1" }), { description = "Workspace left" })
+bind("CTRL + ALT + down", hl.dsp.focus({ workspace = "+1" }), { description = "Workspace right" })
+
+-- Direct jump. ALT+0 is workspace 10.
+for i = 1, 10 do
+    local key = i % 10
+    bind("ALT + " .. key, hl.dsp.focus({ workspace = i }), { description = "Workspace " .. i })
+    bind("ALT + SHIFT + " .. key, hl.dsp.window.move({ workspace = i }), { description = "Move window to workspace " .. i })
+end
+
+-- Scroll the mouse wheel over the desktop with SUPER held to change workspace.
+-- (Scrolling the workspace indicator in the bar does the same; that's handled
+-- in quickshell/modules/bar/Workspaces.qml.)
+bind(mod .. " + mouse_down", hl.dsp.focus({ workspace = "+1" }), { description = "Workspace right" })
+bind(mod .. " + mouse_up", hl.dsp.focus({ workspace = "-1" }), { description = "Workspace left" })
+
+-- Minimise, as far as Hyprland has one.
+--
+-- Hyprland has no minimise: it receives the request (the binary has
+-- setSetMinimized handlers for xdg, XWayland and foreign-toplevel) but exposes
+-- no dispatcher, no config option and not even an event to hook, so titlebar
+-- minimise buttons are inert and cannot be made to work. A tiling WM has no
+-- iconified state and no taskbar to restore from.
+--
+-- The scratchpad is the honest equivalent: the window goes away, and the same
+-- key brings it back. Bound to X to match the muscle memory it replaces.
+bind(mod .. " + X", hl.dsp.workspace.toggle_special("scratch"), { description = "Toggle scratchpad (restore minimised)" })
+bind(mod .. " + SHIFT + X", hl.dsp.window.move({ workspace = "special:scratch" }), { description = "Minimise to scratchpad" })
+
+-- ── Session ─────────────────────────────────────────────────────────────────
+-- GNOME's lock was SUPER+L, which is "focus right" here, so lock moves to
+-- CTRL+ALT+L -- the other binding most people already have in muscle memory.
+bind("CTRL + ALT + L", hl.dsp.exec_cmd("loginctl lock-session"), { description = "Lock" })
+bind("CTRL + ALT + Delete", hl.dsp.exec_cmd(qs("powermenu", "toggle")), { description = "Power menu" })
+
+-- ── Media and volume ────────────────────────────────────────────────────────
+-- locked = true keeps these working on the lock screen, as they do in GNOME.
+-- 6% steps match the GNOME volume-step setting.
+bind("XF86AudioRaiseVolume", hl.dsp.exec_cmd(osd("volume up 6")), { locked = true, repeating = true , description = "Volume up" })
+bind("XF86AudioLowerVolume", hl.dsp.exec_cmd(osd("volume down 6")), { locked = true, repeating = true , description = "Volume down" })
+bind("XF86AudioMute", hl.dsp.exec_cmd(osd("volume toggle")), { locked = true , description = "Mute" })
+bind("XF86AudioMicMute", hl.dsp.exec_cmd(osd("microphone toggle")), { locked = true , description = "Mute microphone" })
+
+-- Fine-grained steps, matching GNOME's shift/alt volume modifiers.
+bind("SHIFT + XF86AudioRaiseVolume", hl.dsp.exec_cmd(osd("volume up 1")), { locked = true, repeating = true , description = "Volume up (fine)" })
+bind("SHIFT + XF86AudioLowerVolume", hl.dsp.exec_cmd(osd("volume down 1")), { locked = true, repeating = true , description = "Volume down (fine)" })
+
+bind("XF86AudioPlay", hl.dsp.exec_cmd(osd("media play-pause")), { locked = true , description = "Play or pause" })
+bind("XF86AudioPause", hl.dsp.exec_cmd(osd("media play-pause")), { locked = true , description = "Play or pause" })
+bind("XF86AudioNext", hl.dsp.exec_cmd(osd("media next")), { locked = true , description = "Next track" })
+bind("XF86AudioPrev", hl.dsp.exec_cmd(osd("media previous")), { locked = true , description = "Previous track" })
+bind("XF86AudioStop", hl.dsp.exec_cmd(osd("media stop")), { locked = true , description = "Stop playback" })
+
+bind("XF86MonBrightnessUp", hl.dsp.exec_cmd(osd("brightness up 5")), { locked = true, repeating = true , description = "Brightness up" })
+bind("XF86MonBrightnessDown", hl.dsp.exec_cmd(osd("brightness down 5")), { locked = true, repeating = true , description = "Brightness down" })
+
+-- Hardware keys GNOME mapped that have obvious equivalents.
+bind("XF86Tools", hl.dsp.exec_cmd(settings), { description = "Settings" })
+bind("XF86Calculator", hl.dsp.exec_cmd(calculator), { description = "Calculator" })
+bind("XF86Explorer", hl.dsp.exec_cmd(files), { description = "Files" })
+bind("XF86WWW", hl.dsp.exec_cmd(browser), { description = "Browser" })
+bind("XF86Mail", hl.dsp.exec_cmd(mail), { description = "Mail" })
+bind("XF86Search", hl.dsp.exec_cmd(launcher), { description = "Launcher" })
+
+return true

config/dot/hypr/looks.lua

@@ -0,0 +1,257 @@
+-- ─────────────────────────────────────────────────────────────────────────────
+-- Look and feel -- Tokyo Night Moon
+--
+-- Colours here must stay in sync with quickshell/config/Theme.qml.
+--   accent  #82aaff   borders / focus
+--   bg      #222436   base
+--
+-- Performance note: every animation below is event-driven. Nothing uses the
+-- "loop" style on borderangle/shadowangle/glowangle -- that style forces
+-- Hyprland to render at full refresh rate forever, even when nothing is
+-- visible, which is exactly the kind of idle GPU burn to avoid on a 4500x3000
+-- display.
+-- ─────────────────────────────────────────────────────────────────────────────
+
+local prefs = require("prefs")
+
+hl.config({
+    general = {
+        gaps_in  = prefs.get("gapsIn", 5),
+        gaps_out = prefs.get("gapsOut", 10),
+
+        border_size = prefs.get("borderSize", 2),
+
+        col = {
+            -- The focused accent role: blue leads, orchid follows, on a
+            -- diagonal so the pair is visible on both a tall and a wide
+            -- window. ColorScheme never writes this role; a future accent
+            -- picker can own it without fighting light/dark mode.
+            active_border   = { colors = { "rgba(82aaffee)", "rgba(b172b0ee)" }, angle = 115 },
+            -- The neutral inactive role follows the colour scheme because a
+            -- dark neutral disappears against a light desktop.
+            -- services/ColorScheme.qml applies the same values live; this is
+            -- the value a fresh session starts from.
+            inactive_border = prefs.get("colorScheme", "dark") == "light"
+                and "rgba(a8aecb99)" or "rgba(3b426199)",
+        },
+
+        resize_on_border         = prefs.get("resizeOnBorder", true),
+        extend_border_grab_area  = prefs.getInt("borderGrabArea", 15),
+        hover_icon_on_border     = prefs.get("hoverIconOnBorder", true),
+
+        -- Enables the per-window "immediate" rule used for games in rules.lua.
+        -- Harmless on its own; tearing only happens where a rule opts in.
+        allow_tearing = true,
+
+        layout = "dwindle",
+
+        snap = {
+            enabled      = true,
+            window_gap   = prefs.getInt("snapWindowGap", 10),
+            monitor_gap  = prefs.getInt("snapMonitorGap", 10),
+            respect_gaps = prefs.get("snapRespectGaps", false),
+        },
+    },
+
+    decoration = {
+        -- 18 to match the shell's popover radius, so a window and a panel sitting
+        -- next to each other read as the same object family.
+        rounding       = prefs.get("windowRounding", 18),
+        rounding_power = prefs.get("roundingPower", 2),
+
+        active_opacity     = prefs.get("activeOpacity", 1.0),
+        fullscreen_opacity = prefs.get("fullscreenOpacity", 1.0),
+        inactive_opacity = prefs.get("inactiveOpacity", 1.0),
+
+        blur = {
+            enabled = prefs.get("blurEnabled", true),
+            size    = prefs.get("blurSize", 8),
+            passes  = prefs.get("blurPasses", 3),
+
+            -- Required for blur to be affordable. Never turn this off.
+            new_optimizations = true,
+            -- Floating windows skip blurring what's behind tiled ones. Big win.
+            xray              = true,
+
+            ignore_opacity    = true,
+            noise             = 0.0117,
+            contrast          = 0.9,
+            brightness        = 0.85,
+            vibrancy          = 0.17,
+            vibrancy_darkness = 0.05,
+
+            popups             = true,
+            popups_ignorealpha = 0.2,
+
+            -- Blurring the special workspace is expensive and rarely seen.
+            special = false,
+        },
+
+        shadow = {
+            enabled      = prefs.get("shadowEnabled", true),
+            range        = prefs.get("shadowRange", 20),
+            render_power = prefs.getInt("shadowRenderPower", 3),
+            sharp        = prefs.get("shadowSharp", false),
+            color        = "rgba(15161eee)",
+            -- Deliberately not a setting: a two-axis offset needs a control we
+            -- do not have, and a slider bound to half a value is worse than
+            -- leaving it alone. SystemSettings understands the vec2 shape
+            -- already, so adding it later is only a matter of the widget.
+            offset       = { 0, 4 },
+            scale        = 1.0,
+        },
+
+        -- New in 0.56. Kept deliberately faint: in this direction the gradient
+        -- border is the signature, and a strong halo would compete with it.
+        -- This is just enough to lift the focused window off the wallpaper.
+        glow = {
+            enabled        = prefs.get("glowEnabled", true),
+            range          = prefs.get("glowRange", 8),
+            render_power   = 2,
+            color          = "rgba(82aaff33)",
+            color_inactive = "rgba(00000000)",
+        },
+
+        -- Off: costs real frame time and reads as smeary on a 60Hz panel.
+        motion_blur = { enabled = false },
+    },
+
+    animations = { enabled = prefs.get("animationsEnabled", true) },
+
+    dwindle = {
+        -- Keep the split orientation a window was created with. Closest match
+        -- to how the Forge extension behaved on GNOME.
+        preserve_split = prefs.get("preserveSplit", true),
+        smart_resizing = true,
+    },
+
+    -- Only in effect when the tiling layout is "master". Panama ships dwindle,
+    -- but Settings offers master as a choice, and a layout you can select and
+    -- cannot configure is barely a choice at all.
+    master = {
+        mfact       = prefs.get("masterFactor", 0.55),
+        orientation = prefs.get("masterOrientation", "left"),
+        new_status  = prefs.get("masterNewStatus", "slave"),
+        new_on_top  = prefs.get("masterNewOnTop", false),
+    },
+
+    misc = {
+        force_default_wallpaper  = 0,
+        -- Stored as "show the logo / show the splash" and written as Hyprland's
+        -- `disable_*`, matching the `invert` flag on these entries in
+        -- PreferenceSchema so both sides agree about which way round they are.
+        disable_hyprland_logo    = not prefs.get("hyprlandLogo", false),
+        disable_splash_rendering = not prefs.get("hyprlandSplash", false),
+
+        -- Keep native Wayland selection paste and GTK's matching preference
+        -- in lockstep. DesktopStyle applies the GTK half only after this value
+        -- has been read back and stored by SystemSettings.
+        middle_click_paste = prefs.get("middleClickPaste", true),
+
+        -- Same setting as Theme.fontFamily in the shell. If only the QML side
+        -- followed the preference, the compositor and the shell would disagree
+        -- about the interface font and nobody would notice until a tooltip
+        -- rendered in a different typeface.
+        font_family = prefs.get("interfaceFont", "Adwaita Sans"),
+
+        -- Variable refresh rate. 3 = enable only for fullscreen windows whose
+        -- content type is "video" or "game" -- the tag rules.lua applies to
+        -- games. Keeps VRR off the desktop, where it causes visible flicker.
+        vrr = prefs.getInt("vrrPolicy", 3),
+
+        -- Blur behind the lock screen.
+        session_lock_blur = true,
+
+        -- Let a crashed lock screen be recovered rather than stranding you.
+        allow_session_lock_restore = true,
+
+        -- Don't let apps steal focus by shouting; matches GNOME's behaviour.
+        focus_on_activate = false,
+    },
+
+    render = {
+        -- Colour management is stable and on by default in 0.56.
+        cm_enabled = true,
+
+        -- 1 = automatically flip the monitor into HDR for fullscreen content
+        -- that asks for it, and back out afterwards. This is how games get HDR
+        -- without the desktop paying the screencopy cost. See monitors.lua.
+        cm_auto_hdr = prefs.getInt("autoHdr", 1),
+
+        -- 2 = direct scanout only for windows tagged content = "game"
+        -- (set by the rules in rules.lua). Bypasses compositing for real
+        -- fullscreen games.
+        direct_scanout = prefs.getInt("directScanoutPolicy", 2),
+    },
+
+    cursor = {
+        -- 2 = auto. Disables the hardware cursor when tearing, which is what
+        -- keeps the cursor from ghosting in games.
+        no_hardware_cursors = 2,
+
+        -- Don't let the cursor break VRR on content tagged as a game.
+        no_break_fs_vrr = 2,
+        min_refresh_rate = 48,
+
+        -- Pull the cursor theme from gsettings so GTK apps and Hyprland agree.
+        sync_gsettings_theme = true,
+
+        -- Fade the cursor out after 4s of no movement, like GNOME does.
+        inactive_timeout = prefs.get("cursorInactiveTimeout", 4),
+    },
+
+    ecosystem = {
+        no_update_news   = not prefs.get("hyprlandUpdateNews", false),
+        no_donation_nag  = not prefs.get("hyprlandDonationNag", false),
+    },
+
+    xwayland = {
+        -- Render X11 apps at 1:1 device pixels so they're sharp rather than
+        -- bilinearly upscaled. See the note in README.md about the unavoidable
+        -- sizing tradeoff at 1.5x.
+        force_zero_scaling = true,
+    },
+
+    quirks = {
+        -- 2 = report HDR as preferred to gamescope only. Stops gamescope from
+        -- white-screening when it expects HDR to already be live.
+        prefer_hdr = 2,
+    },
+})
+
+-- ── Motion ──────────────────────────────────────────────────────────────────
+-- speed is in deciseconds: speed = 4 means 400ms. Higher = slower.
+
+hl.curve("easeOutQuint", { type = "bezier", points = { { 0.23, 1 }, { 0.32, 1 } } })
+hl.curve("almostLinear", { type = "bezier", points = { { 0.5, 0.5 }, { 0.75, 1 } } })
+hl.curve("quick",        { type = "bezier", points = { { 0.15, 0 }, { 0.1, 1 } } })
+hl.curve("easy",         { type = "spring", mass = 1, stiffness = 238.1191, dampening = 24.21279 })
+-- A touch bouncier than "easy"; used for windows appearing.
+hl.curve("snappy",       { type = "spring", mass = 1, stiffness = 320, dampening = 22 })
+
+hl.animation({ leaf = "global",      enabled = true, speed = 10,   bezier = "default" })
+hl.animation({ leaf = "border",      enabled = true, speed = 5.39, bezier = "easeOutQuint" })
+
+-- The focus sweep: when a window takes focus, its gradient border rotates into
+-- place once. Style "once" is load-bearing -- the alternative, "loop", makes
+-- Hyprland render at full refresh rate forever, even when no border is visible.
+-- That is exactly the idle GPU cost this config exists to avoid, so: never loop.
+hl.animation({ leaf = "borderangle", enabled = true, speed = 6, bezier = "easeOutQuint", style = "once" })
+
+hl.animation({ leaf = "windows",     enabled = true, speed = 4.79, spring = "easy" })
+hl.animation({ leaf = "windowsIn",   enabled = true, speed = 4.1,  spring = "snappy",       style = "popin 90%" })
+hl.animation({ leaf = "windowsOut",  enabled = true, speed = 1.49, bezier = "almostLinear", style = "popin 90%" })
+
+hl.animation({ leaf = "fade",        enabled = true, speed = 3.03, bezier = "quick" })
+
+-- Layer surfaces = the Quickshell bar, dock, popovers and overlays.
+hl.animation({ leaf = "layers",      enabled = true, speed = 3.81, bezier = "easeOutQuint" })
+hl.animation({ leaf = "layersIn",    enabled = true, speed = 3,    bezier = "easeOutQuint", style = "fade" })
+hl.animation({ leaf = "layersOut",   enabled = true, speed = 2,    bezier = "almostLinear", style = "fade" })
+
+-- Workspace switching: horizontal slide, matching Alt+H / Alt+L direction.
+hl.animation({ leaf = "workspaces",  enabled = true, speed = 2.5,  bezier = "easeOutQuint", style = "slidefade 15%" })
+
+hl.animation({ leaf = "zoomFactor",  enabled = true, speed = 7,    bezier = "quick" })
+
+return true

config/dot/hypr/monitors.lua

@@ -0,0 +1,175 @@
+-- ─────────────────────────────────────────────────────────────────────────────
+-- Monitors
+--
+-- Kuycon P20 on DP-2: 4500x3000 @ 60Hz, 1.5x fractional scale.
+-- 4500/1.5 = 3000 and 3000/1.5 = 2000, both integers, so this is a "clean"
+-- fractional scale and Hyprland will not complain.
+--
+-- On HDR --------------------------------------------------------------------
+-- GNOME runs this panel in bt2100/HDR. Hyprland CAN do that (cm = "hdr"), but
+-- on 0.56.x it currently breaks screencopy: grim screenshots come back empty,
+-- and OBS/Sunshine capture and hyprlock's blurred background go with them.
+-- Root cause is still open upstream. Since screen capture matters more here
+-- than an HDR desktop, the desktop runs SDR at 10-bit and HDR is handed to
+-- fullscreen games only, via render.cm_auto_hdr in looks.lua.
+--
+-- To try full-time HDR anyway, set cm = "hdr" below (or override it in
+-- overrides.lua) and read the notes in that file first.
+-- ─────────────────────────────────────────────────────────────────────────────
+
+local prefs = require("prefs")
+
+-- Per-output overrides written by Panama Settings, keyed by output name:
+--   { ["DP-2"] = {
+--       mode = "3840x2160@60", scale = 2, transform = 0,
+--       x = 0, y = 0, primary = true,
+--   } }
+--
+-- Only mode, scale, and transform are read. Colour management and bit depth
+-- stay here, because those are the settings with a documented reason attached
+-- (see the header) rather than preferences, and a settings page has no way to
+-- explain the screencopy tradeoff at the moment you would be changing it.
+local displays = prefs.get("displays", {})
+if type(displays) ~= "table" then
+    displays = {}
+end
+
+local function mode_dimensions(mode)
+    if type(mode) ~= "string" then
+        return nil, nil
+    end
+    local width, height, refresh = mode:match("^(%d+)x(%d+)@(%d+%.%d+)$")
+    if width == nil then
+        width, height, refresh = mode:match("^(%d+)x(%d+)@(%d+)$")
+    end
+    width, height, refresh = tonumber(width), tonumber(height), tonumber(refresh)
+    if width == nil or height == nil or refresh == nil
+        or width <= 0 or height <= 0 or refresh <= 0 then
+        return nil, nil
+    end
+    return width, height
+end
+
+local function valid_mode(mode)
+    local width = mode_dimensions(mode)
+    return width ~= nil
+end
+
+local function valid_scale(mode, scale)
+    local width, height = mode_dimensions(mode)
+    if width == nil or type(scale) ~= "number" or scale ~= scale
+        or scale <= 0 or scale > 4 then
+        return false
+    end
+    local logical_width = width / scale
+    local logical_height = height / scale
+    return math.abs(logical_width - math.floor(logical_width + 0.5)) < 0.0001
+        and math.abs(logical_height - math.floor(logical_height + 0.5)) < 0.0001
+end
+
+local function valid_transform(transform)
+    return type(transform) == "number"
+        and transform == math.floor(transform)
+        and transform >= 0
+        and transform <= 3
+end
+
+local function valid_coordinate(value)
+    return type(value) == "number"
+        and value == value
+        and value == math.floor(value)
+        and value >= -100000
+        and value <= 100000
+end
+
+local function valid_position(entry)
+    return valid_coordinate(entry.x) and valid_coordinate(entry.y)
+end
+
+local function valid_primary(entry)
+    return type(entry.primary) == "boolean"
+end
+
+local function has_layout_fields(entry)
+    return entry.x ~= nil or entry.y ~= nil or entry.primary ~= nil
+end
+
+local function display_entry(output)
+    if type(output) ~= "string" or output == ""
+        or output:match("^[%w_.-]+$") == nil then
+        return nil
+    end
+    local entry = displays[output]
+    if type(entry) ~= "table" then
+        return nil
+    end
+    if not valid_mode(entry.mode)
+        or not valid_scale(entry.mode, entry.scale)
+        or not valid_transform(entry.transform) then
+        return nil
+    end
+    -- Legacy records have none of the layout fields and keep automatic
+    -- placement. A partially written extended record is unsafe: accepting its
+    -- mode but guessing its position could overlap or strand another output.
+    if has_layout_fields(entry)
+        and (not valid_position(entry) or not valid_primary(entry)) then
+        return nil
+    end
+    return entry
+end
+
+local function display_position(entry, fallback)
+    if entry ~= nil and has_layout_fields(entry) then
+        return string.format("%dx%d", entry.x, entry.y)
+    end
+    return fallback
+end
+
+local shipped_mode = "4500x3000@60"
+local shipped_scale = 1.5
+local shipped_transform = 0
+local dp2 = display_entry("DP-2")
+
+hl.monitor({
+    output   = "DP-2",
+    mode     = dp2 and dp2.mode or shipped_mode,
+    position = display_position(dp2, "0x0"),
+    scale    = dp2 and dp2.scale or shipped_scale,
+    transform = dp2 and dp2.transform or shipped_transform,
+
+    -- 10-bit output. 4500x3000@60 at 10bpc is ~24 Gbps, right at the edge of
+    -- DP 1.4 HBR3, so this relies on DSC. If the display fails to light up or
+    -- falls back to a lower mode, drop this line first.
+    bitdepth = 10,
+
+    -- "auto" = sRGB at 8bpc, wide gamut at 10bpc. Not HDR; see header.
+    cm = "auto",
+})
+
+-- Other connected outputs use the same validated per-output store. They keep
+-- automatic placement and the compositor's normal colour policy; DP-2 alone
+-- carries the panel-specific 10-bit policy documented above.
+for output, _ in pairs(displays) do
+    if output ~= "DP-2" then
+        local entry = display_entry(output)
+        if entry ~= nil then
+            hl.monitor({
+                output = output,
+                mode = entry.mode,
+                position = display_position(entry, "auto"),
+                scale = entry.scale,
+                transform = entry.transform,
+            })
+        end
+    end
+end
+
+-- Any monitor not named above: sane defaults rather than nothing.
+hl.monitor({
+    output   = "",
+    mode     = "preferred",
+    position = "auto",
+    scale    = "auto",
+})
+
+return true

config/dot/hypr/overrides.lua

@@ -0,0 +1,33 @@
+-- ─────────────────────────────────────────────────────────────────────────────
+-- Per-machine overrides
+--
+-- Loaded last, so anything here beats the modules above. Keep machine-specific
+-- settings in this file rather than editing the others -- it keeps the rest of
+-- the config portable between boxes.
+--
+-- Full-time HDR ---------------------------------------------------------------
+-- The desktop ships SDR at 10-bit with HDR handed to fullscreen games (see
+-- monitors.lua for why). To run the whole desktop in HDR, uncomment this:
+--
+--   hl.monitor({
+--       output   = "DP-2",
+--       mode     = "4500x3000@60",
+--       position = "0x0",
+--       scale    = 1.5,
+--       bitdepth = 10,
+--       cm       = "hdr",
+--       sdrbrightness = 1.2,   -- how bright SDR content appears, 1.0 - 2.0
+--       sdrsaturation = 0.98,
+--   })
+--
+-- Then expect to also need some of these, in this order:
+--   hl.config({ render = { keep_unmodified_copy = 1 } })   -- if captures go transparent
+--   hl.config({ render = { use_shader_blur_blend = true } }) -- if that kills blur
+--   hl.config({ render = { direct_scanout = 0 } })         -- if screenshots come back empty
+--   hl.config({ cursor = { no_hardware_cursors = 1 } })    -- if the cursor looks oversaturated
+--
+-- If screenshots, OBS or Sunshine break and stay broken, that is the known
+-- upstream issue -- go back to cm = "auto".
+-- ─────────────────────────────────────────────────────────────────────────────
+
+return true

config/dot/hypr/prefs.lua

@@ -0,0 +1,252 @@
+-- ─────────────────────────────────────────────────────────────────────────────
+-- Shared preferences
+--
+-- Reads the same file Panama Settings writes:
+--   $XDG_CONFIG_HOME/panama/settings.json   (default ~/.config/panama/settings.json)
+--
+-- This is what makes the desktop one product rather than two that happen to
+-- agree. The relationship is:
+--
+--   * the Lua config is the DEFAULT -- every prefs.get() call passes the shipped
+--     value as its fallback, so this config still works standalone with no JSON
+--     file at all;
+--   * the JSON file is the TRUTH -- both Hyprland and Quickshell read it;
+--   * Panama Settings is the EDITOR -- it writes the file and applies the change
+--     live through `hyprctl eval`, so nothing needs a reload and the two sides
+--     cannot drift apart.
+--
+-- Nothing here may raise. A missing, empty, truncated, or actively malformed
+-- file must cost the user nothing worse than their customisations; it must
+-- never cost them a working compositor. Every failure path returns the caller's
+-- fallback.
+-- ─────────────────────────────────────────────────────────────────────────────
+
+local prefs = {}
+
+-- ── A small JSON reader ─────────────────────────────────────────────────────
+-- Hyprland's Lua has no JSON support and pulling in a rock for a flat object of
+-- scalars is not worth the dependency. Handles the whole format apart from
+-- non-ASCII \u escapes, which are replaced rather than decoded -- no setting is
+-- a non-ASCII string, and mangling one is preferable to failing the parse.
+
+local function decode(text)
+    local pos = 1
+
+    local function skipSpace()
+        pos = text:find("[^ \t\r\n]", pos) or #text + 1
+    end
+
+    local parseValue
+
+    local function parseString()
+        pos = pos + 1 -- opening quote
+        local parts = {}
+        while true do
+            local char = text:sub(pos, pos)
+            if char == "" then
+                error("unterminated string")
+            elseif char == '"' then
+                pos = pos + 1
+                break
+            elseif char == "\\" then
+                local escape = text:sub(pos + 1, pos + 1)
+                local simple = {
+                    n = "\n", t = "\t", r = "\r", b = "\b", f = "\f",
+                    ['"'] = '"', ["\\"] = "\\", ["/"] = "/",
+                }
+                if simple[escape] then
+                    parts[#parts + 1] = simple[escape]
+                    pos = pos + 2
+                elseif escape == "u" then
+                    local code = tonumber(text:sub(pos + 2, pos + 5), 16)
+                    parts[#parts + 1] = (code and code < 128) and string.char(code) or "?"
+                    pos = pos + 6
+                else
+                    error("invalid escape")
+                end
+            else
+                parts[#parts + 1] = char
+                pos = pos + 1
+            end
+        end
+        return table.concat(parts)
+    end
+
+    local function parseNumber()
+        local literal = text:match("^-?%d+%.?%d*[eE]?[-+]?%d*", pos)
+        if not literal or literal == "" then
+            error("invalid number")
+        end
+        pos = pos + #literal
+        local value = tonumber(literal)
+        if not value then
+            error("invalid number")
+        end
+        return value
+    end
+
+    local function parseObject()
+        pos = pos + 1 -- opening brace
+        local out = {}
+        skipSpace()
+        if text:sub(pos, pos) == "}" then
+            pos = pos + 1
+            return out
+        end
+        while true do
+            skipSpace()
+            if text:sub(pos, pos) ~= '"' then
+                error("expected key")
+            end
+            local key = parseString()
+            skipSpace()
+            if text:sub(pos, pos) ~= ":" then
+                error("expected colon")
+            end
+            pos = pos + 1
+            out[key] = parseValue()
+            skipSpace()
+            local char = text:sub(pos, pos)
+            pos = pos + 1
+            if char == "}" then
+                return out
+            elseif char ~= "," then
+                error("expected comma or closing brace")
+            end
+        end
+    end
+
+    local function parseArray()
+        pos = pos + 1 -- opening bracket
+        local out = {}
+        skipSpace()
+        if text:sub(pos, pos) == "]" then
+            pos = pos + 1
+            return out
+        end
+        while true do
+            out[#out + 1] = parseValue()
+            skipSpace()
+            local char = text:sub(pos, pos)
+            pos = pos + 1
+            if char == "]" then
+                return out
+            elseif char ~= "," then
+                error("expected comma or closing bracket")
+            end
+        end
+    end
+
+    parseValue = function()
+        skipSpace()
+        local char = text:sub(pos, pos)
+        if char == "{" then
+            return parseObject()
+        elseif char == "[" then
+            return parseArray()
+        elseif char == '"' then
+            return parseString()
+        elseif text:sub(pos, pos + 3) == "true" then
+            pos = pos + 4
+            return true
+        elseif text:sub(pos, pos + 4) == "false" then
+            pos = pos + 5
+            return false
+        elseif text:sub(pos, pos + 3) == "null" then
+            pos = pos + 4
+            return nil
+        elseif char == "" then
+            error("unexpected end of input")
+        else
+            return parseNumber()
+        end
+    end
+
+    local value = parseValue()
+    if type(value) ~= "table" then
+        error("top level value is not an object")
+    end
+    return value
+end
+
+-- ── Loading ─────────────────────────────────────────────────────────────────
+
+local function settingsPath()
+    local configHome = os.getenv("XDG_CONFIG_HOME")
+    if configHome == nil or configHome == "" then
+        local home = os.getenv("HOME")
+        if home == nil or home == "" then
+            return nil
+        end
+        configHome = home .. "/.config"
+    end
+    return configHome .. "/panama/settings.json"
+end
+
+local function read()
+    local path = settingsPath()
+    if not path then
+        return {}
+    end
+    local file = io.open(path, "r")
+    if not file then
+        return {} -- no file yet is the normal first-run case, not an error
+    end
+    local text = file:read("*a")
+    file:close()
+    if not text or text:match("^%s*$") then
+        return {}
+    end
+    local ok, parsed = pcall(decode, text)
+    if ok and type(parsed) == "table" then
+        return parsed
+    end
+    return {}
+end
+
+-- Loaded once at config time. A pcall around the whole thing so that even an
+-- unanticipated failure in the reader degrades to shipped defaults.
+local values = {}
+do
+    local ok, parsed = pcall(read)
+    if ok and type(parsed) == "table" then
+        values = parsed
+    end
+end
+
+-- ── Public interface ────────────────────────────────────────────────────────
+
+-- Returns the stored value for `key`, or `fallback` when it is absent or is not
+-- the same type as the fallback. The type guard matters: a stale or hand-edited
+-- file that puts a string where Hyprland needs a number would otherwise abort
+-- the config, taking down far more than the one setting that was wrong.
+function prefs.get(key, fallback)
+    local value = values[key]
+    if value == nil then
+        return fallback
+    end
+    if type(value) ~= type(fallback) then
+        return fallback
+    end
+    return value
+end
+
+-- Hyprland has no boolean-to-integer coercion for options that take 0/1, and
+-- several of them read more naturally as a toggle in the settings UI.
+function prefs.getInt(key, fallback)
+    local value = values[key]
+    if type(value) == "boolean" then
+        return value and 1 or 0
+    end
+    if type(value) ~= "number" then
+        return fallback
+    end
+    return math.floor(value + 0.5)
+end
+
+-- True when a settings file was actually read. Useful from overrides.lua.
+function prefs.loaded()
+    return next(values) ~= nil
+end
+
+return prefs

config/dot/hypr/rules.lua

@@ -0,0 +1,207 @@
+-- ─────────────────────────────────────────────────────────────────────────────
+-- Window, workspace and layer rules
+--
+-- Rules evaluate top to bottom, last match wins -- but every NAMED rule is
+-- evaluated before every anonymous one, so a named rule can never override an
+-- anonymous rule further down. Names are used sparingly here for that reason.
+--
+-- Matching is Google RE2 (no backtracking). Prefix a pattern with "negative:"
+-- to invert it.
+-- ─────────────────────────────────────────────────────────────────────────────
+
+-- ── Upstream sanity rules ───────────────────────────────────────────────────
+hl.window_rule({
+    name  = "suppress-maximize-events",
+    match = { class = ".*" },
+    suppress_event = "maximize",
+})
+
+hl.window_rule({
+    name  = "fix-xwayland-drags",
+    match = {
+        class      = "^$",
+        title      = "^$",
+        xwayland   = true,
+        float      = true,
+        fullscreen = false,
+        pin        = false,
+    },
+    no_focus = true,
+})
+
+-- ── Floating apps ───────────────────────────────────────────────────────────
+-- Carried over from the Forge windows.json override list, minus entries for
+-- apps that are no longer installed.
+hl.window_rule({
+    match = {
+        class = "^(jetbrains-toolbox|zoom|Cider|Hidamari|com\\.mattjakeman\\.ExtensionManager)$",
+    },
+    float = true,
+})
+
+hl.window_rule({
+    match = { class = "^([Bb]itwarden|com\\.bitwarden\\.desktop)$" },
+    float = true,
+})
+
+hl.window_rule({
+    match = { class = "^(com\\.nextcloud\\.desktopclient\\.nextcloud|Nextcloud)$" },
+    float = true,
+})
+
+hl.window_rule({
+    match = { class = "^(org\\.gnome\\.Calculator|gnome-calculator)$" },
+    float = true,
+    size  = { 400, 600 },
+    center = true,
+})
+
+hl.window_rule({
+    match = { class = "^(mpv|io\\.mpv\\.Mpv)$" },
+    float = true,
+    -- Video should never be blurred or dimmed behind another window.
+    no_blur = true,
+    no_dim  = true,
+})
+
+hl.window_rule({
+    match = { class = "^(com\\.spotify\\.Client|Spotify)$" },
+    float = true,
+})
+
+-- Settings-style utility windows and pickers: float and centre, like GNOME did.
+hl.window_rule({
+    match = { class = "^(pavucontrol|org\\.pulseaudio\\.pavucontrol|nm-connection-editor|blueman-manager|org\\.gnome\\.Settings)$" },
+    float  = true,
+    size   = { "monitor_w * 0.45", "monitor_h * 0.6" },
+    center = true,
+})
+
+-- Portal dialogs (file chooser, screen share picker) should always float.
+hl.window_rule({
+    match = { class = "^(xdg-desktop-portal-gtk|org\\.freedesktop\\.impl\\.portal\\.desktop\\.gtk|hyprland-share-picker)$" },
+    float  = true,
+    center = true,
+})
+
+hl.window_rule({
+    match = { title = "^(Open File|Save File|Save As|Open Folder|Select a File|Choose Files)$" },
+    float  = true,
+    center = true,
+})
+
+-- Polkit prompt.
+hl.window_rule({
+    match  = { class = "^(hyprpolkitagent|polkit-gnome-authentication-agent-1)$" },
+    float  = true,
+    center = true,
+})
+
+-- ── Gaming ──────────────────────────────────────────────────────────────────
+-- content = "game" is the keystone: misc.vrr = 3, render.direct_scanout = 2 and
+-- cursor.no_break_fs_vrr = 2 all key off it. Blur, animation, shadow and dim are
+-- all disabled so the compositor gets out of the way entirely.
+hl.window_rule({
+    match = { class = "^(steam_app_\\d+|gamescope|lutris|net\\.lutris\\.Lutris|com\\.heroicgameslauncher\\.hgl|Minecraft.*|moonlight|com\\.moonlight_stream\\.Moonlight)$" },
+    content   = "game",
+    immediate = true,
+    no_blur   = true,
+    no_anim   = true,
+    no_shadow = true,
+    no_dim    = true,
+})
+
+-- Steam itself is a normal window, but its transient popups are a mess.
+hl.window_rule({
+    match = { class = "^steam$", title = "^(Friends List|Steam Settings|Special Offer.*)$" },
+    float = true,
+})
+
+-- Fullscreen video in a browser also benefits from no blur / no dim.
+hl.window_rule({
+    match   = { fullscreen = true },
+    no_blur = true,
+    no_dim  = true,
+})
+
+-- ── Workspace rules ─────────────────────────────────────────────────────────
+-- Deliberately NO "smart gaps".
+--
+-- The usual trick is to strip gaps, border and rounding when a workspace holds
+-- a single tiled window (`workspace = "w[tv1]"` + matching window rules). It
+-- was here and it was wrong for this setup: the common case is one window on a
+-- workspace, so the desktop spent most of its time square-cornered and
+-- edge-to-edge -- the opposite of the intended look. Gaps and rounding are
+-- constant now, however many windows are open.
+
+-- ── Layer rules (Quickshell surfaces) ───────────────────────────────────────
+-- Namespaces are set in QML via WlrLayershell.namespace; keep these regexes and
+-- those strings in sync. `hyprctl layers` lists what is actually live.
+--
+-- The bar intentionally has no rule: it is a transparent edge-to-edge input
+-- surface, not glass. Its individual controls paint their own hover feedback.
+-- Keeping a full-width blur rule here would spend compositor work on pixels
+-- the bar does not draw.
+
+hl.layer_rule({
+    name  = "qs-dock",
+    match = { namespace = "^qs-dock$" },
+    blur         = true,
+    ignore_alpha = 0.3,
+})
+
+-- Popovers: calendar, quick settings, notification centre, tray menus.
+hl.layer_rule({
+    name  = "qs-popover",
+    match = { namespace = "^qs-popover" },
+    blur         = true,
+    blur_popups  = true,
+    ignore_alpha = 0.2,
+})
+
+-- Overview, capture and local screen-reading UI dim the desktop behind them.
+hl.layer_rule({
+    name  = "qs-overlay",
+    match = { namespace = "^qs-(overview|capture|screen-intelligence)$" },
+    blur         = true,
+    ignore_alpha = 0.4,
+    dim_around   = true,
+    no_screen_share = true,
+})
+
+-- Notification toasts. Blurred like every other shell surface -- without this
+-- the cards are a near-transparent fill sitting directly on the wallpaper and
+-- read as washed out rather than as glass.
+--
+-- no_anim because the toasts animate themselves in QML, and no_screen_share so
+-- they don't leak into OBS or Sunshine streams.
+hl.layer_rule({
+    name  = "qs-notifications",
+    match = { namespace = "^qs-notifications$" },
+    blur             = true,
+    ignore_alpha     = 0.15,
+    no_anim          = true,
+    no_screen_share  = true,
+})
+
+-- Signal Glass provides its own event-driven motion, so the compositor only
+-- supplies the material blur and privacy behavior.
+hl.layer_rule({
+    name  = "qs-signal-glass",
+    match = { namespace = "^qs-signal-glass$" },
+    blur             = true,
+    ignore_alpha     = 0.15,
+    no_anim          = true,
+    no_screen_share  = true,
+})
+
+-- The launcher blurs and dims whatever is behind it.
+hl.layer_rule({
+    name  = "launcher",
+    match = { namespace = "^(vicinae|wofi)$" },
+    blur         = true,
+    ignore_alpha = 0.5,
+    dim_around   = true,
+})
+
+return true

config/dot/kitty/kitty.conf

@@ -183,7 +183,6 @@ font_size 14.0
 
 #: Cursor customization {{{
 
-cursor #c8d3f5
 
 #: Default cursor color. If set to the special value none the cursor
 #: will be rendered with a "reverse video" effect. It's color will be
@@ -193,7 +192,6 @@ cursor #c8d3f5
 #: precedence. Also, the cursor colors are modified if the cell
 #: background and foreground colors have very low contrast.
 
-cursor_text_color #111325
 
 #: The color of text under the cursor. If you want it rendered with
 #: the background color of the cell underneath instead, use the
@@ -312,7 +310,6 @@ cursor_shape block
 #: robustly with the ever-changing sea of bugs that is Cocoa is too
 #: much effort.
 
-url_color #4fd6be
 # url_style curly
 
 #: The color and style for highlighting URLs on mouse-over. url_style
@@ -734,12 +731,10 @@ window_border_width 1pt
 #: placed centrally. A value of top-left means the padding will be
 #: only at the bottom and right edges.
 
-active_border_color #82aaff
 
 #: The color for the border of the active window. Set this to none to
 #: not draw borders around the active window.
 
-inactive_border_color #2f334d
 
 #: The color for the border of inactive windows.
 
@@ -960,16 +955,11 @@ tab_powerline_style round
 #: Template to use for active tabs. If not specified falls back to
 #: tab_title_template.
 
-active_tab_foreground   #1e2030
-active_tab_background   #82aaff
 # active_tab_font_style   bold-italic
-inactive_tab_foreground #c8d3f5
-inactive_tab_background #42465a
 # inactive_tab_font_style normal
 
 #: Tab bar colors and styles.
 
-tab_bar_background #222436
 
 #: Background color for the tab bar. Defaults to using the terminal
 #: background color.
@@ -983,8 +973,8 @@ tab_bar_margin_color none
 
 #: Color scheme {{{
 
-foreground #c8d3f5
-background #222436
+
+include current-theme.conf
 
 #: The foreground and background colors.
 
@@ -1043,8 +1033,6 @@ dim_opacity 1
 #: How much to dim text that has the DIM/FAINT attribute set. One
 #: means no dimming and zero means fully dimmed (i.e. invisible).
 
-selection_foreground #2d3f76
-selection_background #c8d3f5
 
 #: The foreground and background colors for text selected with the
 #: mouse. Setting both of these to none will cause a "reverse video"
@@ -1060,47 +1048,29 @@ selection_background #c8d3f5
 #: dull and bright version, for the first 16 colors. You can set the
 #: remaining 240 colors as color16 to color255.
 
-color0 #1b1d2b
-color8 #444a73
 
 #: black
 
-color1 #ff757f
-color9 #ff757f
 
 #: red
 
-color2  #a5e8b5
-color10 #a5e8b5
 
 #: green
-color3  #ffc777
-color11 #ffc777
 
 #: yellow
 
-color4  #82aaff
-color12 #82aaff
 
 #: blue
 
-color5  #c099ff
-color13 #c099ff
 
 #: magenta
 
-color6  #86e1fc
-color14 #86e1fc
 
 #: cyan
 
-color7  #828bb8
-color15 #c8d3f5
 
 #: white
 
-color16 #ff966c
-color17 #c53b53
 
 # mark1_foreground black
 

config/dot/kitty/themes/tokyonight-day.conf

@@ -0,0 +1,38 @@
+# Tokyo Night Day — the palette's own light variant.
+#
+# The same hues as Moon at a different lightness, so a terminal in light mode
+# still belongs to this desktop rather than looking like a different machine.
+# Kept in the same order as tokyonight-moon.conf so the two can be diffed.
+
+cursor #3760bf
+cursor_text_color #e1e2e7
+url_color #118c74
+active_border_color #2e7de9
+inactive_border_color #c4c8da
+active_tab_foreground   #e1e2e7
+active_tab_background   #2e7de9
+inactive_tab_foreground #3760bf
+inactive_tab_background #c4c8da
+tab_bar_background #e1e2e7
+foreground #3760bf
+background #e1e2e7
+selection_foreground #e1e2e7
+selection_background #99a7df
+color0 #e9e9ed
+color8 #a1a6c5
+color1 #f52a65
+color9 #f52a65
+color2  #587539
+color10 #587539
+color3  #8c6c3e
+color11 #8c6c3e
+color4  #2e7de9
+color12 #2e7de9
+color5  #9854f1
+color13 #9854f1
+color6  #007197
+color14 #007197
+color7  #6172b0
+color15 #3760bf
+color16 #b15c00
+color17 #c64343

config/dot/kitty/themes/tokyonight-moon.conf

@@ -0,0 +1,42 @@
+# Tokyo Night Moon — the dark theme Panama ships.
+#
+# Extracted from kitty.conf so the two schemes can be swapped. kitty.conf
+# includes current-theme.conf, which Panama generates from the colour scheme
+# setting; that generated file is gitignored because it is machine state.
+#
+# Live changes go through `kitty @ set-colors`, which is why kitty.conf enables
+# remote control. Without it a scheme change would only reach terminals opened
+# afterwards.
+
+cursor #c8d3f5
+cursor_text_color #111325
+url_color #4fd6be
+active_border_color #82aaff
+inactive_border_color #2f334d
+active_tab_foreground #1e2030
+active_tab_background #82aaff
+inactive_tab_foreground #c8d3f5
+inactive_tab_background #42465a
+tab_bar_background #222436
+foreground #c8d3f5
+background #222436
+selection_foreground #2d3f76
+selection_background #c8d3f5
+color0 #1b1d2b
+color8 #444a73
+color1 #ff757f
+color9 #ff757f
+color2 #a5e8b5
+color10 #a5e8b5
+color3 #ffc777
+color11 #ffc777
+color4 #82aaff
+color12 #82aaff
+color5 #c099ff
+color13 #c099ff
+color6 #86e1fc
+color14 #86e1fc
+color7 #828bb8
+color15 #c8d3f5
+color16 #ff966c
+color17 #c53b53

config/dot/nvim/lua/config/autocmds.lua

@@ -10,3 +10,6 @@ vim.api.nvim_create_autocmd("BufWritePre", {
     vim.fn.winrestview(view)
   end,
 })
+
+-- Follow the desktop's light/dark setting while running, not only at startup.
+require("config.panama").watch()

config/dot/nvim/lua/config/panama.lua

@@ -0,0 +1,88 @@
+-- Panama desktop integration.
+--
+-- Neovim is the one application here that neither reads the desktop portal nor
+-- has a control socket open by default, so it reads the shared settings file
+-- directly -- the same ~/.config/panama/settings.json that the shell and the
+-- Hyprland config read.
+--
+-- Nothing here may raise. A missing or malformed settings file must cost the
+-- user their colour scheme preference and nothing else; editing text is more
+-- important than matching the desktop.
+
+local M = {}
+
+local function settings_path()
+  local config_home = os.getenv("XDG_CONFIG_HOME")
+  if config_home == nil or config_home == "" then
+    local home = os.getenv("HOME")
+    if home == nil or home == "" then
+      return nil
+    end
+    config_home = home .. "/.config"
+  end
+  return config_home .. "/panama/settings.json"
+end
+
+-- "dark" or "light". Defaults to dark, which is what Panama ships.
+function M.color_scheme()
+  local path = settings_path()
+  if not path then
+    return "dark"
+  end
+
+  local ok, contents = pcall(function()
+    local file = io.open(path, "r")
+    if not file then
+      return nil
+    end
+    local text = file:read("*a")
+    file:close()
+    return text
+  end)
+  if not ok or not contents or contents == "" then
+    return "dark"
+  end
+
+  local decoded_ok, decoded = pcall(vim.json.decode, contents)
+  if not decoded_ok or type(decoded) ~= "table" then
+    return "dark"
+  end
+
+  return decoded.colorScheme == "light" and "light" or "dark"
+end
+
+function M.is_light()
+  return M.color_scheme() == "light"
+end
+
+-- tokyonight ships a light variant in the same family, so light mode stays the
+-- same identity rather than becoming a different editor theme.
+function M.tokyonight_style()
+  return M.is_light() and "day" or "moon"
+end
+
+-- Re-apply the scheme when the window regains focus.
+--
+-- Neovim reads the setting once at startup and has no control socket open by
+-- default, so an editor already running when the desktop scheme flips would
+-- otherwise stay on the old palette until it was restarted. FocusGained is
+-- cheap, happens exactly when you would notice the mismatch, and does nothing
+-- at all unless the scheme actually changed.
+function M.watch()
+  local applied = M.color_scheme()
+
+  vim.api.nvim_create_autocmd("FocusGained", {
+    group = vim.api.nvim_create_augroup("PanamaColorScheme", { clear = true }),
+    callback = function()
+      local current = M.color_scheme()
+      if current == applied then
+        return
+      end
+      applied = current
+      vim.o.background = current
+      pcall(vim.cmd.colorscheme, current == "light" and "tokyonight-day" or "tokyonight-moon")
+    end,
+  })
+end
+
+return M

config/dot/nvim/lua/plugins/colorscheme.lua

@@ -1,31 +1,68 @@
+-- Tokyo Night, following the desktop's colour scheme.
+--
+-- Moon when Panama is dark, Day when it is light. Same theme family either way,
+-- so the editor keeps the identity the rest of the desktop has rather than
+-- becoming a different-looking application when the scheme flips.
+--
+-- The readability fixes below are deliberately dark-only. They were written
+-- against Moon's palette -- a pale comment colour, a mid-grey gutter -- and
+-- applying them to Day would put light grey text on a light background, which
+-- is exactly the legibility problem they exist to solve, inverted.
+
+local panama = require("config.panama")
+
 return {
   {
     "folke/tokyonight.nvim",
-    opts = {
-      style = "moon",
+    opts = function()
+      local light = panama.is_light()
+
+      return {
+        style = panama.tokyonight_style(),
+        light_style = "day",
         transparent = true,
+
         on_colors = function(colors)
+          if light then
+            -- Day's defaults are tuned for a light ground and mostly need no
+            -- help. Comments are the exception: the shipped #848cb5 measures
+            -- 2.54:1 against the #e1e2e7 background, well under the 3:1 floor
+            -- for secondary text. This is 3.25:1 -- readable, and still clearly
+            -- dimmer than Normal's 4.52:1 so it does not compete with code.
+            colors.comment = "#7079a8"
+            return
+          end
+
           colors.comment = "#a0a7c5"
           colors.fg_gutter = "#787f93"
           colors.terminal_black = "#828bb8"
         end,
+
         on_highlights = function(highlights, colors)
-        -- Fix inline code visibility in markdown
+          -- Inline code in markdown is invisible at both lightnesses without
+          -- an explicit background, because the theme leaves it unset.
           highlights["@markup.raw.markdown_inline"] = {
-          bg = colors.terminal_black,
+            bg = light and colors.bg_highlight or colors.terminal_black,
             fg = colors.fg,
           }
           highlights["RenderMarkdownCodeInline"] = {
-          bg = colors.terminal_black,
+            bg = light and colors.bg_highlight or colors.terminal_black,
             fg = colors.fg,
           }
-        -- Fix LspReference* readability: DiagnosticUnnecessary dims fg for unused
-        -- imports, making text nearly invisible against LspReferenceText's background
-        highlights["LspReferenceText"] = { bg = colors.fg_gutter, fg = colors.fg }
-        highlights["LspReferenceRead"] = { bg = colors.fg_gutter, fg = colors.fg }
-        highlights["LspReferenceWrite"] = { bg = colors.fg_gutter, fg = colors.fg }
+
+          -- LspReference* readability: DiagnosticUnnecessary dims fg for unused
+          -- imports, making text nearly invisible against LspReferenceText's
+          -- background.
+          local reference = {
+            bg = light and colors.bg_visual or colors.fg_gutter,
+            fg = colors.fg,
+          }
+          highlights["LspReferenceText"] = reference
+          highlights["LspReferenceRead"] = reference
+          highlights["LspReferenceWrite"] = reference
+        end,
+      }
     end,
-    },
   },
   {
     "LazyVim/LazyVim",

config/dot/quickshell/audio-streams-harness.qml

@@ -0,0 +1,136 @@
+import Quickshell
+import Quickshell.Io
+import Quickshell.Services.Pipewire
+import QtQuick
+
+import "services/AudioStreams.js" as AudioStreams
+import qs.services
+
+ShellRoot {
+    readonly property int audioOutStreamFlag: 4
+
+    property var fixtureNodes: [
+        {
+            id: 10,
+            ready: true,
+            type: audioOutStreamFlag,
+            properties: {
+                "application.id": "org.chromium.Chromium",
+                "application.name": "Chromium",
+                "application.icon_name": "chromium"
+            },
+            description: "Chromium audio",
+            audio: { volume: 0.4, muted: false }
+        },
+        {
+            id: 11,
+            ready: true,
+            type: audioOutStreamFlag,
+            properties: {
+                "application.id": "org.chromium.Chromium",
+                "application.name": "Chromium",
+                "application.icon_name": "chromium"
+            },
+            description: "Chromium audio",
+            audio: { volume: 0.8, muted: true }
+        },
+        {
+            id: 20,
+            ready: true,
+            type: audioOutStreamFlag,
+            properties: {
+                "application.process.binary": "spotify",
+                "application.name": "Spotify"
+            },
+            description: "Spotify",
+            audio: { volume: 0.25, muted: false }
+        },
+        {
+            id: 30,
+            ready: true,
+            type: 2,
+            properties: { "application.name": "Microphone capture" },
+            description: "Input stream",
+            audio: { volume: 0.5, muted: false }
+        },
+        {
+            id: 40,
+            ready: false,
+            type: audioOutStreamFlag,
+            properties: { "application.name": "Not ready" },
+            description: "Unready stream",
+            audio: { volume: 0.5, muted: false }
+        },
+        {
+            id: 99,
+            ready: true,
+            type: audioOutStreamFlag,
+            properties: {},
+            description: "",
+            audio: { volume: 1, muted: false }
+        }
+    ]
+
+    function groups(): var {
+        return AudioStreams.group(fixtureNodes, audioOutStreamFlag);
+    }
+
+    IpcHandler {
+        target: "application-volume-test"
+
+        function summary(): string {
+            const applications = groups();
+            const chromium = applications.find(application =>
+                application.key === "org.chromium.Chromium");
+            return JSON.stringify({
+                groups: applications.map(application => ({
+                    key: application.key,
+                    label: application.label,
+                    icon: application.icon,
+                    count: application.nodes.length
+                })),
+                chromiumVolume: AudioStreams.volume(chromium),
+                chromiumMuted: AudioStreams.muted(chromium)
+            });
+        }
+
+        function mutateVolume(): string {
+            const chromium = groups().find(application =>
+                application.key === "org.chromium.Chromium");
+            const changed = AudioStreams.setVolume(chromium, 0.7);
+            return JSON.stringify({
+                changed,
+                volumes: chromium.nodes.map(node => node.audio.volume),
+                muted: chromium.nodes.map(node => node.audio.muted)
+            });
+        }
+
+        function mutateMute(): string {
+            const chromium = groups().find(application =>
+                application.key === "org.chromium.Chromium");
+            const changed = AudioStreams.setMuted(chromium, true);
+            return JSON.stringify({
+                changed,
+                muted: chromium.nodes.map(node => node.audio.muted)
+            });
+        }
+
+        function serviceSummary(): string {
+            const applications = AudioDevices.applications;
+            return JSON.stringify({
+                count: applications.length,
+                validTypes: applications.every(application =>
+                    application.nodes.every(node =>
+                        (node.type & PwNodeType.AudioOutStream)
+                            === PwNodeType.AudioOutStream))
+            });
+        }
+
+        function invalidMutations(): string {
+            return JSON.stringify({
+                nullVolume: AudioDevices.setApplicationVolume(null, 0.5),
+                emptyMute: AudioDevices.setApplicationMuted({ nodes: [] }, true)
+            });
+        }
+    }
+}

config/dot/quickshell/config/DesktopPreferences.qml

@@ -0,0 +1,177 @@
+pragma Singleton
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Durable user choices, derived entirely from config/PreferenceSchema.qml.
+//
+// This object owns reading, validating, and writing. It knows nothing about
+// which settings exist -- that is the schema's job -- so adding a setting never
+// requires touching this file. That is the point: the previous implementation
+// restated every key four times (a property alias, a JSON adapter property, a
+// change handler, and a line in reset), and each omission failed silently.
+//
+// Reads go through get(), writes through set(). Typed accessors for the values
+// the shell reads on every frame live in Settings.qml, which remains the stable
+// public surface.
+//
+// The store lives at ~/.config/panama/settings.json rather than inside
+// Quickshell's per-shell state directory, because the Hyprland Lua config reads
+// the same file (see config/dot/hypr/prefs.lua) and because a user should be
+// able to back it up, diff it, or keep it in a dotfiles repo.
+// ─────────────────────────────────────────────────────────────────────────────
+
+import Quickshell
+import Quickshell.Io
+import QtQuick
+
+Singleton {
+    id: root
+
+    readonly property string path: (Quickshell.env("XDG_CONFIG_HOME") || `${Quickshell.env("HOME")}/.config`) + "/panama/settings.json"
+
+    // Bumped on every accepted change. get() reads it so bindings built on get()
+    // have something to invalidate; a bare function call would otherwise capture
+    // no dependency and every reader would silently go stale.
+    property int revision: 0
+
+    // Everything currently on disk, including keys this build does not know
+    // about. Unknown keys are carried through untouched so that rolling back to
+    // an older Panama does not discard a newer version's settings.
+    property var values: ({})
+
+    property bool loaded: false
+
+    function get(key: string): var {
+        root.revision;
+        const stored = root.values[key];
+        if (stored === undefined)
+            return PreferenceSchema.defaultFor(key);
+        const coerced = PreferenceSchema.coerce(key, stored);
+        return coerced === undefined ? PreferenceSchema.defaultFor(key) : coerced;
+    }
+
+    // Returns false when the key is unknown or the value cannot be represented,
+    // so a caller can surface the rejection instead of assuming it took.
+    function set(key: string, value: var): bool {
+        if (!PreferenceSchema.has(key))
+            return false;
+        const coerced = PreferenceSchema.coerce(key, value);
+        if (coerced === undefined)
+            return false;
+        if (root.values[key] === coerced)
+            return true;
+
+        // Reassign rather than mutate: QML does not notify on in-place changes
+        // to a var property's contents.
+        const next = Object.assign({}, root.values);
+        next[key] = coerced;
+        root.values = next;
+        root.revision++;
+        persistTimer.restart();
+        return true;
+    }
+
+    // Restores every schema default in one write. Complete by construction --
+    // there is no hand-maintained list to fall out of sync with the schema.
+    function resetDesktopDefaults(): void {
+        const next = Object.assign({}, root.values, PreferenceSchema.defaults());
+        root.values = next;
+        root.revision++;
+        persistTimer.restart();
+    }
+
+    // Re-read the file from disk. Used after something outside the shell has
+    // rewritten it -- restoring a snapshot, or a hand edit -- so the running
+    // desktop reflects the new contents without waiting for the next change.
+    function reload(): void {
+        preferencesFile.reload();
+        root.load();
+    }
+
+    function load(): void {
+        let parsed = {};
+        try {
+            const text = preferencesFile.text();
+            if (text && text.trim().length > 0)
+                parsed = JSON.parse(text);
+        } catch (error) {
+            // A corrupt file must not cost the user a working desktop. Fall
+            // back to shipped defaults and let the next write replace it.
+            parsed = {};
+        }
+        const raw = (parsed && typeof parsed === "object") ? parsed : {};
+
+        // Upgrade before anything reads a value. A stored key the current
+        // schema no longer recognises is carried through untouched and silently
+        // stops taking effect, so the conversion has to happen here rather than
+        // being noticed later by whoever owns that setting.
+        const result = Migrations.apply(raw);
+        root.values = result.values;
+
+        if (result.migrated)
+            console.info("Settings migrated from version", result.from, "to", result.to + ":",
+                         result.applied.join("; "));
+
+        // Write whenever the version moved, which includes stamping a file
+        // written before versioning existed. Left unwritten, the stamp lives
+        // only in memory and is redone on every launch, and a migration that is
+        // not idempotent would compound.
+        if (result.changed)
+            persistTimer.restart();
+
+        root.revision++;
+        root.loaded = true;
+    }
+
+    FileView {
+        id: preferencesFile
+
+        path: root.path
+        blockLoading: true
+        printErrors: false
+        atomicWrites: true
+
+        onLoaded: root.load()
+        // No file yet is the normal first-run case, not an error.
+        onLoadFailed: root.load()
+    }
+
+    Component.onCompleted: {
+        migration.adopt();
+        root.load();
+    }
+
+    // Coalesce a burst of changes into one atomic write. Writing on every
+    // assignment races a second assignment and can reload the older value.
+    Timer {
+        id: persistTimer
+        interval: 0
+        onTriggered: preferencesFile.setText(JSON.stringify(root.values, null, 2) + "\n")
+    }
+
+    // One-time move from the pre-Stage-1 location inside Quickshell's state
+    // directory. Reads the old file only when the new one does not exist yet, so
+    // it can never overwrite newer settings, and never deletes the original.
+    QtObject {
+        id: migration
+
+        function adopt(): void {
+            if (preferencesFile.text())
+                return;
+            try {
+                const legacy = legacyFile.text();
+                if (legacy && legacy.trim().length > 0)
+                    preferencesFile.setText(legacy);
+            } catch (error) {
+                // Nothing to migrate.
+            }
+        }
+    }
+
+    FileView {
+        id: legacyFile
+
+        path: Quickshell.stateDir + "/panama-settings.json"
+        blockLoading: true
+        printErrors: false
+    }
+}

config/dot/quickshell/config/HomePreferences.qml

@@ -0,0 +1,176 @@
+pragma Singleton
+
+import Quickshell
+import Quickshell.Io
+import QtQuick
+
+Singleton {
+    id: root
+
+    property alias initialized: values.initialized
+    property alias favorites: values.favorites
+    property string saveError: ""
+
+    FileView {
+        id: preferencesFile
+
+        path: Quickshell.stateDir + "/panama-home.json"
+        blockLoading: true
+        printErrors: false
+        atomicWrites: true
+        onSaved: root.saveError = ""
+        onSaveFailed: error => root.saveError = "Could not save Home favourites."
+
+        JsonAdapter {
+            id: values
+
+            property bool initialized: false
+            property var favorites: []
+        }
+    }
+
+    Connections {
+        target: values
+        function onInitializedChanged(): void { persistTimer.restart(); }
+        function onFavoritesChanged(): void { persistTimer.restart(); }
+    }
+
+    Component.onCompleted: preferencesFile.reload()
+
+    Timer {
+        id: persistTimer
+        interval: 180
+        repeat: false
+        onTriggered: preferencesFile.writeAdapter()
+    }
+
+    function cloneFavorites(): var {
+        var clone = [];
+        for (var index = 0; index < values.favorites.length; index++) {
+            var favorite = values.favorites[index];
+            clone.push({
+                id: favorite.id,
+                alias: favorite.alias
+            });
+        }
+        return clone;
+    }
+
+    function isValidEntityId(entityId: var): bool {
+        return typeof entityId === "string" && /^light\.[a-z0-9_]+$/.test(entityId);
+    }
+
+    function initialize(legacyIds: var): void {
+        if (values.initialized) {
+            return;
+        }
+
+        var seededFavorites = [];
+        var seen = {};
+        if (legacyIds && typeof legacyIds.length === "number") {
+            for (var index = 0; index < legacyIds.length; index++) {
+                var entityId = legacyIds[index];
+                if (!isValidEntityId(entityId) || seen[entityId]) {
+                    continue;
+                }
+                seen[entityId] = true;
+                seededFavorites.push({ id: entityId, alias: "" });
+            }
+        }
+
+        values.favorites = seededFavorites;
+        values.initialized = true;
+    }
+
+    function resetHomeDefaults(): void {
+        persistTimer.stop();
+        values.favorites = [];
+        values.initialized = false;
+        root.saveError = "";
+        preferencesFile.writeAdapter();
+    }
+
+    function isSelected(entityId: string): bool {
+        for (var index = 0; index < values.favorites.length; index++) {
+            if (values.favorites[index].id === entityId) {
+                return true;
+            }
+        }
+        return false;
+    }
+
+    function aliasFor(entityId: string, sourceName: string): string {
+        for (var index = 0; index < values.favorites.length; index++) {
+            var favorite = values.favorites[index];
+            if (favorite.id === entityId && favorite.alias !== "") {
+                return favorite.alias;
+            }
+        }
+        return sourceName;
+    }
+
+    function add(entityId: string): void {
+        if (!isValidEntityId(entityId) || isSelected(entityId)) {
+            return;
+        }
+
+        var nextFavorites = cloneFavorites();
+        nextFavorites.push({ id: entityId, alias: "" });
+        values.favorites = nextFavorites;
+    }
+
+    function remove(entityId: string): void {
+        var nextFavorites = [];
+        var removed = false;
+        for (var index = 0; index < values.favorites.length; index++) {
+            var favorite = values.favorites[index];
+            if (favorite.id === entityId) {
+                removed = true;
+                continue;
+            }
+            nextFavorites.push({ id: favorite.id, alias: favorite.alias });
+        }
+        if (removed) {
+            values.favorites = nextFavorites;
+        }
+    }
+
+    function setAlias(entityId: string, alias: string): void {
+        var nextFavorites = cloneFavorites();
+        var updated = false;
+        var trimmedAlias = String(alias).trim();
+        for (var index = 0; index < nextFavorites.length; index++) {
+            if (nextFavorites[index].id === entityId) {
+                nextFavorites[index] = { id: entityId, alias: trimmedAlias };
+                updated = true;
+                break;
+            }
+        }
+        if (updated) {
+            values.favorites = nextFavorites;
+        }
+    }
+
+    function move(entityId: string, targetIndex: int): void {
+        var nextFavorites = cloneFavorites();
+        var currentIndex = -1;
+        for (var index = 0; index < nextFavorites.length; index++) {
+            if (nextFavorites[index].id === entityId) {
+                currentIndex = index;
+                break;
+            }
+        }
+        if (currentIndex === -1) {
+            return;
+        }
+
+        var favorite = nextFavorites.splice(currentIndex, 1)[0];
+        var clampedIndex = Math.max(0, Math.min(targetIndex, nextFavorites.length));
+        nextFavorites.splice(clampedIndex, 0, favorite);
+        values.favorites = nextFavorites;
+    }
+
+    function retrySave(): void {
+        preferencesFile.writeAdapter();
+    }
+}

config/dot/quickshell/config/Migrations.qml

@@ -0,0 +1,121 @@
+pragma Singleton
+
+// Versioned upgrades for the settings file.
+//
+// The schema is the single source of truth for what a setting IS, but it cannot
+// describe what a setting USED to be. Renaming a key, changing its units, or
+// splitting one setting into two all leave a stored value that the new schema
+// does not recognise -- and an unrecognised key is silently carried through
+// untouched, so the user's choice simply stops taking effect with nothing to
+// say why. That is the failure this exists to prevent.
+//
+// HOW IT WORKS
+//
+// settings.json carries a schemaVersion. On load, every migration with a
+// version ABOVE the stored one runs in order, then the file is stamped with
+// `current`. A file with no schemaVersion at all is a file written before this
+// existed; it is stamped at `baseline` and NOT migrated, because those
+// migrations were never written for it.
+//
+// WRITING ONE
+//
+//   { version: 2, describe: "rename dockDelay to dockHideDelayMs",
+//     migrate: values => { ... return values; } }
+//
+// Rules that make this safe to run against a real user's file:
+//
+//   * migrate() receives the whole values object and returns it. Mutating and
+//     returning the same object is fine.
+//   * NEVER delete a key you are not replacing. Unknown keys are deliberately
+//     preserved so that rolling back to an older Panama does not discard a
+//     newer version's settings, and a migration is the one place that promise
+//     could quietly be broken.
+//   * A migration must tolerate its input being absent or the wrong type. It
+//     runs against files written by every previous version, including ones
+//     that were hand-edited.
+//   * Migrations never run twice: the stored version only moves forward.
+
+import QtQuick
+
+QtObject {
+    id: root
+
+    // What a file written today is stamped with. Bump this when adding a
+    // migration, to the version of the migration you added.
+    readonly property int current: 1
+
+    // Files predating versioning are stamped here without being migrated.
+    readonly property int baseline: 1
+
+    readonly property string versionKey: "schemaVersion"
+
+    // Ordered by version. Empty is the correct state until the first breaking
+    // schema change -- this exists so that change is a routine edit rather than
+    // an emergency.
+    readonly property var steps: []
+
+    function storedVersion(values: var): int {
+        const raw = values ? values[root.versionKey] : undefined;
+        return (typeof raw === "number" && isFinite(raw)) ? Math.floor(raw) : 0;
+    }
+
+    // Returns { values, migrated, changed, from, to, applied }.
+    //
+    // `applied` names each step that ran, so the caller can log something
+    // meaningful rather than "settings changed somehow". `changed` is the one
+    // the caller should write on: stamping a pre-versioning file changes it
+    // without running any step, and left unwritten the stamp would live only in
+    // memory and be redone on every launch.
+    function apply(values: var): var {
+        return root.applyWith(values, root.steps, root.current, root.baseline);
+    }
+
+    // The same logic with the step list injected, so the machinery can be
+    // tested against fixture migrations. The real list is empty until the first
+    // breaking schema change, and a mechanism that has never run against a
+    // failing step is not one to find out about during an upgrade.
+    function applyWith(values: var, steps: var, current: int, baseline: int): var {
+        const safe = (values && typeof values === "object") ? values : {};
+        const from = root.storedVersion(safe);
+
+        // No version: written before versioning existed. Stamp it and stop.
+        // Running the migration list against it would apply upgrades designed
+        // for schemas this file never had.
+        if (from === 0) {
+            safe[root.versionKey] = baseline;
+            return { values: safe, migrated: false, changed: true, from: 0, to: baseline, applied: [] };
+        }
+
+        // A file from a NEWER Panama. Left completely alone: downgrading its
+        // keys is not something this can do correctly, and unknown keys are
+        // already preserved, so the older build simply ignores what it does not
+        // understand.
+        if (from > current)
+            return { values: safe, migrated: false, changed: false, from: from, to: from, applied: [] };
+
+        const applied = [];
+        let working = safe;
+        for (const step of steps) {
+            if (step.version <= from || step.version > current)
+                continue;
+            try {
+                const result = step.migrate(working);
+                if (result && typeof result === "object")
+                    working = result;
+                applied.push(step.version + ": " + step.describe);
+            } catch (error) {
+                // One bad migration must not cost the user every setting. Stop
+                // at the last good version so the next launch retries from
+                // here rather than skipping the failed step forever.
+                console.warn("Migrations: step", step.version, "failed:", error);
+                working[root.versionKey] = step.version - 1;
+                return { values: working, migrated: applied.length > 0, changed: applied.length > 0,
+                         from: from, to: step.version - 1, applied: applied };
+            }
+        }
+
+        working[root.versionKey] = current;
+        return { values: working, migrated: applied.length > 0, changed: from !== current,
+                 from: from, to: current, applied: applied };
+    }
+}

config/dot/quickshell/config/Settings.qml

@@ -0,0 +1,87 @@
+pragma Singleton
+
+// ─────────────────────────────────────────────────────────────────────────────
+// User-facing knobs. Everything here is something you might reasonably want to
+// change without understanding the rest of the shell.
+//
+// Theme.qml holds *how it looks*; this holds *what it does*.
+// ─────────────────────────────────────────────────────────────────────────────
+
+import Quickshell
+import QtQuick
+
+Singleton {
+    id: root
+
+    // ── Clock ───────────────────────────────────────────────────────────────
+    // Carried over from GNOME: 12-hour, weekday + date shown, seconds on.
+    readonly property bool use24Hour: DesktopPreferences.get("use24Hour")
+    readonly property bool showSeconds: DesktopPreferences.get("showSeconds")
+    readonly property bool showWeekday: DesktopPreferences.get("showWeekday")
+
+    // ── Weather ─────────────────────────────────────────────────────────────
+    // Coordinates taken from the GNOME night-light setting, which had already
+    // resolved the location. Uses Open-Meteo, which needs no API key.
+    readonly property real latitude: DesktopPreferences.get("weatherLatitude")
+    readonly property real longitude: DesktopPreferences.get("weatherLongitude")
+    // Open-Meteo returns coordinates but no friendly place name. Keep the
+    // label deliberately general rather than exposing precise coordinates in
+    // the UI or guessing at a city from them.
+    readonly property string weatherLocation: DesktopPreferences.get("weatherLocation")
+    readonly property string temperatureUnit: DesktopPreferences.get("temperatureUnit")
+    readonly property int weatherRefreshMinutes: DesktopPreferences.get("weatherRefreshMinutes")
+
+    // ── Vitals ──────────────────────────────────────────────────────────────
+    // The GNOME Vitals extension showed processor usage, memory usage and GPU
+    // usage, in that order. Same here.
+    readonly property int vitalsIntervalMs: DesktopPreferences.get("vitalsIntervalMs")
+    readonly property bool showCpu: DesktopPreferences.get("showCpu")
+    readonly property bool showMemory: DesktopPreferences.get("showMemory")
+    readonly property bool showGpu: DesktopPreferences.get("showGpu")
+
+    // amdgpu exposes utilisation here. Verified present on this machine; the
+    // widget hides itself if the path is missing rather than showing zeros.
+    readonly property string gpuBusyPath: DesktopPreferences.get("gpuBusyPath")
+
+    // ── Night light ─────────────────────────────────────────────────────────
+    // Matches the (disabled) GNOME schedule: 3500K from 17:00 to 10:00.
+    readonly property int nightLightTemperature: DesktopPreferences.get("nightLightTemperature")
+    readonly property real nightLightFrom: DesktopPreferences.get("nightLightFrom")
+    readonly property real nightLightTo: DesktopPreferences.get("nightLightTo")
+    readonly property bool nightLightEnabledByDefault: DesktopPreferences.get("nightLightEnabled")
+
+    // ── Notifications ───────────────────────────────────────────────────────
+    readonly property int notificationTimeoutMs: DesktopPreferences.get("notificationTimeoutMs")
+    readonly property int notificationTimeoutCriticalMs: DesktopPreferences.get("notificationTimeoutCriticalMs") // 0 = never auto-expire
+    readonly property int notificationHistoryLimit: DesktopPreferences.get("notificationHistoryLimit")
+    readonly property int maxVisibleToasts: DesktopPreferences.get("maxVisibleToasts")
+
+    // ── Focus ──────────────────────────────────────────────────────────────
+    // One deliberate default rather than a preset picker: quick settings and
+    // the keyboard shortcut should start a useful session in one action.
+    readonly property int focusDurationMinutes: DesktopPreferences.get("focusDurationMinutes")
+
+    // ── Dock ────────────────────────────────────────────────────────────────
+    // Pinned apps, in order, taken from the GNOME dash favourites.
+    readonly property var dockPinned: DesktopPreferences.get("dockPinned")
+
+    // Dash-to-Dock was set to intellihide against all windows: the dock hides
+    // when any window would overlap it, and comes back on hover.
+    readonly property bool dockAutohide: DesktopPreferences.get("dockAutohide")
+
+    // 0: reveal the instant the pointer reaches the bottom edge. A reveal delay
+    // is indistinguishable from lag, because the user has already committed to
+    // the gesture by the time the strip is hit.
+    readonly property int dockRevealDelayMs: DesktopPreferences.get("dockRevealDelayMs")
+
+    // Hiding keeps a delay, so brushing past the bottom edge or crossing the
+    // gap between two icons doesn't make the dock flicker.
+    readonly property int dockHideDelayMs: DesktopPreferences.get("dockHideDelayMs")
+
+    // ── Capture ─────────────────────────────────────────────────────────────
+    readonly property string screenshotDir: DesktopPreferences.get("screenshotDir")
+    readonly property string recordingDir: DesktopPreferences.get("recordingDir")
+    // Passed to wf-recorder. Uses VAAPI on the AMD card so recording does not
+    // cost CPU while gaming.
+    readonly property string recorderArgs: DesktopPreferences.get("recorderArgs")
+}

config/dot/quickshell/config/Theme.qml

@@ -0,0 +1,173 @@
+pragma Singleton
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Tokyo Night Moon — the single source of truth for every colour, radius,
+// duration and font in the shell. Nothing below this file should hardcode a
+// colour; if you find yourself writing "#" outside this file, add a token here.
+//
+// The bar keeps GNOME's 36px information density but sits directly on the
+// desktop, edge to edge. The dock retains the former glass vocabulary: bottom,
+// 48px icons and dot indicators.
+// ─────────────────────────────────────────────────────────────────────────────
+
+import Quickshell
+// QtQuick is required even though nothing visual is declared here: `color` is a
+// QtQuick value type, and Qt.rgba() lives in its JS namespace.
+import QtQuick
+
+Singleton {
+    id: root
+
+    // ── Colour scheme ───────────────────────────────────────────────────────
+    // Tokyo Night ships an official light variant (Day), so light mode is that
+    // rather than a palette invented to merely not be dark. The two share the
+    // same hues at different lightness, which is what lets the Prism identity
+    // survive the switch: blue still leads into orchid, it is simply a darker
+    // blue on a lighter ground.
+    //
+    // Every token below is a binding on this, so flipping it repaints the whole
+    // shell without anything needing to know it happened.
+    readonly property bool dark: DesktopPreferences.get("colorScheme") !== "light"
+
+    // ── Palette ─────────────────────────────────────────────────────────────
+    // Canonical Tokyo Night Moon. `accent` matches the GNOME accent exactly.
+    readonly property color bg: root.dark ? "#222436" : "#e1e2e7"
+    readonly property color bgDark: root.dark ? "#1e2030" : "#d3d5de"
+    readonly property color bgHighlight: root.dark ? "#2f334d" : "#c4c8da"
+    readonly property color bgPanel: root.dark ? "#2e2f3d" : "#d9dae3" // dock glass surface
+    readonly property color bgPopover: root.dark ? "#21212f" : "#eaeaee" // Openbar submenu background
+
+    readonly property color fg: root.dark ? "#c8d3f5" : "#3760bf"
+    readonly property color fgDim: root.dark ? "#828bb8" : "#6172b0"
+    readonly property color fgMuted: root.dark ? "#636da6" : "#848cb5"
+    readonly property color gutter: root.dark ? "#3b4261" : "#a8aecb"
+
+    // The pair. `accent` is the primary and carries every state meaning
+    // (focused, active, on). `accentSecondary` is the orchid from the tmux
+    // theme — it never appears alone, only as the far end of a gradient. That
+    // restraint is the whole point: the two colours meeting is the signature,
+    // so the pink stops being special the moment it's used as a flat fill.
+    readonly property color accent: root.dark ? "#82aaff" : "#2e7de9" // blue
+    readonly property color accentSecondary: root.dark ? "#b172b0" : "#9854f1" // orchid, from tmux
+    readonly property color accentAlt: root.dark ? "#65bcff" : "#007197" // blue1, a lighter blue
+    readonly property color cyan: root.dark ? "#86e1fc" : "#007197"
+    readonly property color teal: root.dark ? "#4fd6be" : "#118c74"
+    readonly property color green: root.dark ? "#c3e88d" : "#587539"
+    readonly property color yellow: root.dark ? "#ffc777" : "#8c6c3e"
+    readonly property color orange: root.dark ? "#ff966c" : "#b15c00"
+    readonly property color red: root.dark ? "#ff757f" : "#f52a65"
+    readonly property color redDeep: root.dark ? "#c53b53" : "#c64343"
+    readonly property color magenta: root.dark ? "#c099ff" : "#9854f1"
+    readonly property color pink: root.dark ? "#fca7ea" : "#d20065"
+
+    // Semantic aliases — prefer these in widgets so intent survives a repaint.
+    readonly property color ok: green
+    readonly property color warn: yellow
+    readonly property color danger: red
+    readonly property color urgent: orange
+
+    // ── Surface alphas ──────────────────────────────────────────────────────
+    // The dock sits on compositor blur, so its fill is deliberately very
+    // translucent. Popovers are near-opaque because they carry text that must
+    // stay legible. The bar itself has no surface or alpha token.
+    // Light surfaces need more opacity for the same sense of a solid panel: the
+    // same 0.34 that reads as glass over a dark desktop reads as haze over a
+    // light one, and text on it stops being legible.
+    readonly property real dockAlpha: root.dark ? 0.34 : 0.62
+    readonly property real popoverAlpha: root.dark ? 0.92 : 0.97
+    readonly property real overlayAlpha: root.dark ? 0.55 : 0.40
+    readonly property real hoverAlpha: root.dark ? 0.14 : 0.10
+    readonly property real activeAlpha: root.dark ? 0.24 : 0.18
+
+    // ── Geometry ────────────────────────────────────────────────────────────
+    readonly property int barHeight: 36
+    readonly property int barGap: 6 // breathing room below the bar for popovers
+    readonly property int barSideMargin: 10 // inset for floating popovers
+
+    readonly property int dockIconSize: 48
+    readonly property int dockPadding: 8
+    readonly property int dockGap: 8
+    readonly property int dockRadius: 20
+
+    readonly property int popoverRadius: 18
+    readonly property int popoverPadding: 14
+    readonly property int popoverWidth: 380
+    readonly property int controlCenterWidth: 430
+    readonly property int controlCenterTopGap: 2
+
+    readonly property int cardRadius: 12
+    readonly property int pillRadius: 999
+    readonly property int itemSpacing: 8
+    readonly property int sectionSpacing: 14
+
+    // ── Type ────────────────────────────────────────────────────────────────
+    // Adwaita Sans for everything the user reads as text. No exceptions: a
+    // monospaced clock or percentage reads as a terminal readout pasted into a
+    // UI, which is the opposite of the intent here.
+    readonly property string fontFamily: DesktopPreferences.get("interfaceFont")
+
+    // Nerd Font, used ONLY to draw icon glyphs — never for text. It is the
+    // pragmatic alternative to freedesktop symbolic icons, which ship with a
+    // hardcoded dark fill Qt will not recolour (see widgets/ThemedIcon.qml).
+    readonly property string fontMono: DesktopPreferences.get("iconFont")
+
+    // Apply to any text whose digits change in place — clocks, percentages,
+    // elapsed timers, dimension readouts. Tabular figures all share one
+    // advance width, so the text stops twitching as the numbers tick without
+    // needing a monospaced face.
+    //
+    //   font.family: Theme.fontFamily
+    //   font.features: Theme.tabularFigures
+    readonly property var tabularFigures: ({
+            "tnum": 1
+        })
+    // The four sizes are a scale, not four independent numbers: they move
+    // together so the relationship between body, caption, heading and title
+    // survives a change to the base rather than drifting apart.
+    readonly property int fontSize: DesktopPreferences.get("interfaceFontSize")
+    readonly property int fontSizeSmall: Math.max(9, root.fontSize - 2)
+    readonly property int fontSizeLarge: root.fontSize + 3
+    readonly property int fontSizeTitle: root.fontSize + 7
+
+    // ── Motion ──────────────────────────────────────────────────────────────
+    // Event-driven only. Nothing in this shell animates while idle — no pulse,
+    // no shimmer, no spinners. These durations are used for open/close/hover.
+    readonly property int durFast: 120
+    readonly property int durNormal: 200
+    readonly property int durSlow: 320
+
+    // The dock revealing is the one animation that answers a live pointer
+    // movement, so it gets its own (much shorter) duration. Anything slower
+    // reads as the desktop lagging behind the cursor rather than as motion.
+    readonly property int durDockReveal: 90
+
+    // Matches the "snappy" spring curve defined in hypr/looks.lua.
+    readonly property list<real> easeStandard: [0.05, 0.9, 0.1, 1.0]
+    readonly property list<real> easeOvershoot: [0.34, 1.56, 0.64, 1.0]
+
+    // ── Helpers ─────────────────────────────────────────────────────────────
+    // Qt.alpha() does not exist; this is the idiomatic way to re-alpha a token.
+    function alpha(c: color, a: real): color {
+        return Qt.rgba(c.r, c.g, c.b, a);
+    }
+
+    // Blend two tokens — used for hover/pressed states so we never invent a
+    // colour that isn't derived from the palette.
+    function mix(a: color, b: color, ratio: real): color {
+        return Qt.rgba(a.r + (b.r - a.r) * ratio, a.g + (b.g - a.g) * ratio, a.b + (b.b - a.b) * ratio, a.a + (b.a - a.a) * ratio);
+    }
+
+    // ── The prism ───────────────────────────────────────────────────────────
+    // Where the two accents meet. Used for the hairline along the top edge of
+    // every glass surface (widgets/PrismEdge.qml), the focused window border,
+    // the active workspace pill and slider fills.
+    //
+    // Where the gradient runs left-to-right the blue leads, because the eye
+    // reads left first and blue is the colour that carries meaning.
+    readonly property real prismStart: 0.22
+    readonly property real prismEnd: 0.78
+
+    // Opacity of the hairline itself. Deliberately below 1: at full strength it
+    // reads as a drawn line rather than as light catching an edge.
+    readonly property real prismEdgeAlpha: 0.85
+}

config/dot/quickshell/config/qmldir

@@ -0,0 +1,7 @@
+module qs.config
+singleton DesktopPreferences 1.0 DesktopPreferences.qml
+singleton PreferenceSchema 1.0 PreferenceSchema.qml
+singleton HomePreferences 1.0 HomePreferences.qml
+singleton Settings 1.0 Settings.qml
+singleton Theme 1.0 Theme.qml
+singleton Migrations 1.0 Migrations.qml

config/dot/quickshell/connectivity-harness.qml

@@ -0,0 +1,28 @@
+import Quickshell
+import Quickshell.Io
+import QtQuick
+
+import qs.services
+
+ShellRoot {
+    IpcHandler {
+        target: "connectivity-test"
+
+        function status(): string {
+            return JSON.stringify({
+                wifiDevice: Connectivity.wifiDevice ? Connectivity.wifiDevice.name : "",
+                wiredDevice: Connectivity.wiredDevice ? Connectivity.wiredDevice.name : "",
+                wiredConnected: !!(Connectivity.wiredDevice && Connectivity.wiredDevice.connected),
+                networks: Connectivity.networks.length,
+                activeSsid: Connectivity.activeNetwork ? Connectivity.activeNetwork.name : "",
+                activeStrength: Connectivity.activeNetwork ? Connectivity.activeNetwork.signalStrength : -1,
+                activeLabel: Connectivity.activeNetwork ? Connectivity.signalLabel(Connectivity.activeNetwork.signalStrength) : "",
+                adapter: Connectivity.adapter ? true : false,
+                btDevices: Connectivity.bluetoothDevices.length
+            });
+        }
+
+        function labelFor(strength: real): string { return Connectivity.signalLabel(strength); }
+        function setActive(on: bool): void { Connectivity.active = on; }
+    }
+}

config/dot/quickshell/display-arrangement-harness.qml

@@ -0,0 +1,81 @@
+import Quickshell
+import Quickshell.Io
+import QtQuick
+
+import qs.modules.settings
+import qs.services
+
+ShellRoot {
+    DisplayIdentify {}
+
+    QtObject {
+        id: fixtureService
+
+        property var monitors: [
+            {
+                name: "DP-2", description: "Primary display", width: 4500, height: 3000,
+                refreshRate: 60, mode: "[email protected]", scale: 1.5,
+                transform: 0, x: 0, y: 0, primary: true
+            },
+            {
+                name: "HDMI-A-1", description: "Second display", width: 2560, height: 1440,
+                refreshRate: 60, mode: "[email protected]", scale: 1,
+                transform: 0, x: 3000, y: 0, primary: false
+            }
+        ]
+        property var applied: []
+
+        function currentLayout(): var {
+            return monitors.map(record => Object.assign({}, record));
+        }
+
+        function applyLayout(layout: var): bool {
+            applied = layout.map(record => Object.assign({}, record));
+            return true;
+        }
+    }
+
+    DisplayArrangement {
+        id: arrangement
+        width: 800
+        displayService: fixtureService
+        selectedOutput: "HDMI-A-1"
+    }
+
+    IpcHandler {
+        target: "display-arrangement-test"
+
+        function status(width: int): string {
+            arrangement.width = width;
+            arrangement.resetDraft();
+            return JSON.stringify(arrangement.canvasSnapshot());
+        }
+
+        function dragFixture(): string {
+            arrangement.resetDraft();
+            arrangement.setDraftPosition("HDMI-A-1", 3016, 0, true);
+            arrangement.applyDraft();
+            return JSON.stringify(fixtureService.applied);
+        }
+
+        function keyboardFixture(): string {
+            arrangement.resetDraft();
+            arrangement.nudge("HDMI-A-1", -10, 0);
+            const afterArrow = arrangement.draftLayout.find(record => record.name === "HDMI-A-1").x;
+            arrangement.nudge("HDMI-A-1", -100, 0);
+            const afterShiftArrow = arrangement.draftLayout.find(record => record.name === "HDMI-A-1").x;
+            return JSON.stringify({ afterArrow, afterShiftArrow });
+        }
+
+        function primaryFixture(): string {
+            arrangement.resetDraft();
+            arrangement.makePrimary("HDMI-A-1");
+            return JSON.stringify(fixtureService.applied.map(record => ({
+                name: record.name, x: record.x, y: record.y, primary: record.primary
+            })));
+        }
+
+        function identify(): void { Displays.identify(); }
+        function identifying(): bool { return Displays.identifying; }
+    }
+}

config/dot/quickshell/display-layout-harness.qml

@@ -0,0 +1,50 @@
+import Quickshell
+import Quickshell.Io
+import QtQuick
+
+import "services/DisplayLayout.js" as DisplayLayout
+
+ShellRoot {
+    readonly property var fixture: [
+        { name: "DP-2", width: 4500, height: 3000, scale: 1.5, transform: 0, x: 140, y: 80, primary: true },
+        { name: "HDMI-A-1", width: 2560, height: 1440, scale: 1, transform: 1, x: 3140, y: 80, primary: false }
+    ]
+
+    IpcHandler {
+        target: "display-layout-test"
+
+        function status(): string {
+            const normalized = DisplayLayout.normalize(fixture);
+            const canvas = DisplayLayout.canvasRects(normalized, 800, 500, 20);
+            const near = normalized.map(record => Object.assign({}, record));
+            near[1].x = 3016;
+            const far = normalized.map(record => Object.assign({}, record));
+            far[1].x = 3017;
+            return JSON.stringify({
+                valid: DisplayLayout.validate(fixture),
+                sizes: fixture.map(DisplayLayout.logicalSize),
+                normalized: normalized.map(record => ({ name: record.name, x: record.x, y: record.y, primary: record.primary })),
+                bounds: canvas.bounds,
+                canvasScale: canvas.scale,
+                canvasRects: canvas.rects,
+                near: DisplayLayout.snap(near, "HDMI-A-1", 16).find(record => record.name === "HDMI-A-1").x,
+                far: DisplayLayout.snap(far, "HDMI-A-1", 16).find(record => record.name === "HDMI-A-1").x
+            });
+        }
+
+        function invalid(): string {
+            const base = fixture.map(record => Object.assign({}, record));
+            const cases = [];
+            const add = layout => cases.push(DisplayLayout.validate(layout));
+            add([base[0], Object.assign({}, base[1], { name: "DP-2" })]);
+            add(base.map(record => Object.assign({}, record, { primary: false })));
+            add(base.map(record => Object.assign({}, record, { primary: true })));
+            add([Object.assign({}, base[0], { x: 0.5 }), base[1]]);
+            add([Object.assign({}, base[0], { scale: 0 }), base[1]]);
+            add([Object.assign({}, base[0], { transform: 4 }), base[1]]);
+            add([Object.assign({}, base[0], { width: Infinity }), base[1]]);
+            add([Object.assign({}, base[0], { width: 0 }), base[1]]);
+            return JSON.stringify(cases);
+        }
+    }
+}

config/dot/quickshell/displays-harness.qml

@@ -0,0 +1,145 @@
+import Quickshell
+import Quickshell.Io
+import QtQuick
+
+import qs.config
+import qs.services
+
+ShellRoot {
+    IpcHandler {
+        target: "displays-test"
+
+        function status(): string {
+            const monitor = Displays.monitors.length > 0 ? Displays.monitors[0] : null;
+            return JSON.stringify({
+                count: Displays.monitors.length,
+                name: monitor ? monitor.name : "",
+                width: monitor ? monitor.width : 0,
+                height: monitor ? monitor.height : 0,
+                refresh: monitor ? monitor.refreshRate : 0,
+                mode: monitor ? monitor.mode : "",
+                scale: monitor ? monitor.scale : 0,
+                transform: monitor ? monitor.transform : -1,
+                x: monitor ? monitor.x : 0,
+                y: monitor ? monitor.y : 0,
+                primary: monitor ? monitor.primary : false,
+                modes: monitor ? monitor.modes.length : 0,
+                awaiting: Displays.awaitingConfirmation,
+                canConfirm: Displays.canConfirm,
+                secondsLeft: Displays.secondsLeft,
+                lastError: Displays.lastError,
+                overridden: monitor ? Displays.isOverridden(monitor.name) : false
+            });
+        }
+
+        function applyScale(scale: real): bool {
+            const monitor = Displays.monitors[0];
+            if (!monitor) return false;
+            const mode = monitor.mode;
+            return Displays.apply(monitor.name, mode, scale, monitor.transform);
+        }
+
+        function transactionStatus(): string {
+            return JSON.stringify({
+                layout: Displays.currentLayout(),
+                pending: Displays.pendingRequestedLayout,
+                previous: Displays.pendingPreviousLayout,
+                reverting: Displays.revertExpectedLayout,
+                awaiting: Displays.awaitingConfirmation,
+                canConfirm: Displays.canConfirm,
+                busy: Displays.busy,
+                generation: Displays.operationGeneration,
+                revertGeneration: Displays.revertGeneration,
+                lastError: Displays.lastError
+            });
+        }
+
+        function applyLayoutFixture(secondX: int, secondY: int): bool {
+            const layout = Displays.currentLayout();
+            if (layout.length !== 2) return false;
+            layout[0].x = 0;
+            layout[0].y = 0;
+            layout[0].primary = true;
+            layout[1].x = secondX;
+            layout[1].y = secondY;
+            layout[1].primary = false;
+            return Displays.applyLayout(layout);
+        }
+
+        function makePrimaryFixture(output: string): bool {
+            return Displays.makePrimary(output);
+        }
+
+        function injectReadback(text: string, generation: int): void {
+            Displays.parse(text, generation);
+        }
+
+        function expireApplyVerification(): void {
+            Displays.verificationTimedOut();
+        }
+
+        function expireRevertVerification(): void {
+            Displays.revertVerificationTimedOut();
+        }
+
+        function refreshIdentityFixture(): string {
+            const modes = Displays.normaliseModes([
+                "[email protected]",
+                "[email protected]"
+            ]);
+            const monitor = { width: 1920, height: 1080, refreshRate: 59.94 };
+            return JSON.stringify({
+                count: modes.length,
+                modes: modes.map(mode => mode.mode),
+                selected: modes.filter(mode => Displays.modeIsCurrent(monitor, mode)).map(mode => mode.mode)
+            });
+        }
+
+        function positionFixture(): string {
+            const previous = Displays.monitors;
+            Displays.parse(JSON.stringify([
+                {
+                    name: "DP-2", description: "Primary", width: 4500, height: 3000,
+                    refreshRate: 60, scale: 1.5, transform: 0, x: 140, y: 80,
+                    availableModes: ["[email protected]"]
+                },
+                {
+                    name: "HDMI-A-1", description: "Second", width: 2560, height: 1440,
+                    refreshRate: 60, scale: 1, transform: 0, x: 3140, y: 80,
+                    availableModes: ["[email protected]"]
+                }
+            ]), Displays.operationGeneration);
+            const result = JSON.stringify(Displays.monitors.map(monitor => ({
+                name: monitor.name,
+                x: monitor.x,
+                y: monitor.y,
+                primary: monitor.primary
+            })));
+            Displays.monitors = previous;
+            return result;
+        }
+
+        function applyBad(kind: string): bool {
+            const monitor = Displays.monitors[0];
+            if (!monitor) return false;
+            const mode = monitor.mode;
+            if (kind === "mode") return Displays.apply(monitor.name, "9999x9999@240", monitor.scale, monitor.transform);
+            if (kind === "scale") return Displays.apply(monitor.name, mode, 1.37, monitor.transform);
+            if (kind === "dirtyScale") {
+                const dirty = Displays.scales.find(scale => !Displays.isScaleClean(mode, scale));
+                return dirty === undefined ? false : Displays.apply(monitor.name, mode, dirty, monitor.transform);
+            }
+            if (kind === "transform") return Displays.apply(monitor.name, mode, monitor.scale, 9);
+            if (kind === "output") return Displays.apply("NOPE-1", mode, monitor.scale, monitor.transform);
+            return false;
+        }
+
+        function confirmChange(): bool { return Displays.confirm(); }
+        function revertChange(): void { Displays.revert(); }
+        function forget(): void {
+            const monitor = Displays.monitors[0];
+            if (monitor) Displays.forget(monitor.name);
+        }
+        function refresh(): void { Displays.refresh(); }
+    }
+}

config/dot/quickshell/dock-pin-harness.qml

@@ -0,0 +1,35 @@
+import Quickshell
+import Quickshell.Io
+import QtQuick
+import qs.config
+
+ShellRoot {
+    // DesktopEntries populates asynchronously. Reading `applications.values`
+    // here rather than calling byId() blind is the documented way to wait for
+    // it -- and is exactly the trap noted in modules/settings/README.md.
+    readonly property var ids: {
+        const out = {};
+        for (const entry of DesktopEntries.applications.values)
+            out[entry.id] = entry;
+        return out;
+    }
+
+    IpcHandler {
+        target: "dock-pin-test"
+
+        function count(): int { return DesktopEntries.applications.values.length; }
+
+        function resolve(): string {
+            const pinned = DesktopPreferences.get("dockPinned");
+            const missing = [];
+            let first = null;
+            for (const id of pinned) {
+                const entry = DesktopEntries.byId(id);
+                if (!entry) missing.push(id);
+                if (first === null)
+                    first = { id: id, found: !!entry, name: entry ? entry.name : "", icon: entry ? entry.icon : "" };
+            }
+            return JSON.stringify({ total: pinned.length, first: first, missing: missing });
+        }
+    }
+}

config/dot/quickshell/health-harness.qml

@@ -0,0 +1,23 @@
+import Quickshell
+import Quickshell.Io
+import QtQuick
+
+import qs.services
+
+ShellRoot {
+    // The production singleton still performs its delayed startup scan. The
+    // harness turns it off before its 2200 ms deadline so each fixture drives
+    // only the state transition it is asserting.
+    Component.onCompleted: Health.startupScanEnabled = false
+
+    IpcHandler {
+        target: "health-test"
+
+        function accept(text: string, generation: int): bool { return Health.consumeSnapshot(text, generation); }
+        function queue(): void { Health.refresh(); Health.refresh(); }
+        function status(): string { return JSON.stringify(Health.diagnostics()); }
+        function repair(id: string): bool { return Health.repair(id, false); }
+        function report(): string { return JSON.stringify(Health.snapshot, null, 2); }
+        function copy(): bool { return Health.copyReport(); }
+    }
+}

config/dot/quickshell/home-brightness-slider-harness.qml

@@ -0,0 +1,54 @@
+import Quickshell
+import Quickshell.Io
+import QtQuick
+
+import qs.modules.quicksettings
+
+ShellRoot {
+    id: root
+
+    property int confirmedValue: 30
+    property int commitCount: 0
+    property int lastCommit: -1
+
+    HomeBrightnessSlider {
+        id: slider
+        width: 200
+        value: root.confirmedValue
+        accessibleName: "Desk lamp brightness"
+        onCommitted: value => {
+            root.commitCount += 1;
+            root.lastCommit = value;
+        }
+    }
+
+    IpcHandler {
+        target: "home-brightness-slider-test"
+
+        function reset(value: int): void {
+            root.confirmedValue = value;
+            root.commitCount = 0;
+            root.lastCommit = -1;
+            slider.cancelPointerInteraction();
+        }
+        function external(value: int): void { root.confirmedValue = value; }
+        function press(position: int): void { slider.beginPointerInteraction(position); }
+        function move(position: int): void { slider.movePointerInteraction(position); }
+        function release(): void { slider.releasePointerInteraction(); }
+        function cancel(): void { slider.cancelPointerInteraction(); }
+        function wheel(delta: int): void { slider.commitWheel(delta); }
+        function status(): string {
+            return JSON.stringify({
+                confirmedValue: root.confirmedValue,
+                previewValue: slider.previewValue,
+                interactionActive: slider.interactionActive,
+                commitCount: root.commitCount,
+                lastCommit: root.lastCommit,
+                accessibleRoleIsSlider: slider.Accessible.role === Accessible.Slider,
+                accessibleName: slider.Accessible.name,
+                accessibleDescription: slider.Accessible.description,
+                accessibleFocusable: slider.Accessible.focusable
+            });
+        }
+    }
+}

config/dot/quickshell/home-preferences-harness.qml

@@ -0,0 +1,26 @@
+import Quickshell
+import Quickshell.Io
+import QtQuick
+
+import qs.config
+
+ShellRoot {
+    IpcHandler {
+        target: "home-pref-test"
+
+        function initialize(idsJson: string): void { HomePreferences.initialize(JSON.parse(idsJson)); }
+        function add(id: string): void { HomePreferences.add(id); }
+        function alias(id: string, value: string): void { HomePreferences.setAlias(id, value); }
+        function move(id: string, index: int): void { HomePreferences.move(id, index); }
+        function remove(id: string): void { HomePreferences.remove(id); }
+        function reset(): void { HomePreferences.resetHomeDefaults(); }
+        function status(): string {
+            return JSON.stringify({
+                initialized: HomePreferences.initialized,
+                favorites: HomePreferences.favorites,
+                saveError: HomePreferences.saveError,
+                stateDir: Quickshell.stateDir
+            });
+        }
+    }
+}

config/dot/quickshell/keybinds-harness.qml

@@ -0,0 +1,58 @@
+import Quickshell
+import Quickshell.Io
+import QtQuick
+
+import qs.config
+import qs.services
+
+ShellRoot {
+    IpcHandler {
+        target: "keybinds-test"
+
+        function rebind(current: string, next: string): bool {
+            return Keybinds.rebind(current, next);
+        }
+
+        function resetBind(current: string): bool { return Keybinds.resetBind(current); }
+        function resetAll(): void { Keybinds.resetAll(); }
+
+        function seedResetCollision(shipped: string, current: string, occupantShipped: string): void {
+            const overrides = {};
+            overrides[shipped] = current;
+            overrides[occupantShipped] = shipped;
+            DesktopPreferences.set("keybindOverrides", overrides);
+        }
+
+        function chordFor(description: string): string {
+            const found = Keybinds.binds.find(bind => bind.description === description);
+            return found ? found.luaChord : "";
+        }
+
+        function overrideState(): string {
+            return JSON.stringify({
+                overrides: Keybinds.overrides,
+                count: Object.keys(Keybinds.overrides).length,
+                lastError: Keybinds.lastError
+            });
+        }
+
+        function status(): string {
+            const grouped = Keybinds.grouped();
+            let groupedCount = 0;
+            for (const group of grouped)
+                groupedCount += group.binds.length;
+
+            const superT = Keybinds.binds.find(bind => bind.description === "Terminal");
+
+            return JSON.stringify({
+                loaded: Keybinds.loaded,
+                count: Keybinds.binds.length,
+                groupedCount: groupedCount,
+                groups: grouped.map(group => group.name),
+                sample: superT ? superT.chord : "",
+                emptyDescriptions: Keybinds.binds.filter(bind => !bind.description).length,
+                lastError: Keybinds.lastError
+            });
+        }
+    }
+}

config/dot/quickshell/lock-screen-harness.qml

@@ -0,0 +1,32 @@
+import Quickshell
+import Quickshell.Io
+import QtQuick
+
+import qs.config
+import qs.services
+
+ShellRoot {
+    IpcHandler {
+        target: "lock-screen-test"
+
+        function status(): string {
+            return JSON.stringify({
+                generated: LockScreen.generated,
+                path: LockScreen.path,
+                fallback: LockScreen.fallback,
+                lastError: LockScreen.lastError,
+                busy: LockScreen.busy
+            });
+        }
+
+        function burst(): void {
+            DesktopPreferences.set("lockBlurLevel", 1);
+            DesktopPreferences.set("lockBlurLevel", 2);
+            DesktopPreferences.set("lockBlurLevel", 4);
+        }
+
+        function refresh(): void {
+            LockScreen.refresh();
+        }
+    }
+}

config/dot/quickshell/lock-screen-settings-harness.qml

@@ -0,0 +1,83 @@
+import Quickshell
+import Quickshell.Io
+import QtQuick
+
+import qs.modules.settings
+
+ShellRoot {
+    id: root
+
+    readonly property string fixtureWallpaper: `${Quickshell.env("HOME")}/Pictures/Wallpapers/faroe_islands.jpg`
+
+    LockScreenPreview {
+        id: screenshotPreview
+        width: 620
+        backgroundMode: "screenshot"
+        blurLevel: 4
+        showClock: true
+        showDate: true
+        showUser: true
+        fadeOnEmpty: false
+        wallpaperPath: root.fixtureWallpaper
+    }
+
+    LockScreenPreview {
+        id: wallpaperPreview
+        width: 620
+        backgroundMode: "wallpaper"
+        blurLevel: 2
+        showClock: false
+        showDate: true
+        showUser: false
+        fadeOnEmpty: true
+        wallpaperPath: root.fixtureWallpaper
+    }
+
+    LockScreenPreview {
+        id: solidPreview
+        width: 620
+        backgroundMode: "solid"
+        blurLevel: 0
+        showClock: true
+        showDate: false
+        showUser: true
+        fadeOnEmpty: false
+        wallpaperPath: root.fixtureWallpaper
+    }
+
+    IpcHandler {
+        target: "lock-screen-settings-test"
+
+        function status(): string {
+            return JSON.stringify({
+                screenshot: {
+                    mode: screenshotPreview.previewMode,
+                    wallpaperVisible: screenshotPreview.wallpaperVisible,
+                    blurStrength: screenshotPreview.blurStrength,
+                    clockVisible: screenshotPreview.clockVisible,
+                    dateVisible: screenshotPreview.dateVisible,
+                    userVisible: screenshotPreview.userVisible,
+                    passwordVisible: screenshotPreview.passwordVisible
+                },
+                wallpaper: {
+                    mode: wallpaperPreview.previewMode,
+                    wallpaperVisible: wallpaperPreview.wallpaperVisible,
+                    blurStrength: wallpaperPreview.blurStrength,
+                    clockVisible: wallpaperPreview.clockVisible,
+                    dateVisible: wallpaperPreview.dateVisible,
+                    userVisible: wallpaperPreview.userVisible,
+                    passwordVisible: wallpaperPreview.passwordVisible
+                },
+                solid: {
+                    mode: solidPreview.previewMode,
+                    wallpaperVisible: solidPreview.wallpaperVisible,
+                    blurStrength: solidPreview.blurStrength,
+                    clockVisible: solidPreview.clockVisible,
+                    dateVisible: solidPreview.dateVisible,
+                    userVisible: solidPreview.userVisible,
+                    passwordVisible: solidPreview.passwordVisible
+                }
+            });
+        }
+    }
+}

config/dot/quickshell/migrations-harness.qml

@@ -0,0 +1,56 @@
+// Exercises Migrations.applyWith against fixture steps and prints a verdict per
+// case. Run by tests/quickshell/migrations-contract.sh.
+//
+// Fixture steps rather than the real list: the real one is empty until the
+// first breaking schema change, and a mechanism that has never been run against
+// a failing step is not one to discover the behaviour of during an upgrade.
+
+import Quickshell
+import QtQuick
+import qs.config
+
+ShellRoot {
+    Component.onCompleted: {
+        const steps = [
+            { version: 2, describe: "add b", migrate: v => { v.b = (v.a ?? 0) + 1; return v; } },
+            { version: 3, describe: "add c", migrate: v => { v.c = "three"; return v; } },
+            { version: 4, describe: "explode", migrate: v => { throw new Error("boom"); } }
+        ];
+        const results = {};
+
+        // No version at all: a file written before versioning. Stamped, never
+        // migrated.
+        let r = Migrations.applyWith({ a: 1 }, steps, 3, 1);
+        results.unversioned = { v: r.values.schemaVersion, migrated: r.migrated,
+                                changed: r.changed, untouched: r.values.b === undefined };
+
+        // Older file: every step above its version runs, in order.
+        r = Migrations.applyWith({ a: 1, schemaVersion: 1 }, steps, 3, 1);
+        results.upgrade = { v: r.values.schemaVersion, b: r.values.b, c: r.values.c,
+                            count: r.applied.length, migrated: r.migrated };
+
+        // Already current: nothing runs.
+        r = Migrations.applyWith({ schemaVersion: 3, keep: "me" }, steps, 3, 1);
+        results.current = { v: r.values.schemaVersion, migrated: r.migrated,
+                            kept: r.values.keep === "me", b: r.values.b === undefined };
+
+        // From the future: left completely alone, including its unknown keys.
+        r = Migrations.applyWith({ schemaVersion: 9, futureKey: "x" }, steps, 3, 1);
+        results.future = { v: r.values.schemaVersion, migrated: r.migrated,
+                           changed: r.changed, kept: r.values.futureKey === "x" };
+
+        // A failing step stops at the last good version rather than losing the
+        // file or skipping past the failure forever.
+        r = Migrations.applyWith({ schemaVersion: 1, a: 5 }, steps, 4, 1);
+        results.failure = { v: r.values.schemaVersion, b: r.values.b, c: r.values.c,
+                            kept: r.values.a === 5, count: r.applied.length };
+
+        // Unknown keys survive a migration: rolling back to an older Panama
+        // must not discard a newer version's settings.
+        r = Migrations.applyWith({ schemaVersion: 1, unknownFromFuture: true }, steps, 3, 1);
+        results.preserved = { kept: r.values.unknownFromFuture === true };
+
+        console.info("PANAMA-MIGRATIONS " + JSON.stringify(results));
+        Qt.callLater(() => Qt.quit());
+    }
+}

config/dot/quickshell/modules/bar/ActivityIndicator.qml

@@ -0,0 +1,45 @@
+// Persistent, bar-native privacy state. Signal Glass handles transitions; this
+// remains until the underlying capture activity actually ends.
+
+import QtQuick
+import qs.config
+import qs.services
+import qs.widgets
+
+Pill {
+    id: root
+
+    visible: PrivacyState.anyActive
+    horizontalPadding: 8
+    onActivated: ShellState.toggle("activity")
+
+    // Right-click opens the settings that govern this widget. Camera, microphone and screen-sharing state is a privacy readout.
+    onSecondaryActivated: ShellState.openSettings("privacy")
+
+    Text {
+        anchors.verticalCenter: parent.verticalCenter
+        text: {
+            if (PrivacyState.recordingActive)
+                return "\u{F044A}";
+            if (PrivacyState.screenSharingActive)
+                return "\u{F0379}";
+            if (PrivacyState.cameraActive)
+                return "\u{F0100}";
+            return "\u{F036C}";
+        }
+        color: PrivacyState.recordingActive ? Theme.danger : Theme.warn
+        font.family: Theme.fontMono
+        font.pixelSize: 14
+    }
+
+    Text {
+        anchors.verticalCenter: parent.verticalCenter
+        visible: PrivacyState.activeKinds.length > 1
+        text: String(PrivacyState.activeKinds.length)
+        color: Theme.fg
+        font.family: Theme.fontFamily
+        font.features: Theme.tabularFigures
+        font.pixelSize: Theme.fontSizeSmall
+        font.weight: Font.DemiBold
+    }
+}

config/dot/quickshell/modules/bar/ActivityPanel.qml

@@ -0,0 +1,218 @@
+// Compact explanation and control surface for persistent privacy indicators.
+
+import Quickshell
+import Quickshell.Hyprland
+import Quickshell.Wayland
+import QtQuick
+import qs.config
+import qs.services
+import qs.widgets
+
+PanelWindow {
+    id: root
+
+    visible: ShellState.activityOpen && PrivacyState.anyActive
+    color: "transparent"
+    anchors.top: true
+    anchors.right: true
+    margins.top: Theme.barHeight + Theme.barGap * 2
+    margins.right: Theme.barSideMargin
+    exclusiveZone: 0
+    implicitWidth: 350
+    implicitHeight: surface.implicitHeight
+
+    WlrLayershell.namespace: "qs-popover-activity"
+    WlrLayershell.layer: WlrLayer.Overlay
+    WlrLayershell.keyboardFocus: WlrKeyboardFocus.None
+
+    readonly property var activities: {
+        const result = [];
+        if (PrivacyState.recordingActive)
+            result.push({ kind: "recording", glyph: "\u{F044A}", label: "Screen recording", detail: "Panama · " + root.elapsed(), tone: "danger", stoppable: true });
+        if (PrivacyState.screenSharingActive)
+            result.push({ kind: "screen", glyph: "\u{F0379}", label: "Screen sharing", detail: PrivacyState.screenSharingApp || "Managed by the application", tone: "warn", stoppable: false });
+        if (PrivacyState.cameraActive)
+            result.push({ kind: "camera", glyph: "\u{F0100}", label: "Camera", detail: PrivacyState.cameraApp || "Managed by the application", tone: "warn", stoppable: false });
+        if (PrivacyState.microphoneActive)
+            result.push({ kind: "microphone", glyph: "\u{F036C}", label: "Microphone", detail: PrivacyState.microphoneApp || "Managed by the application", tone: "warn", stoppable: false });
+        return result;
+    }
+
+    function elapsed(): string {
+        const total = Capture.recordingSeconds;
+        const seconds = String(total % 60).padStart(2, "0");
+        const minutes = Math.floor(total / 60) % 60;
+        const hours = Math.floor(total / 3600);
+        return hours > 0 ? `${hours}:${String(minutes).padStart(2, "0")}:${seconds}` : `${minutes}:${seconds}`;
+    }
+
+    onVisibleChanged: {
+        if (root.visible)
+            openAnimation.restart();
+    }
+
+    Connections {
+        target: PrivacyState
+        function onAnyActiveChanged(): void {
+            if (!PrivacyState.anyActive && ShellState.activityOpen)
+                ShellState.close();
+        }
+    }
+
+    HyprlandFocusGrab {
+        windows: [root]
+        active: root.visible
+        onCleared: ShellState.close()
+    }
+
+    Rectangle {
+        id: surface
+        implicitHeight: content.implicitHeight + Theme.popoverPadding * 2
+        anchors.left: parent.left
+        anchors.right: parent.right
+        radius: Theme.popoverRadius
+        color: Theme.alpha(Theme.bgPopover, Theme.popoverAlpha)
+        border.width: 1
+        border.color: Theme.alpha(Theme.fg, 0.08)
+
+        PrismEdge {
+            anchors.top: parent.top
+            anchors.topMargin: 1
+            anchors.left: parent.left
+            anchors.right: parent.right
+            inset: parent.radius
+        }
+
+        transform: Scale {
+            id: openScale
+            origin.x: surface.width
+            origin.y: 0
+            xScale: 1
+            yScale: 1
+        }
+
+        Column {
+            id: content
+            anchors.left: parent.left
+            anchors.right: parent.right
+            anchors.margins: Theme.popoverPadding
+            spacing: 8
+
+            Text {
+                width: parent.width
+                text: "Privacy & activity"
+                color: Theme.fg
+                font.family: Theme.fontFamily
+                font.pixelSize: Theme.fontSizeLarge
+                font.weight: Font.DemiBold
+            }
+
+            Text {
+                width: parent.width
+                text: "Active access stays visible until it ends."
+                color: Theme.fgDim
+                font.family: Theme.fontFamily
+                font.pixelSize: Theme.fontSizeSmall
+            }
+
+            Rectangle {
+                width: parent.width
+                height: 1
+                color: Theme.alpha(Theme.fg, 0.08)
+            }
+
+            Repeater {
+                model: root.activities
+
+                Rectangle {
+                    id: activityRow
+                    required property var modelData
+                    width: content.width
+                    height: 50
+                    radius: Theme.cardRadius
+                    border.width: 0
+                    color: Theme.alpha(Theme.fg, 0.045)
+
+                    Text {
+                        id: activityIcon
+                        anchors.left: parent.left
+                        anchors.leftMargin: 12
+                        anchors.verticalCenter: parent.verticalCenter
+                        text: activityRow.modelData.glyph
+                        color: activityRow.modelData.tone === "danger" ? Theme.danger : Theme.warn
+                        font.family: Theme.fontMono
+                        font.pixelSize: 17
+                    }
+
+                    Column {
+                        anchors.left: activityIcon.right
+                        anchors.leftMargin: 11
+                        anchors.right: stopButton.visible ? stopButton.left : parent.right
+                        anchors.rightMargin: 12
+                        anchors.verticalCenter: parent.verticalCenter
+                        spacing: 2
+
+                        Text {
+                            width: parent.width
+                            text: activityRow.modelData.label
+                            color: Theme.fg
+                            elide: Text.ElideRight
+                            font.family: Theme.fontFamily
+                            font.pixelSize: Theme.fontSize
+                            font.weight: Font.DemiBold
+                        }
+
+                        Text {
+                            width: parent.width
+                            text: activityRow.modelData.detail
+                            color: Theme.fgDim
+                            elide: Text.ElideRight
+                            font.family: Theme.fontFamily
+                            font.pixelSize: Theme.fontSizeSmall
+                        }
+                    }
+
+                    Rectangle {
+                        id: stopButton
+                        anchors.right: parent.right
+                        anchors.rightMargin: 8
+                        anchors.verticalCenter: parent.verticalCenter
+                        visible: activityRow.modelData.stoppable
+                        width: 54
+                        height: 28
+                        radius: Theme.pillRadius
+                        border.width: 0
+                        color: stopMouse.containsMouse ? Theme.alpha(Theme.danger, 0.26) : Theme.alpha(Theme.danger, 0.15)
+
+                        Text {
+                            anchors.centerIn: parent
+                            text: "Stop"
+                            color: Theme.danger
+                            font.family: Theme.fontFamily
+                            font.pixelSize: Theme.fontSizeSmall
+                            font.weight: Font.DemiBold
+                        }
+
+                        MouseArea {
+                            id: stopMouse
+                            anchors.fill: parent
+                            hoverEnabled: true
+                            cursorShape: Qt.PointingHandCursor
+                            onClicked: Capture.stopRecording()
+                        }
+                    }
+                }
+            }
+        }
+    }
+
+    NumberAnimation {
+        id: openAnimation
+        target: openScale
+        property: "yScale"
+        from: 0.96
+        to: 1
+        duration: Theme.durNormal
+        easing.type: Easing.OutCubic
+    }
+}

config/dot/quickshell/modules/bar/Bar.qml

@@ -0,0 +1,142 @@
+// The top bar: edge-to-edge system chrome with no surface of its own. Content
+// floats directly over the desktop, while individual controls still provide
+// hover and press feedback. The entire bar is a hit target so the top-left
+// corner remains a dependable workspace-scroll gesture.
+//
+// Instantiate one per screen:
+//
+//   Variants {
+//       model: Quickshell.screens
+//       Bar {}
+//   }
+//
+// Layout mirrors GNOME's: workspaces + vitals left, clock + weather centre,
+// media + tray + status cluster right.
+
+import Quickshell
+import Quickshell.Wayland
+import QtQuick
+import qs.config
+import qs.modules.clipboard
+import qs.modules.focus
+
+PanelWindow {
+    id: root
+
+    // Set by Variants. Left as a plain property (not `required`) so the bar can
+    // also be instantiated standalone on the default screen while testing.
+    property var modelData: null
+
+    // Raised when the status cluster is clicked; the shell wires this to the
+    // quick settings panel, which this module does not own.
+    signal requestQuickSettings
+
+    // Bound by the shell when an idle inhibitor is held, so the cluster can
+    // show the caffeine glyph.
+    property alias idleInhibited: statusCluster.idleInhibited
+
+    screen: root.modelData
+
+    anchors {
+        top: true
+        left: true
+        right: true
+    }
+
+    // PanelWindow defaults to an opaque white background.
+    color: "transparent"
+
+    implicitHeight: Theme.barHeight
+
+    exclusiveZone: Theme.barHeight
+
+    // Stable namespace for compositor inspection and shell diagnostics.
+    WlrLayershell.namespace: "qs-bar"
+    WlrLayershell.layer: WlrLayer.Top
+    WlrLayershell.keyboardFocus: WlrKeyboardFocus.None
+
+    // The full-width region is intentional: unlike a floating island, a menu
+    // bar owns the screen edge. In particular, Workspaces starts at x=0 and
+    // spans the full height so scrolling at the literal corner always works.
+    mask: Region {
+        item: barContent
+    }
+
+    Item {
+        id: barContent
+
+        anchors.fill: parent
+
+        // ── Left ────────────────────────────────────────────────────────────
+            Row {
+            anchors.left: parent.left
+            anchors.verticalCenter: parent.verticalCenter
+            spacing: Theme.itemSpacing
+
+            Workspaces {
+                anchors.verticalCenter: parent.verticalCenter
+                screen: root.screen
+            }
+
+            VitalsWidget {
+                anchors.verticalCenter: parent.verticalCenter
+            }
+        }
+
+        // ── Centre ──────────────────────────────────────────────────────────
+        Row {
+            anchors.horizontalCenter: parent.horizontalCenter
+            anchors.verticalCenter: parent.verticalCenter
+            spacing: 2
+
+            Clock {
+                anchors.verticalCenter: parent.verticalCenter
+            }
+
+            WeatherWidget {
+                anchors.verticalCenter: parent.verticalCenter
+            }
+        }
+
+        // ── Right ───────────────────────────────────────────────────────────
+        Row {
+            anchors.right: parent.right
+            anchors.verticalCenter: parent.verticalCenter
+            spacing: Theme.itemSpacing
+
+            CalendarIndicator {
+                anchors.verticalCenter: parent.verticalCenter
+            }
+
+            HealthIndicator {
+                anchors.verticalCenter: parent.verticalCenter
+            }
+
+            ActivityIndicator {
+                anchors.verticalCenter: parent.verticalCenter
+            }
+
+            FocusIndicator {
+                anchors.verticalCenter: parent.verticalCenter
+            }
+
+            MediaWidget {
+                anchors.verticalCenter: parent.verticalCenter
+            }
+
+            ClipboardWidget {
+                anchors.verticalCenter: parent.verticalCenter
+            }
+
+            Tray {
+                anchors.verticalCenter: parent.verticalCenter
+            }
+
+            StatusCluster {
+                id: statusCluster
+                anchors.verticalCenter: parent.verticalCenter
+                onRequestQuickSettings: root.requestQuickSettings()
+            }
+        }
+    }
+}

config/dot/quickshell/modules/bar/CalendarArrow.qml

@@ -0,0 +1,41 @@
+// Month-stepping arrow in CalendarPopup's header. Round hover target, sized
+// like GNOME's calendar arrows rather than a bare glyph.
+
+import QtQuick
+import qs.config
+
+Rectangle {
+    id: root
+
+    signal activated
+
+    required property string glyph
+
+    width: 24
+    height: 24
+    radius: width / 2
+    border.width: 0
+    color: mouse.containsMouse ? Theme.alpha(Theme.fg, Theme.hoverAlpha) : "transparent"
+
+    Behavior on color {
+        ColorAnimation {
+            duration: Theme.durFast
+        }
+    }
+
+    Text {
+        anchors.centerIn: parent
+        text: root.glyph
+        font.family: Theme.fontMono
+        font.pixelSize: Theme.fontSize
+        color: Theme.fgDim
+    }
+
+    MouseArea {
+        id: mouse
+        anchors.fill: parent
+        hoverEnabled: true
+        cursorShape: Qt.PointingHandCursor
+        onClicked: root.activated()
+    }
+}

config/dot/quickshell/modules/bar/CalendarIndicator.qml

@@ -0,0 +1,56 @@
+// A deliberately quiet appointment reminder. It only enters the bar during
+// the narrow window where an upcoming event is immediately useful.
+
+import QtQuick
+import QtQuick.Controls
+import qs.config
+import qs.services
+import qs.widgets
+
+Pill {
+    id: root
+
+    visible: CalendarAgenda.capsuleVisible
+    opacity: visible ? 1 : 0
+    horizontalPadding: 8
+    onActivated: ShellState.openDateMenu("agenda")
+
+    // Right-click opens the settings that govern this widget. The same place the clock leads, since this is the calendar's own reminder.
+    onSecondaryActivated: ShellState.openSettings("datetime")
+
+    ToolTip.visible: root.hovered && root.visible
+    ToolTip.delay: 500
+    ToolTip.text: CalendarAgenda.nextEvent?.summary ?? "Upcoming event"
+
+    Behavior on opacity {
+        NumberAnimation {
+            duration: 120
+            easing.type: Easing.OutCubic
+        }
+    }
+
+    Behavior on implicitWidth {
+        NumberAnimation {
+            duration: 120
+            easing.type: Easing.OutCubic
+        }
+    }
+
+    Text {
+        anchors.verticalCenter: parent.verticalCenter
+        text: "\u{F00ED}"
+        color: Theme.accent
+        font.family: Theme.fontMono
+        font.pixelSize: 13
+    }
+
+    Text {
+        anchors.verticalCenter: parent.verticalCenter
+        text: CalendarAgenda.capsuleText
+        color: Theme.fg
+        font.family: Theme.fontFamily
+        font.features: Theme.tabularFigures
+        font.pixelSize: Theme.fontSizeSmall
+        font.weight: Font.DemiBold
+    }
+}

config/dot/quickshell/modules/bar/CalendarPopup.qml

@@ -0,0 +1,222 @@
+// The calendar that drops out of the clock — GNOME's date menu, minus the
+// notification list (that lives in its own panel). Month grid, today marked
+// with the accent, arrows to page through months, current weather at the foot.
+
+import Quickshell
+import QtQuick
+import qs.config
+import qs.services
+import qs.widgets
+
+Popover {
+    id: root
+
+    // Popover's container is a plain Item, which does not derive an implicit
+    // size from its children, so the window has to be sized from the body.
+    implicitWidth: body.implicitWidth + contentPadding * 2
+    implicitHeight: body.implicitHeight + contentPadding * 2
+
+    readonly property int cellSize: 34
+    readonly property int cellHeight: 30
+
+    // Hours precision is enough: the only thing that has to change on its own
+    // is which cell counts as "today", and that only moves at midnight.
+    SystemClock {
+        id: clock
+        precision: SystemClock.Hours
+    }
+
+    readonly property int todayYear: clock.date.getFullYear()
+    readonly property int todayMonth: clock.date.getMonth()
+    readonly property int todayDay: clock.date.getDate()
+
+    // The month currently on screen. Reset to today every time the popover
+    // opens, so it never comes back showing wherever you paged off to.
+    property int viewYear: root.todayYear
+    property int viewMonth: root.todayMonth
+
+    onVisibleChanged: if (visible)
+        root.showToday()
+
+    function showToday(): void {
+        root.viewYear = root.todayYear;
+        root.viewMonth = root.todayMonth;
+    }
+
+    function stepMonth(delta: int): void {
+        const d = new Date(root.viewYear, root.viewMonth + delta, 1);
+        root.viewYear = d.getFullYear();
+        root.viewMonth = d.getMonth();
+    }
+
+    // Six weeks of cells, so the grid height never changes as you page through
+    // months. Days from the neighbouring months fill the edges, dimmed.
+    readonly property var cells: {
+        const first = new Date(root.viewYear, root.viewMonth, 1);
+        const offset = first.getDay(); // 0 = Sunday, matching the header row
+        const inThisMonth = new Date(root.viewYear, root.viewMonth + 1, 0).getDate();
+        const inPrevMonth = new Date(root.viewYear, root.viewMonth, 0).getDate();
+
+        const out = [];
+        for (let i = 0; i < 42; i++) {
+            const n = i - offset + 1;
+            if (n < 1)
+                out.push({
+                    day: inPrevMonth + n,
+                    current: false
+                });
+            else if (n > inThisMonth)
+                out.push({
+                    day: n - inThisMonth,
+                    current: false
+                });
+            else
+                out.push({
+                    day: n,
+                    current: true
+                });
+        }
+        return out;
+    }
+
+    Column {
+        id: body
+        spacing: Theme.itemSpacing
+
+        // ── Month header ────────────────────────────────────────────────────
+        Item {
+            width: root.cellSize * 7
+            height: 28
+
+            CalendarArrow {
+                anchors.left: parent.left
+                anchors.verticalCenter: parent.verticalCenter
+                glyph: "\u{F0141}"   // md-chevron_left
+                onActivated: root.stepMonth(-1)
+            }
+
+            Text {
+                anchors.centerIn: parent
+                text: Qt.formatDateTime(new Date(root.viewYear, root.viewMonth, 1), "MMMM yyyy")
+                font.family: Theme.fontFamily
+                font.pixelSize: Theme.fontSizeLarge
+                font.weight: Font.DemiBold
+                color: Theme.fg
+
+                MouseArea {
+                    anchors.fill: parent
+                    cursorShape: Qt.PointingHandCursor
+                    onClicked: root.showToday()
+                }
+            }
+
+            CalendarArrow {
+                anchors.right: parent.right
+                anchors.verticalCenter: parent.verticalCenter
+                glyph: "\u{F0142}"   // md-chevron_right
+                onActivated: root.stepMonth(1)
+            }
+        }
+
+        // ── Weekday header ──────────────────────────────────────────────────
+        Row {
+            Repeater {
+                model: ["S", "M", "T", "W", "T", "F", "S"]
+
+                delegate: Text {
+                    required property string modelData
+
+                    width: root.cellSize
+                    height: 20
+                    text: modelData
+                    horizontalAlignment: Text.AlignHCenter
+                    verticalAlignment: Text.AlignVCenter
+                    font.family: Theme.fontFamily
+                    font.pixelSize: Theme.fontSizeSmall
+                    color: Theme.fgMuted
+                }
+            }
+        }
+
+        // ── Day grid ────────────────────────────────────────────────────────
+        Grid {
+            columns: 7
+
+            Repeater {
+                model: root.cells
+
+                delegate: Item {
+                    id: cell
+
+                    required property var modelData
+
+                    readonly property bool isToday: cell.modelData.current && cell.modelData.day === root.todayDay && root.viewMonth === root.todayMonth && root.viewYear === root.todayYear
+
+                    width: root.cellSize
+                    height: root.cellHeight
+
+                    Rectangle {
+                        anchors.centerIn: parent
+                        width: root.cellHeight - 2
+                        height: root.cellHeight - 2
+                        radius: width / 2
+                        border.width: 0
+                        visible: cell.isToday
+                        color: Theme.accent
+                    }
+
+                    Text {
+                        anchors.centerIn: parent
+                        text: cell.modelData.day
+                        font.family: Theme.fontFamily
+                        font.pixelSize: Theme.fontSize
+                        font.weight: cell.isToday ? Font.DemiBold : Font.Normal
+
+                        color: {
+                            if (cell.isToday)
+                                return Theme.bgDark;
+                            return cell.modelData.current ? Theme.fg : Theme.fgMuted;
+                        }
+                    }
+                }
+            }
+        }
+
+        // ── Weather ─────────────────────────────────────────────────────────
+        Rectangle {
+            width: root.cellSize * 7
+            height: 1
+            color: Theme.alpha(Theme.fg, 0.1)
+            visible: Weather.available
+        }
+
+        Row {
+            spacing: Theme.itemSpacing
+            visible: Weather.available
+
+            Text {
+                anchors.verticalCenter: parent.verticalCenter
+                text: Weather.icon
+                font.family: Theme.fontMono
+                font.pixelSize: Theme.fontSizeTitle
+                color: Theme.accentAlt
+            }
+
+            Column {
+                Text {
+                    text: Math.round(Weather.temperature) + Weather.unitSuffix
+                    font.family: Theme.fontFamily
+                    font.pixelSize: Theme.fontSize
+                    color: Theme.fg
+                }
+
+                Text {
+                    text: Weather.description
+                    font.family: Theme.fontFamily
+                    font.pixelSize: Theme.fontSizeSmall
+                    color: Theme.fgDim
+                }
+            }
+        }
+    }
+}

config/dot/quickshell/modules/bar/Clock.qml

@@ -0,0 +1,45 @@
+// The centre clock, kept in the same place and the same format GNOME had it:
+// weekday, date, 12-hour time with seconds. Clicking it opens the calendar,
+// exactly like GNOME's date menu.
+
+import Quickshell
+import QtQuick
+import qs.config
+import qs.services
+import qs.widgets
+
+Pill {
+    id: root
+
+    // Seconds are only ticked when they are actually shown — a per-second wake
+    // for a clock that displays minutes would be pure waste.
+    SystemClock {
+        id: clock
+        precision: Settings.showSeconds ? SystemClock.Seconds : SystemClock.Minutes
+    }
+
+    readonly property string format: {
+        const date = Settings.showWeekday ? "ddd MMM d  " : "MMM d  ";
+        const time = Settings.use24Hour ? (Settings.showSeconds ? "HH:mm:ss" : "HH:mm") : (Settings.showSeconds ? "h:mm:ss AP" : "h:mm AP");
+        return date + time;
+    }
+
+    onActivated: ShellState.toggleDateMenu("agenda")
+
+    // Right-click opens the settings that govern this widget. Timezone and clock format live on Date & Time. The
+    // format toggles are mirrored on Appearance, but someone right-clicking a
+    // clock is far more often after the time itself than its typography.
+    onSecondaryActivated: ShellState.openSettings("datetime")
+
+    Text {
+        anchors.verticalCenter: parent.verticalCenter
+        text: Qt.formatDateTime(clock.date, root.format)
+        font.family: Theme.fontFamily
+        // Seconds tick once a second in the centre of the bar; without tabular
+        // figures the whole clock shifts sideways on every digit change.
+        font.features: Theme.tabularFigures
+        font.pixelSize: Theme.fontSize
+        color: Theme.fg
+    }
+
+}

config/dot/quickshell/modules/bar/HealthIndicator.qml

@@ -0,0 +1,89 @@
+// A deliberately absent-until-needed health affordance. Healthy and merely
+// unconfigured systems leave no ornament or layout residue in the bar.
+
+import QtQuick
+import QtQuick.Controls
+import qs.config
+import qs.services
+
+Rectangle {
+    id: root
+
+    signal activated
+
+    readonly property int issueCount: Health.summary.warnings + Health.summary.errors
+    readonly property color tone: Health.status === "error"
+        ? Theme.danger
+        : (Health.status === "warning" ? Theme.warn : "transparent")
+    readonly property string statusText: root.issueCount === 1
+        ? "1 system health issue"
+        : root.issueCount + " system health issues"
+    readonly property string accessibleLabel: Health.status === "error"
+        ? "System Health: " + root.issueCount + (root.issueCount === 1 ? " issue requires action" : " issues require action")
+        : "System Health: " + root.issueCount + (root.issueCount === 1 ? " issue needs attention" : " issues need attention")
+    readonly property string tooltipText: root.accessibleLabel
+
+    visible: Health.actionable
+    implicitWidth: visible ? content.implicitWidth + 16 : 0
+    implicitHeight: visible ? 24 : 0
+    width: implicitWidth
+    height: implicitHeight
+    radius: 9
+    color: visible ? Theme.alpha(root.tone, 0.09) : "transparent"
+    border.width: activeFocus ? 2 : 1
+    border.color: visible ? Theme.alpha(root.tone, activeFocus ? 0.72 : 0.20) : "transparent"
+
+    activeFocusOnTab: visible
+    Accessible.role: Accessible.Button
+    Accessible.name: root.accessibleLabel
+    Accessible.description: "Open System Health"
+    Accessible.onPressAction: root.activated()
+
+    onActivated: {
+        ShellState.openSettings("services");
+        Health.refresh();
+    }
+
+    Keys.onReturnPressed: root.activated()
+    Keys.onEnterPressed: root.activated()
+    Keys.onSpacePressed: root.activated()
+
+    Row {
+        id: content
+
+        anchors.centerIn: parent
+        spacing: 6
+
+        Text {
+            anchors.verticalCenter: parent.verticalCenter
+            text: "\u{F0ECD}" // md-shield-alert-outline
+            color: root.tone
+            font.family: Theme.fontMono
+            font.pixelSize: 14
+        }
+
+        Text {
+            anchors.verticalCenter: parent.verticalCenter
+            text: String(root.issueCount)
+            color: root.tone
+            font.family: Theme.fontFamily
+            font.features: Theme.tabularFigures
+            font.pixelSize: Theme.fontSizeSmall
+            font.weight: Font.DemiBold
+        }
+    }
+
+    MouseArea {
+        id: pointer
+
+        anchors.fill: parent
+        enabled: root.visible
+        hoverEnabled: true
+        cursorShape: Qt.PointingHandCursor
+        onClicked: root.activated()
+    }
+
+    ToolTip.visible: pointer.containsMouse && root.visible
+    ToolTip.delay: 500
+    ToolTip.text: root.tooltipText
+}

config/dot/quickshell/modules/bar/MediaWidget.qml

@@ -0,0 +1,73 @@
+// Now-playing readout. Click toggles play/pause, scroll skips tracks.
+//
+// "Nothing playing" means no MPRIS player is exposing a track at all — a
+// paused player still shows, because otherwise there would be nothing left on
+// the bar to press play on.
+
+import QtQuick
+import Quickshell.Services.Mpris
+import qs.config
+import qs.services
+import qs.widgets
+
+Pill {
+    id: root
+
+    // Prefer whatever is actually playing; fall back to the first player that
+    // has a track loaded so a paused session stays reachable. The model's
+    // insertion behavior is covered by the live-player verification.
+    readonly property MprisPlayer player: {
+        const players = Mpris.players ? Mpris.players.values : [];
+        return players.find(p => p.isPlaying) ?? players.find(p => p.trackTitle) ?? null;
+    }
+
+    readonly property string label: {
+        if (!root.player)
+            return "";
+        const title = root.player.trackTitle ?? "";
+        const artist = root.player.trackArtist ?? "";
+        return artist ? artist + " — " + title : title;
+    }
+
+    visible: root.player !== null
+    horizontalPadding: 8
+
+    onActivated: if (root.player?.canTogglePlaying)
+        root.player.togglePlaying()
+
+    // Right-click opens the settings that govern this widget. Output device and per-application volume.
+    onSecondaryActivated: ShellState.openSettings("sound")
+
+    // Scroll up = previous, down = next — the same direction as the workspace
+    // switcher, so the whole bar scrolls consistently.
+    onScrolled: delta => {
+        if (!root.player)
+            return;
+        if (delta > 0 && root.player.canGoPrevious)
+            root.player.previous();
+        else if (delta < 0 && root.player.canGoNext)
+            root.player.next();
+    }
+
+    Text {
+        anchors.verticalCenter: parent.verticalCenter
+        // Shows the action the click will perform, not the current state.
+        text: root.player?.isPlaying ? "\u{F04C}" : "\u{F04B}"   // fa-pause / fa-play
+        font.family: Theme.fontMono
+        font.pixelSize: Theme.fontSizeSmall
+        color: Theme.accent
+    }
+
+    Text {
+        anchors.verticalCenter: parent.verticalCenter
+        text: root.label
+        font.family: Theme.fontFamily
+        font.pixelSize: Theme.fontSize
+        color: Theme.fg
+
+        // Titles are unbounded; the bar is not. Elide rather than let one
+        // podcast episode push the tray off the edge.
+        elide: Text.ElideRight
+        width: Math.min(implicitWidth, 200)
+    }
+}

config/dot/quickshell/modules/bar/StatusCluster.qml

@@ -0,0 +1,119 @@
+// GNOME's system menu button: a small run of status glyphs — network, volume,
+// bluetooth, caffeine — that opens the quick settings panel when clicked.
+//
+// This widget only *reports* state. The quick settings panel itself lives
+// elsewhere; clicking here just raises `requestQuickSettings`.
+
+import Quickshell
+import Quickshell.Bluetooth
+import Quickshell.Networking
+import Quickshell.Services.Pipewire
+import QtQuick
+import qs.config
+import qs.services
+import qs.widgets
+
+Pill {
+    id: root
+
+    signal requestQuickSettings
+
+    // Set by the shell when an idle inhibitor is held. Lives outside this
+    // widget because the inhibitor itself is owned by the quick settings side.
+    property bool idleInhibited: false
+
+    onActivated: root.requestQuickSettings()
+
+    // Right-click opens the settings that govern this widget. Network and Bluetooth, which is most of what these glyphs report.
+    onSecondaryActivated: ShellState.openSettings("connectivity")
+
+    // ── Audio ───────────────────────────────────────────────────────────────
+    // Without a tracker, volume and muted silently read as zero/false.
+    PwObjectTracker {
+        objects: [Pipewire.defaultAudioSink]
+    }
+
+    // defaultAudioSink is transiently null while pipewire settles.
+    readonly property real volume: Pipewire.defaultAudioSink?.audio?.volume ?? 0
+    readonly property bool muted: Pipewire.defaultAudioSink?.audio?.muted ?? false
+
+    // ── Network ─────────────────────────────────────────────────────────────
+    readonly property var devices: Networking.devices ? Networking.devices.values : []
+
+    readonly property var wiredDevice: root.devices.find(d => d.type === DeviceType.Wired && d.connected) ?? null
+    readonly property var wifiDevice: root.devices.find(d => d.type === DeviceType.Wifi) ?? null
+
+    readonly property var wifiNetwork: {
+        const networks = root.wifiDevice?.networks ? root.wifiDevice.networks.values : [];
+        return networks.find(n => n.connected) ?? null;
+    }
+
+    // ── Bluetooth ───────────────────────────────────────────────────────────
+    readonly property bool bluetoothOn: Bluetooth.defaultAdapter?.enabled ?? false
+    readonly property bool bluetoothConnected: {
+        const devices = Bluetooth.devices ? Bluetooth.devices.values : [];
+        return devices.some(d => d.connected);
+    }
+
+    StatusGlyph {
+        glyph: {
+            if (root.wiredDevice)
+                return "\u{F0200}";              // md-ethernet
+            if (!root.wifiNetwork)
+                return "\u{F092D}";              // md-wifi_strength_off
+
+            // NetworkManager reports strength 0-100; some backends normalise to
+            // 0-1, so accept either rather than showing one bar forever.
+            const raw = root.wifiNetwork.signalStrength ?? 0;
+            const strength = raw <= 1 ? raw * 100 : raw;
+            if (strength >= 75)
+                return "\u{F0928}";              // md-wifi_strength_4
+            if (strength >= 50)
+                return "\u{F0925}";              // md-wifi_strength_3
+            if (strength >= 25)
+                return "\u{F0922}";              // md-wifi_strength_2
+            return "\u{F091F}";                  // md-wifi_strength_1
+        }
+
+        color: {
+            if (root.wiredDevice)
+                return Theme.fg;
+            if (!root.wifiNetwork)
+                return Theme.fgMuted;
+            return Networking.connectivity === NetworkConnectivity.Full ? Theme.fg : Theme.warn;
+        }
+    }
+
+    StatusGlyph {
+        glyph: {
+            if (root.muted || root.volume <= 0)
+                return "\u{F075F}";              // md-volume_mute
+            if (root.volume < 0.34)
+                return "\u{F057F}";              // md-volume_low
+            if (root.volume < 0.67)
+                return "\u{F0580}";              // md-volume_medium
+            return "\u{F057E}";                  // md-volume_high
+        }
+        color: root.muted ? Theme.fgMuted : Theme.fg
+    }
+
+    StatusGlyph {
+        // Bluetooth off is the resting state on this machine, so the glyph is
+        // simply absent rather than shown crossed out.
+        visible: root.bluetoothOn
+        glyph: root.bluetoothConnected ? "\u{F00B1}" : "\u{F00AF}"   // md-bluetooth_connect / md-bluetooth
+        color: root.bluetoothConnected ? Theme.accent : Theme.fg
+    }
+
+    StatusGlyph {
+        visible: root.idleInhibited
+        glyph: "\u{F0176}"                       // md-coffee
+        color: Theme.warn
+    }
+
+    StatusGlyph {
+        visible: KdeConnect.phoneReachable
+        glyph: "\u{F03F2}"                       // md-cellphone-link
+        color: Theme.cyan
+    }
+}

config/dot/quickshell/modules/bar/StatusGlyph.qml

@@ -0,0 +1,26 @@
+// A single status icon in StatusCluster. Fixed width so the cluster doesn't
+// shuffle sideways every time a glyph swaps for a wider one.
+
+import QtQuick
+import qs.config
+
+Text {
+    id: root
+
+    required property string glyph
+
+    anchors.verticalCenter: parent?.verticalCenter ?? undefined
+
+    text: root.glyph
+    font.family: Theme.fontMono
+    font.pixelSize: Theme.fontSizeLarge
+    horizontalAlignment: Text.AlignHCenter
+    width: 18
+    color: Theme.fg
+
+    Behavior on color {
+        ColorAnimation {
+            duration: Theme.durFast
+        }
+    }
+}

config/dot/quickshell/modules/bar/Tray.qml

@@ -0,0 +1,84 @@
+// System tray (StatusNotifierItem / AppIndicator).
+//
+// GNOME removed this and never replaced it; Nextcloud, RustDesk and Slack all
+// still expect it, so it is a first-class part of this bar. Left click
+// activates, right click opens the item's own menu — rendered in QML by
+// TrayMenu so it matches the rest of the shell instead of dropping a GTK menu
+// on top of it.
+
+import Quickshell
+import Quickshell.Services.SystemTray
+import Quickshell.Widgets
+import QtQuick
+import qs.config
+
+Row {
+    id: root
+
+    spacing: 2
+
+    Repeater {
+        model: SystemTray.items
+
+        delegate: Item {
+            id: entry
+
+            required property SystemTrayItem modelData
+
+            implicitWidth: 26
+            implicitHeight: Theme.barHeight - 8
+
+            Rectangle {
+                anchors.fill: parent
+                radius: Theme.pillRadius
+                border.width: 0
+                color: mouse.containsMouse ? Theme.alpha(Theme.fg, Theme.hoverAlpha) : "transparent"
+
+                Behavior on color {
+                    ColorAnimation {
+                        duration: Theme.durFast
+                    }
+                }
+            }
+
+            IconImage {
+                anchors.centerIn: parent
+                implicitSize: 16
+                asynchronous: true
+                mipmap: true
+                // `icon` is already a resolved URL — running it through
+                // Quickshell.iconPath() would break it.
+                source: entry.modelData.icon
+            }
+
+            MouseArea {
+                id: mouse
+                anchors.fill: parent
+                hoverEnabled: true
+                acceptedButtons: Qt.LeftButton | Qt.MiddleButton | Qt.RightButton
+                cursorShape: Qt.PointingHandCursor
+
+                onClicked: event => {
+                    // onlyMenu items have no activate action at all, so a left
+                    // click has to fall through to the menu or nothing happens.
+                    if (event.button === Qt.RightButton || entry.modelData.onlyMenu) {
+                        if (entry.modelData.hasMenu)
+                            menu.visible = !menu.visible;
+                    } else if (event.button === Qt.MiddleButton) {
+                        entry.modelData.secondaryActivate();
+                    } else {
+                        entry.modelData.activate();
+                    }
+                }
+
+                onWheel: event => entry.modelData.scroll(event.angleDelta.y, false)
+            }
+
+            TrayMenu {
+                id: menu
+                anchorItem: entry
+                trayItem: entry.modelData
+            }
+        }
+    }
+}

config/dot/quickshell/modules/bar/TrayMenu.qml

@@ -0,0 +1,101 @@
+// A tray item's DBus menu, drawn natively so it inherits the shell's theme.
+//
+// Submenus drill down in place rather than flying out sideways — a popover with
+// a back row, the way GNOME's menus behave, and far less fiddly than chasing a
+// cascade of popup windows with the mouse.
+
+import Quickshell
+import Quickshell.Services.SystemTray
+import QtQuick
+import qs.config
+import qs.widgets
+
+Popover {
+    id: root
+
+    required property SystemTrayItem trayItem
+
+    // Popover's container is a plain Item and does not size itself from its
+    // children, so the window dimensions come from the column's implicit size.
+    // Rows take their *actual* width from the window in the other direction —
+    // the two chains are independent, so there is no binding loop.
+    implicitWidth: Math.max(body.implicitWidth + contentPadding * 2, 200)
+    implicitHeight: body.implicitHeight + contentPadding * 2
+
+    // Stack of submenu handles; empty means we are at the top level.
+    property var menuStack: []
+
+    onVisibleChanged: if (!visible)
+        root.menuStack = []
+
+    QsMenuOpener {
+        id: opener
+        menu: root.menuStack.length > 0 ? root.menuStack[root.menuStack.length - 1] : root.trayItem.menu
+    }
+
+    Column {
+        id: body
+        width: parent.width
+        spacing: 2
+
+        // Back row, only while inside a submenu.
+        TrayMenuRow {
+            width: parent.width
+            visible: root.menuStack.length > 0
+            label: "\u{F0141}  Back"   // md-chevron_left
+            onActivated: root.menuStack = root.menuStack.slice(0, -1)
+        }
+
+        Repeater {
+            model: opener.children
+
+            delegate: Loader {
+                id: entryLoader
+
+                required property var modelData
+
+                width: body.width
+                sourceComponent: entryLoader.modelData.isSeparator ? separator : row
+
+                Component {
+                    id: separator
+
+                    Item {
+                        implicitHeight: 7
+
+                        Rectangle {
+                            anchors.verticalCenter: parent.verticalCenter
+                            width: parent.width
+                            height: 1
+                            color: Theme.alpha(Theme.fg, 0.1)
+                        }
+                    }
+                }
+
+                Component {
+                    id: row
+
+                    TrayMenuRow {
+                        // QsMenuEntry calls it `text`, not `label`.
+                        label: entryLoader.modelData.text
+                        icon: entryLoader.modelData.icon
+                        rowEnabled: entryLoader.modelData.enabled
+                        buttonType: entryLoader.modelData.buttonType
+                        checkState: entryLoader.modelData.checkState
+                        submenu: entryLoader.modelData.hasChildren
+
+                        onActivated: {
+                            if (entryLoader.modelData.hasChildren) {
+                                root.menuStack = root.menuStack.concat([entryLoader.modelData]);
+                                return;
+                            }
+
+                            entryLoader.modelData.triggered();
+                            root.visible = false;
+                        }
+                    }
+                }
+            }
+        }
+    }
+}

config/dot/quickshell/modules/bar/TrayMenuRow.qml

@@ -0,0 +1,85 @@
+// One row of a TrayMenu: optional icon, label, and either a check/radio mark
+// or a submenu chevron on the right.
+
+import Quickshell.Widgets
+import QtQuick
+import qs.config
+
+Rectangle {
+    id: root
+
+    signal activated
+
+    property string label: ""
+    property string icon: ""
+    // Named `rowEnabled` rather than `enabled`: overriding Item.enabled would
+    // also disable the MouseArea, and we still want the row to swallow clicks
+    // rather than let them fall through to whatever is behind the popover.
+    property bool rowEnabled: true
+    property int buttonType: 0   // QsMenuButtonType: 0 None, 1 CheckBox, 2 RadioButton
+    property int checkState: Qt.Unchecked
+    property bool submenu: false
+
+    implicitWidth: rowContent.implicitWidth + 20
+    implicitHeight: 30
+
+    radius: Theme.cardRadius
+    border.width: 0
+    color: mouse.containsMouse && root.rowEnabled ? Theme.alpha(Theme.fg, Theme.hoverAlpha) : "transparent"
+
+    Behavior on color {
+        ColorAnimation {
+            duration: Theme.durFast
+        }
+    }
+
+    Row {
+        id: rowContent
+        anchors.left: parent.left
+        anchors.leftMargin: 10
+        anchors.verticalCenter: parent.verticalCenter
+        spacing: 8
+
+        IconImage {
+            anchors.verticalCenter: parent.verticalCenter
+            implicitSize: 16
+            asynchronous: true
+            visible: root.icon !== ""
+            source: root.icon
+        }
+
+        Text {
+            anchors.verticalCenter: parent.verticalCenter
+            text: root.label
+            font.family: Theme.fontFamily
+            font.pixelSize: Theme.fontSize
+            color: root.rowEnabled ? Theme.fg : Theme.fgMuted
+        }
+    }
+
+    Text {
+        anchors.right: parent.right
+        anchors.rightMargin: 10
+        anchors.verticalCenter: parent.verticalCenter
+        font.family: Theme.fontMono
+        font.pixelSize: Theme.fontSize
+        color: Theme.accent
+
+        text: {
+            if (root.submenu)
+                return "\u{F0142}";  // md-chevron_right
+            if (root.buttonType !== 0 && root.checkState === Qt.Checked)
+                return "\u{F012C}";  // md-check
+            return "";
+        }
+    }
+
+    MouseArea {
+        id: mouse
+        anchors.fill: parent
+        hoverEnabled: true
+        cursorShape: root.rowEnabled ? Qt.PointingHandCursor : Qt.ArrowCursor
+        onClicked: if (root.rowEnabled)
+            root.activated()
+    }
+}

config/dot/quickshell/modules/bar/VitalsField.qml

@@ -0,0 +1,53 @@
+// One glyph + percentage pair inside VitalsWidget. Split out so the three
+// fields cannot drift apart in spacing, width or colour thresholds.
+
+import QtQuick
+import qs.config
+
+Row {
+    id: root
+
+    required property string glyph
+    required property real value
+
+    property int warnAt: 70
+    property int dangerAt: 90
+
+    spacing: 4
+
+    Text {
+        anchors.verticalCenter: parent.verticalCenter
+        text: root.glyph
+        font.family: Theme.fontMono
+        font.pixelSize: Theme.fontSize
+        color: Theme.fgDim
+    }
+
+    Text {
+        anchors.verticalCenter: parent.verticalCenter
+        text: Math.round(root.value) + "%"
+
+        // Tabular figures and a fixed width so the row doesn't jitter as digits
+        // change — a moving bar is far more distracting than a wide one. Sans,
+        // not mono: this is UI text, not terminal output.
+        font.family: Theme.fontFamily
+        font.features: Theme.tabularFigures
+        font.pixelSize: Theme.fontSizeSmall
+        horizontalAlignment: Text.AlignRight
+        width: 30
+
+        color: {
+            if (root.value >= root.dangerAt)
+                return Theme.danger;
+            if (root.value >= root.warnAt)
+                return Theme.warn;
+            return Theme.fg;
+        }
+
+        Behavior on color {
+            ColorAnimation {
+                duration: Theme.durFast
+            }
+        }
+    }
+}

config/dot/quickshell/modules/bar/VitalsWidget.qml

@@ -0,0 +1,47 @@
+// CPU / RAM / GPU readout, in that order — the exact set and order the GNOME
+// Vitals extension was configured with (_processor_usage_, _memory_usage_,
+// _gpu#1_usage_).
+//
+// Values are colour-coded rather than graphed: at bar size a number you can
+// glance at beats a sparkline you have to squint at.
+
+import QtQuick
+import qs.config
+import qs.services
+import qs.widgets
+
+Pill {
+    id: root
+
+    // Right-click opens the settings that govern this widget. Which readouts
+    // appear in the bar, and how often they update.
+    onSecondaryActivated: ShellState.openSettings("appearance")
+
+    interactive: false
+
+    Row {
+        spacing: Theme.itemSpacing
+
+        VitalsField {
+            glyph: "\u{F4BC}"    // oct-cpu
+            value: Vitals.cpu
+            visible: Settings.showCpu
+        }
+
+        VitalsField {
+            glyph: "\u{F035B}"   // md-memory
+            value: Vitals.memory
+            visible: Settings.showMemory
+            // Memory sitting high is normal (page cache, browsers); only start
+            // complaining much later than for CPU.
+            warnAt: 80
+            dangerAt: 92
+        }
+
+        VitalsField {
+            glyph: "\u{F08AE}"   // md-expansion_card
+            value: Vitals.gpu
+            visible: Settings.showGpu && Vitals.gpuAvailable
+        }
+    }
+}

config/dot/quickshell/modules/bar/WeatherWidget.qml

@@ -0,0 +1,34 @@
+// Temperature and condition glyph, sitting next to the clock the way GNOME's
+// weather sat inside the date menu button. Hidden entirely until a fetch has
+// succeeded — an empty slot reads better than a placeholder.
+
+import QtQuick
+import qs.config
+import qs.services
+import qs.widgets
+
+Pill {
+    id: root
+
+    // Right-click opens the settings that govern this widget. Location, units and refresh interval are all on Home.
+    onSecondaryActivated: ShellState.openSettings("home")
+
+    interactive: false
+    visible: Weather.available
+
+    Text {
+        anchors.verticalCenter: parent.verticalCenter
+        text: Weather.icon
+        font.family: Theme.fontMono
+        font.pixelSize: Theme.fontSizeLarge
+        color: Theme.accentAlt
+    }
+
+    Text {
+        anchors.verticalCenter: parent.verticalCenter
+        text: Math.round(Weather.temperature) + Weather.unitSuffix
+        font.family: Theme.fontFamily
+        font.pixelSize: Theme.fontSize
+        color: Theme.fg
+    }
+}

config/dot/quickshell/modules/bar/Workspaces.qml

@@ -0,0 +1,161 @@
+// Workspace indicator, in the shape GNOME's workspace switcher had: a row of
+// dots, the current one drawn as a wide accent pill. Hyprland workspaces are
+// dynamic here, so the row grows and shrinks as workspaces come and go.
+//
+// Scrolling anywhere over the row switches workspace — a habit carried over
+// from the GNOME top panel and explicitly worth keeping.
+
+import Quickshell
+import Quickshell.Hyprland
+import QtQuick
+import qs.config
+
+Item {
+    id: root
+
+    // The QsScreen this bar instance lives on. When set, only that monitor's
+    // workspaces are shown — otherwise a second monitor would duplicate them.
+    property var screen: null
+
+    readonly property HyprlandMonitor monitor: root.screen ? Hyprland.monitorFor(root.screen) : null
+
+    // Special workspaces (negative ids) are scratchpads, not places you switch
+    // to by index — GNOME had no equivalent, so they stay out of the row.
+    readonly property var workspaces: {
+        const all = Hyprland.workspaces ? Hyprland.workspaces.values : [];
+        return all.filter(ws => ws && ws.id > 0 && (!root.monitor || !ws.monitor || ws.monitor === root.monitor)).sort((a, b) => a.id - b.id);
+    }
+
+    // The delegate currently focused. The accent pill tracks its geometry, which
+    // is what makes the pill appear to slide from one workspace to the next.
+    property Item focusedItem: null
+
+    readonly property int dotSize: 8
+    readonly property int slotWidth: 16
+    readonly property int focusedSlotWidth: 28
+
+    implicitWidth: row.implicitWidth + 12
+    // Full bar height makes (0, 0) part of the wheel target. The dots stay
+    // optically centred by the row and active-pill geometry below.
+    implicitHeight: Theme.barHeight
+
+    // Scroll over the padding either side of the row, not just over a dot.
+    MouseArea {
+        anchors.fill: parent
+        acceptedButtons: Qt.NoButton
+        onWheel: event => root.cycle(event.angleDelta.y)
+    }
+
+    Rectangle {
+        id: activePill
+
+        // Behind the dots: the focused delegate hides its own dot, so nothing
+        // is ever drawn on top of the pill.
+        z: -1
+
+        visible: root.focusedItem !== null
+        height: root.dotSize
+        radius: Theme.pillRadius
+        border.width: 0 // QTBUG-137166: rounded rects can lose their corners
+
+        // The prism, as a fill rather than a hairline. This is the one element
+        // in the bar that is always coloured, so it is where the pair belongs.
+        gradient: Gradient {
+            orientation: Gradient.Horizontal
+            GradientStop {
+                position: 0.0
+                color: Theme.accent
+            }
+            GradientStop {
+                position: 1.0
+                color: Theme.accentSecondary
+            }
+        }
+
+        y: (root.height - height) / 2
+        x: row.x + (root.focusedItem ? root.focusedItem.x : 0)
+        width: root.focusedItem ? root.focusedItem.width : 0
+
+        Behavior on x {
+            NumberAnimation {
+                duration: Theme.durNormal
+                easing.type: Easing.OutCubic
+            }
+        }
+        Behavior on width {
+            NumberAnimation {
+                duration: Theme.durNormal
+                easing.type: Easing.OutCubic
+            }
+        }
+    }
+
+    Row {
+        id: row
+        anchors.centerIn: parent
+        spacing: 4
+
+        Repeater {
+            model: root.workspaces
+
+            delegate: Item {
+                id: slot
+
+                required property var modelData
+
+                readonly property bool isFocused: slot.modelData.focused
+                readonly property bool isOccupied: slot.modelData.toplevels ? slot.modelData.toplevels.values.length > 0 : false
+
+                implicitWidth: slot.isFocused ? root.focusedSlotWidth : root.slotWidth
+                implicitHeight: root.height
+
+                Behavior on implicitWidth {
+                    NumberAnimation {
+                        duration: Theme.durNormal
+                        easing.type: Easing.OutCubic
+                    }
+                }
+
+                onIsFocusedChanged: if (slot.isFocused)
+                    root.focusedItem = slot
+                Component.onCompleted: if (slot.isFocused)
+                    root.focusedItem = slot
+
+                Rectangle {
+                    anchors.centerIn: parent
+                    width: root.dotSize
+                    height: root.dotSize
+                    radius: width / 2
+                    border.width: 0
+                    visible: !slot.isFocused
+
+                    color: {
+                        if (slot.modelData.urgent)
+                            return Theme.urgent;
+                        return slot.isOccupied ? Theme.fg : Theme.alpha(Theme.fg, 0.3);
+                    }
+
+                    Behavior on color {
+                        ColorAnimation {
+                            duration: Theme.durFast
+                        }
+                    }
+                }
+
+                MouseArea {
+                    anchors.fill: parent
+                    cursorShape: Qt.PointingHandCursor
+                    onClicked: slot.modelData.activate()
+                    onWheel: event => root.cycle(event.angleDelta.y)
+                }
+            }
+        }
+    }
+
+    // Scroll up goes to the previous workspace, down to the next — the same
+    // direction GNOME used. Relative focus rather than by index so it keeps
+    // working with dynamic workspaces.
+    function cycle(angleDeltaY: int): void {
+        Hyprland.dispatch(angleDeltaY > 0 ? 'hl.dsp.focus({ workspace = "-1" })' : 'hl.dsp.focus({ workspace = "+1" })');
+    }
+}

config/dot/quickshell/modules/capture/CaptureBar.qml

@@ -0,0 +1,225 @@
+// The floating control panel at the bottom of the capture overlay.
+//
+// Layout is a deliberate copy of GNOME 42's screenshot UI: the area segmented
+// control on top, and below it the shutter dead-centre with "Show Pointer" on
+// the left and the screenshot/screencast switch on the right.
+
+import QtQuick
+import qs.config
+import qs.services
+
+Rectangle {
+    id: root
+
+    signal captureRequested
+
+    // Set by the overlay so the shutter can grey out when Window mode has
+    // nothing pickable (no Hyprland, or an empty workspace).
+    property bool captureEnabled: true
+
+    implicitWidth: 760
+    implicitHeight: col.implicitHeight + 2 * 20
+    radius: 28
+    border.width: 0
+    color: Theme.alpha(Theme.bgPopover, Theme.popoverAlpha)
+
+    Column {
+        id: col
+        anchors {
+            left: parent.left
+            right: parent.right
+            top: parent.top
+            margins: 20
+        }
+        spacing: 18
+
+        // ── Area mode ───────────────────────────────────────────────────────
+        Rectangle {
+            anchors.horizontalCenter: parent.horizontalCenter
+            implicitWidth: modes.implicitWidth + 8
+            implicitHeight: modes.implicitHeight + 8
+            radius: Theme.pillRadius
+            border.width: 0
+            color: Theme.alpha(Theme.fg, 0.07)
+
+            Row {
+                id: modes
+                anchors.centerIn: parent
+                spacing: 2
+
+                ModeButton {
+                    glyph: "󰍹"
+                    label: "Screen"
+                    active: Capture.mode === "screen"
+                    onClicked: Capture.mode = "screen"
+                }
+                ModeButton {
+                    glyph: "󰖯"
+                    label: "Window"
+                    active: Capture.mode === "window"
+                    onClicked: Capture.mode = "window"
+                }
+                ModeButton {
+                    glyph: "󰩭"
+                    label: "Selection"
+                    active: Capture.mode === "selection"
+                    onClicked: Capture.mode = "selection"
+                }
+            }
+        }
+
+        // ── Pointer toggle · shutter · capture type ─────────────────────────
+        Item {
+            width: col.width
+            height: 68
+
+            // "Show Pointer". wf-recorder has no cursor switch in this build,
+            // so it is disabled while the screencast type is selected instead
+            // of silently lying about what it does.
+            Rectangle {
+                id: pointerToggle
+                anchors {
+                    left: parent.left
+                    verticalCenter: parent.verticalCenter
+                }
+                implicitWidth: pointerRow.implicitWidth + 26
+                implicitHeight: 40
+                radius: Theme.pillRadius
+                border.width: 0
+                opacity: Capture.recordMode || Capture.intelligenceMode ? 0.4 : 1.0
+                color: pointerMouse.containsMouse && !Capture.recordMode && !Capture.intelligenceMode ? Theme.alpha(Theme.fg, Theme.hoverAlpha) : Theme.alpha(Theme.fg, 0.07)
+
+                Behavior on color {
+                    ColorAnimation {
+                        duration: Theme.durFast
+                    }
+                }
+
+                Row {
+                    id: pointerRow
+                    anchors.centerIn: parent
+                    spacing: 8
+
+                    Text {
+                        anchors.verticalCenter: parent.verticalCenter
+                        text: Capture.showPointer ? "󰄬" : "󰄱"
+                        color: Capture.showPointer ? Theme.accent : Theme.fgDim
+                        font.family: Theme.fontMono
+                        font.pixelSize: Theme.fontSizeLarge
+                    }
+
+                    Text {
+                        anchors.verticalCenter: parent.verticalCenter
+                        text: "Show Pointer"
+                        color: Theme.fg
+                        font.family: Theme.fontFamily
+                        font.pixelSize: Theme.fontSize
+                    }
+                }
+
+                MouseArea {
+                    id: pointerMouse
+                    anchors.fill: parent
+                    hoverEnabled: true
+                    enabled: !Capture.recordMode && !Capture.intelligenceMode
+                    cursorShape: Qt.PointingHandCursor
+                    onClicked: Capture.showPointer = !Capture.showPointer
+                }
+            }
+
+            // ── Shutter ─────────────────────────────────────────────────────
+            Rectangle {
+                id: shutter
+                anchors.centerIn: parent
+                implicitWidth: 64
+                implicitHeight: 64
+                radius: width / 2
+                border.width: 0
+                opacity: root.captureEnabled ? 1.0 : 0.45
+                color: shutterMouse.containsMouse && root.captureEnabled ? Theme.alpha(Theme.fg, 0.3) : Theme.alpha(Theme.fg, 0.18)
+
+                Behavior on color {
+                    ColorAnimation {
+                        duration: Theme.durFast
+                    }
+                }
+
+                Rectangle {
+                    anchors.centerIn: parent
+                    width: shutterMouse.pressed ? 40 : 46
+                    height: width
+                    radius: width / 2
+                    border.width: 0
+                    color: Capture.recordMode ? Theme.danger : (Capture.intelligenceMode ? Theme.accent : Theme.fg)
+
+                    Behavior on width {
+                        NumberAnimation {
+                            duration: Theme.durFast
+                        }
+                    }
+                    Behavior on color {
+                        ColorAnimation {
+                            duration: Theme.durFast
+                        }
+                    }
+
+                    Text {
+                        anchors.centerIn: parent
+                        visible: Capture.intelligenceMode
+                        text: "󰗊"
+                        color: Theme.bgDark
+                        font.family: Theme.fontMono
+                        font.pixelSize: 21
+                    }
+                }
+
+                MouseArea {
+                    id: shutterMouse
+                    anchors.fill: parent
+                    hoverEnabled: true
+                    enabled: root.captureEnabled
+                    cursorShape: Qt.PointingHandCursor
+                    onClicked: root.captureRequested()
+                }
+            }
+
+            // ── Screenshot / screencast ─────────────────────────────────────
+            Rectangle {
+                anchors {
+                    right: parent.right
+                    verticalCenter: parent.verticalCenter
+                }
+                implicitWidth: types.implicitWidth + 8
+                implicitHeight: types.implicitHeight + 8
+                radius: Theme.pillRadius
+                border.width: 0
+                color: Theme.alpha(Theme.fg, 0.07)
+
+                Row {
+                    id: types
+                    anchors.centerIn: parent
+                    spacing: 2
+
+                    ModeButton {
+                        glyph: "󰄀"
+                        label: "Shot"
+                        active: !Capture.recordMode && !Capture.intelligenceMode
+                        onClicked: Capture.selectScreenshot()
+                    }
+                    ModeButton {
+                        glyph: "󰕧"
+                        label: "Record"
+                        active: Capture.recordMode
+                        onClicked: Capture.selectRecording()
+                    }
+                    ModeButton {
+                        glyph: "󰗊"
+                        label: "Read"
+                        active: Capture.intelligenceMode
+                        onClicked: Capture.selectIntelligence()
+                    }
+                }
+            }
+        }
+    }
+}

config/dot/quickshell/modules/capture/CaptureOverlay.qml

@@ -0,0 +1,178 @@
+// The GNOME 42 screenshot UI.
+//
+// Print freezes the screen, this overlay paints that frozen frame full-bleed
+// and puts the picker on top of it. Because the frame is a still, nothing under
+// the overlay animates while the user aims, and the overlay can never end up in
+// its own screenshot.
+//
+// The grab happens in services/Capture.qml *before* ShellState flips to
+// "capture", so by the time this window maps the backdrop is already on disk.
+
+import Quickshell
+import Quickshell.Wayland
+import QtQuick
+import qs.config
+import qs.services
+
+PanelWindow {
+    id: win
+
+    visible: ShellState.captureOpen
+    color: "transparent"
+
+    anchors {
+        top: true
+        bottom: true
+        left: true
+        right: true
+    }
+
+    // Fullscreen overlays must not reserve space, or every window on the
+    // workspace gets resized as the picker opens and closes.
+    exclusiveZone: 0
+
+    WlrLayershell.namespace: "qs-capture" // matched by a layerrule in hypr/rules.lua
+    WlrLayershell.layer: WlrLayer.Overlay
+    WlrLayershell.keyboardFocus: WlrKeyboardFocus.Exclusive
+
+    onVisibleChanged: {
+        if (!win.visible)
+            return;
+        // Hyprland reports window geometry in layout-global coordinates; the
+        // picker works in window-local ones. On a single monitor this is 0,0.
+        Capture.originX = win.screen ? win.screen.x : 0;
+        Capture.originY = win.screen ? win.screen.y : 0;
+        keys.forceActiveFocus();
+    }
+
+    // Fire whatever the current mode has selected.
+    function capture(): void {
+        if (Capture.mode === "screen") {
+            Capture.commit(null);
+            return;
+        }
+        if (Capture.mode === "window") {
+            const r = picker.selectedRect;
+            if (r)
+                Capture.commit(r);
+            return;
+        }
+        if (!selection.hasSelection)
+            return;
+        const s = selection.selection;
+        Capture.commit(Qt.rect(s.x + Capture.originX, s.y + Capture.originY, s.width, s.height));
+    }
+
+    function cycleMode(step: int): void {
+        const order = ["screen", "window", "selection"];
+        const i = order.indexOf(Capture.mode);
+        Capture.mode = order[(i + step + order.length) % order.length];
+    }
+
+    FocusScope {
+        id: keys
+        anchors.fill: parent
+        focus: true
+
+        Keys.onPressed: event => {
+            switch (event.key) {
+            case Qt.Key_Escape:
+                Capture.close();
+                break;
+            case Qt.Key_Return:
+            case Qt.Key_Enter:
+            case Qt.Key_Space:
+                win.capture();
+                break;
+            case Qt.Key_Left:
+                win.cycleMode(-1);
+                break;
+            case Qt.Key_Right:
+                win.cycleMode(1);
+                break;
+            case Qt.Key_1:
+                Capture.mode = "screen";
+                break;
+            case Qt.Key_2:
+                Capture.mode = "window";
+                break;
+            case Qt.Key_3:
+                Capture.mode = "selection";
+                break;
+            case Qt.Key_P:
+                Capture.showPointer = !Capture.showPointer;
+                break;
+            default:
+                return;
+            }
+            event.accepted = true;
+        }
+
+        // Painted under the frozen frame so a failed grab (no wlr-screencopy)
+        // still gives the picker something opaque to sit on.
+        Rectangle {
+            anchors.fill: parent
+            color: Theme.bgDark
+            border.width: 0
+        }
+
+        // The frozen screen. grim -o pins the grab to this output, so filling
+        // the window is an exact 1:1 mapping; the source is 4500x3000 device
+        // pixels drawn into 3000x2000 logical ones, i.e. full sharpness.
+        Image {
+            anchors.fill: parent
+            source: Capture.freezeUrl
+            fillMode: Image.Stretch
+            // Unique filename per grab plus cache:false — otherwise QML would
+            // happily repaint a previous session's frame.
+            cache: false
+            // Synchronous so the overlay never flashes black on the way in; a
+            // raw PPM decode is a parse, not a decompress.
+            asynchronous: false
+            visible: status === Image.Ready
+        }
+
+        // ── Screen mode ─────────────────────────────────────────────────────
+        // Nothing to pick, so just outline the output the way GNOME does.
+        Frame {
+            anchors.fill: parent
+            visible: Capture.mode === "screen"
+            strokeWidth: 3
+            strokeColor: Theme.accent
+        }
+
+        // ── Window mode ─────────────────────────────────────────────────────
+        WindowPicker {
+            id: picker
+            anchors.fill: parent
+            visible: Capture.mode === "window"
+            originX: Capture.originX
+            originY: Capture.originY
+            onPicked: win.capture()
+        }
+
+        // ── Selection mode ──────────────────────────────────────────────────
+        SelectionLayer {
+            id: selection
+            anchors.fill: parent
+            visible: Capture.mode === "selection"
+            onCommitted: win.capture()
+        }
+
+        CaptureBar {
+            anchors {
+                horizontalCenter: parent.horizontalCenter
+                bottom: parent.bottom
+                bottomMargin: 56
+            }
+            captureEnabled: {
+                if (Capture.mode === "window")
+                    return picker.selectedRect !== null;
+                if (Capture.mode === "selection")
+                    return selection.hasSelection;
+                return true;
+            }
+            onCaptureRequested: win.capture()
+        }
+    }
+}

config/dot/quickshell/modules/capture/Frame.qml

@@ -0,0 +1,49 @@
+// An outline drawn as four opaque strips rather than a Rectangle border.
+//
+// A rounded Rectangle with a translucent fill and a border renders holes at the
+// corners on this Qt build (QTBUG-137166), and every outline in the capture
+// overlay sits on top of a photo where that would be very visible. Four plain
+// strips have no corners to get wrong.
+
+import QtQuick
+import qs.config
+
+Item {
+    id: root
+
+    property color strokeColor: Theme.accent
+    property int strokeWidth: 2
+    // Optional wash over the enclosed area, drawn under the strips.
+    property color fillColor: "transparent"
+
+    Rectangle {
+        anchors.fill: parent
+        color: root.fillColor
+        border.width: 0
+    }
+
+    Rectangle {
+        anchors { left: parent.left; right: parent.right; top: parent.top }
+        height: root.strokeWidth
+        color: root.strokeColor
+        border.width: 0
+    }
+    Rectangle {
+        anchors { left: parent.left; right: parent.right; bottom: parent.bottom }
+        height: root.strokeWidth
+        color: root.strokeColor
+        border.width: 0
+    }
+    Rectangle {
+        anchors { top: parent.top; bottom: parent.bottom; left: parent.left }
+        width: root.strokeWidth
+        color: root.strokeColor
+        border.width: 0
+    }
+    Rectangle {
+        anchors { top: parent.top; bottom: parent.bottom; right: parent.right }
+        width: root.strokeWidth
+        color: root.strokeColor
+        border.width: 0
+    }
+}

config/dot/quickshell/modules/capture/IntelligenceResult.qml

@@ -0,0 +1,408 @@
+// Focused result sheet for local OCR and code recognition. It is intentionally
+// a transient overlay: the user selects pixels, acts on the result, and leaves
+// without creating another application window or workspace tile.
+
+import Quickshell
+import Quickshell.Wayland
+import QtQuick
+import qs.config
+import qs.services
+import qs.widgets
+
+PanelWindow {
+    id: win
+
+    visible: ScreenIntelligence.visible
+    color: "transparent"
+    exclusiveZone: 0
+
+    anchors {
+        top: true
+        bottom: true
+        left: true
+        right: true
+    }
+
+    WlrLayershell.namespace: "qs-screen-intelligence"
+    WlrLayershell.layer: WlrLayer.Overlay
+    WlrLayershell.keyboardFocus: WlrKeyboardFocus.Exclusive
+
+    onVisibleChanged: {
+        if (visible)
+            keyboardScope.forceActiveFocus();
+        else
+            copied = false;
+    }
+
+    property bool copied: false
+
+    Timer {
+        id: copiedTimer
+        interval: 1500
+        onTriggered: win.copied = false
+    }
+
+    FocusScope {
+        id: keyboardScope
+        anchors.fill: parent
+        focus: true
+
+        Keys.onEscapePressed: event => {
+            ScreenIntelligence.close();
+            event.accepted = true;
+        }
+
+        Rectangle {
+            anchors.fill: parent
+            color: Theme.alpha(Theme.bgDark, 0.46)
+            border.width: 0
+
+            MouseArea {
+                anchors.fill: parent
+                onClicked: ScreenIntelligence.close()
+            }
+        }
+
+        Rectangle {
+            id: sheet
+            anchors.centerIn: parent
+            width: Math.min(parent.width - 80, 840)
+            height: Math.min(parent.height - 120, ScreenIntelligence.phase === "ready" ? 680 : 390)
+            radius: 24
+            color: Theme.alpha(Theme.bgPopover, 0.965)
+            border.width: 1
+            border.color: Theme.alpha(Theme.fg, 0.1)
+            clip: true
+
+            PrismEdge {
+                anchors.top: parent.top
+                anchors.left: parent.left
+                anchors.right: parent.right
+                inset: sheet.radius
+            }
+
+            MouseArea {
+                anchors.fill: parent
+                onClicked: mouse => mouse.accepted = true
+            }
+
+            Column {
+                id: heading
+                anchors.left: parent.left
+                anchors.right: closeButton.left
+                anchors.top: parent.top
+                anchors.leftMargin: 28
+                anchors.topMargin: 25
+                anchors.rightMargin: 18
+                spacing: 4
+
+                Text {
+                    text: "Screen Intelligence"
+                    color: Theme.fg
+                    font.family: Theme.fontFamily
+                    font.pixelSize: Theme.fontSizeTitle
+                    font.weight: Font.DemiBold
+                }
+
+                Text {
+                    text: {
+                        if (ScreenIntelligence.phase === "capturing")
+                            return "Capturing the selected pixels";
+                        if (ScreenIntelligence.phase === "reading")
+                            return "Reading locally on this computer";
+                        if (ScreenIntelligence.phase === "error")
+                            return "Recognition needs attention";
+                        return "Local text and code recognition";
+                    }
+                    color: Theme.fgDim
+                    font.family: Theme.fontFamily
+                    font.pixelSize: Theme.fontSize
+                }
+            }
+
+            Rectangle {
+                id: closeButton
+                anchors.top: parent.top
+                anchors.right: parent.right
+                anchors.topMargin: 20
+                anchors.rightMargin: 20
+                width: 34
+                height: 34
+                radius: 11
+                color: closeMouse.containsMouse ? Theme.alpha(Theme.fg, Theme.hoverAlpha) : "transparent"
+
+                Text {
+                    anchors.centerIn: parent
+                    text: "×"
+                    color: Theme.fgDim
+                    font.family: Theme.fontFamily
+                    font.pixelSize: 20
+                }
+
+                MouseArea {
+                    id: closeMouse
+                    anchors.fill: parent
+                    hoverEnabled: true
+                    cursorShape: Qt.PointingHandCursor
+                    onClicked: ScreenIntelligence.close()
+                }
+            }
+
+            Item {
+                id: body
+                anchors.left: parent.left
+                anchors.right: parent.right
+                anchors.top: heading.bottom
+                anchors.bottom: actions.top
+                anchors.leftMargin: 28
+                anchors.rightMargin: 28
+                anchors.topMargin: 24
+                anchors.bottomMargin: 18
+
+                Column {
+                    anchors.centerIn: parent
+                    width: Math.min(parent.width, 520)
+                    spacing: 13
+                    visible: ScreenIntelligence.busy
+
+                    Text {
+                        anchors.horizontalCenter: parent.horizontalCenter
+                        text: "󰗊"
+                        color: Theme.accent
+                        font.family: Theme.fontMono
+                        font.pixelSize: 40
+                    }
+                    Text {
+                        width: parent.width
+                        text: ScreenIntelligence.phase === "capturing" ? "Capturing…" : "Reading text and codes…"
+                        color: Theme.fg
+                        horizontalAlignment: Text.AlignHCenter
+                        font.family: Theme.fontFamily
+                        font.pixelSize: Theme.fontSizeLarge
+                        font.weight: Font.DemiBold
+                    }
+                    Text {
+                        width: parent.width
+                        text: "Pixels stay on this computer. No network request is being made."
+                        color: Theme.fgDim
+                        horizontalAlignment: Text.AlignHCenter
+                        wrapMode: Text.WordWrap
+                        font.family: Theme.fontFamily
+                        font.pixelSize: Theme.fontSize
+                    }
+                }
+
+                Column {
+                    anchors.centerIn: parent
+                    width: Math.min(parent.width, 560)
+                    spacing: 14
+                    visible: ScreenIntelligence.phase === "error"
+
+                    Text {
+                        anchors.horizontalCenter: parent.horizontalCenter
+                        text: "󰅚"
+                        color: Theme.warn
+                        font.family: Theme.fontMono
+                        font.pixelSize: 38
+                    }
+                    Text {
+                        width: parent.width
+                        text: ScreenIntelligence.error
+                        color: Theme.fg
+                        horizontalAlignment: Text.AlignHCenter
+                        wrapMode: Text.WordWrap
+                        font.family: Theme.fontFamily
+                        font.pixelSize: Theme.fontSizeLarge
+                        font.weight: Font.DemiBold
+                    }
+                    Rectangle {
+                        anchors.horizontalCenter: parent.horizontalCenter
+                        width: commandText.implicitWidth + 28
+                        height: 38
+                        radius: 10
+                        visible: !ScreenIntelligence.ocrReady
+                        color: Theme.alpha(Theme.fg, 0.07)
+                        border.width: 1
+                        border.color: Theme.alpha(Theme.fg, 0.08)
+
+                        Text {
+                            id: commandText
+                            anchors.centerIn: parent
+                            text: "sudo dnf install -y tesseract zbar"
+                            color: Theme.fgDim
+                            font.family: Theme.fontMono
+                            font.pixelSize: Theme.fontSizeSmall
+                        }
+                    }
+                }
+
+                Column {
+                    anchors.fill: parent
+                    spacing: 12
+                    visible: ScreenIntelligence.phase === "ready"
+
+                    Rectangle {
+                        width: parent.width
+                        height: ScreenIntelligence.codeValue === "" ? 0 : 62
+                        visible: ScreenIntelligence.codeValue !== ""
+                        radius: 13
+                        color: Theme.alpha(Theme.accent, 0.09)
+                        border.width: 1
+                        border.color: Theme.alpha(Theme.accent, 0.2)
+
+                        Text {
+                            anchors.left: parent.left
+                            anchors.leftMargin: 16
+                            anchors.verticalCenter: parent.verticalCenter
+                            text: "󰐲"
+                            color: Theme.accent
+                            font.family: Theme.fontMono
+                            font.pixelSize: 22
+                        }
+                        Column {
+                            anchors.left: parent.left
+                            anchors.leftMargin: 52
+                            anchors.right: codeAction.left
+                            anchors.rightMargin: 14
+                            anchors.verticalCenter: parent.verticalCenter
+                            spacing: 2
+                            Text { text: ScreenIntelligence.codeType || "Detected code"; color: Theme.fg; font.family: Theme.fontFamily; font.pixelSize: Theme.fontSizeSmall; font.weight: Font.DemiBold }
+                            Text { width: parent.width; text: ScreenIntelligence.codeValue; color: Theme.fgDim; elide: Text.ElideMiddle; font.family: Theme.fontFamily; font.pixelSize: Theme.fontSize }
+                        }
+                        ResultAction {
+                            id: codeAction
+                            anchors.right: parent.right
+                            anchors.rightMargin: 12
+                            anchors.verticalCenter: parent.verticalCenter
+                            label: ScreenIntelligence.primaryUrl !== "" ? "Open" : "Copy"
+                            onClicked: {
+                                if (ScreenIntelligence.primaryUrl !== "")
+                                    ScreenIntelligence.openDetected();
+                                else
+                                    ScreenIntelligence.copyCode();
+                            }
+                        }
+                    }
+
+                    Rectangle {
+                        width: parent.width
+                        height: parent.height - (ScreenIntelligence.codeValue === "" ? 0 : 74)
+                        radius: 14
+                        color: Theme.alpha(Theme.bgDark, 0.72)
+                        border.width: 1
+                        border.color: Theme.alpha(Theme.fg, 0.075)
+
+                        Text {
+                            anchors.centerIn: parent
+                            width: parent.width - 60
+                            visible: ScreenIntelligence.text === "" && ScreenIntelligence.codeValue === ""
+                            text: "No readable text or code was found. Try a tighter selection with larger, higher-contrast text."
+                            color: Theme.fgDim
+                            horizontalAlignment: Text.AlignHCenter
+                            wrapMode: Text.WordWrap
+                            font.family: Theme.fontFamily
+                            font.pixelSize: Theme.fontSizeLarge
+                        }
+
+                        Flickable {
+                            anchors.fill: parent
+                            anchors.margins: 17
+                            visible: ScreenIntelligence.text !== ""
+                            clip: true
+                            contentWidth: width
+                            contentHeight: resultText.implicitHeight
+                            boundsBehavior: Flickable.StopAtBounds
+
+                            TextEdit {
+                                id: resultText
+                                width: parent.width
+                                text: ScreenIntelligence.text
+                                readOnly: true
+                                selectByMouse: true
+                                wrapMode: TextEdit.Wrap
+                                color: Theme.fg
+                                selectionColor: Theme.accent
+                                selectedTextColor: Theme.bgDark
+                                font.family: Theme.fontFamily
+                                font.pixelSize: Theme.fontSizeLarge
+                            }
+                        }
+                    }
+                }
+            }
+
+            Row {
+                id: actions
+                anchors.right: parent.right
+                anchors.bottom: parent.bottom
+                anchors.rightMargin: 28
+                anchors.bottomMargin: 24
+                spacing: 8
+                visible: ScreenIntelligence.phase === "ready" && (ScreenIntelligence.text !== "" || ScreenIntelligence.codeValue !== "")
+
+                ResultAction {
+                    label: "Open link"
+                    visible: ScreenIntelligence.primaryUrl !== "" && ScreenIntelligence.codeValue === ""
+                    onClicked: ScreenIntelligence.openDetected()
+                }
+                ResultAction {
+                    label: "Translate"
+                    enabled: ScreenIntelligence.text !== ""
+                    onClicked: ScreenIntelligence.translate()
+                }
+                ResultAction {
+                    label: "Search"
+                    enabled: ScreenIntelligence.text !== ""
+                    onClicked: ScreenIntelligence.search()
+                }
+                ResultAction {
+                    label: win.copied ? "Copied" : "Copy text"
+                    primary: true
+                    enabled: ScreenIntelligence.text !== ""
+                    onClicked: {
+                        ScreenIntelligence.copyText();
+                        win.copied = true;
+                        copiedTimer.restart();
+                    }
+                }
+            }
+        }
+    }
+
+    component ResultAction: Rectangle {
+        id: action
+        property string label: ""
+        property bool primary: false
+        property bool enabled: true
+        signal clicked
+
+        implicitWidth: actionLabel.implicitWidth + 26
+        implicitHeight: 34
+        radius: 10
+        opacity: enabled ? 1 : 0.4
+        color: primary
+            ? (actionMouse.containsMouse ? Theme.mix(Theme.accent, Theme.fg, 0.1) : Theme.accent)
+            : (actionMouse.containsMouse ? Theme.alpha(Theme.fg, 0.13) : Theme.alpha(Theme.fg, 0.075))
+        border.width: primary ? 0 : 1
+        border.color: Theme.alpha(Theme.fg, 0.08)
+
+        Text {
+            id: actionLabel
+            anchors.centerIn: parent
+            text: action.label
+            color: action.primary ? Theme.bgDark : Theme.fg
+            font.family: Theme.fontFamily
+            font.pixelSize: Theme.fontSizeSmall
+            font.weight: Font.Medium
+        }
+
+        MouseArea {
+            id: actionMouse
+            anchors.fill: parent
+            enabled: action.enabled
+            hoverEnabled: true
+            cursorShape: Qt.PointingHandCursor
+            onClicked: action.clicked()
+        }
+    }
+}

config/dot/quickshell/modules/capture/ModeButton.qml

@@ -0,0 +1,72 @@
+// One segment of the Screen / Window / Selection control.
+//
+// Icons are Nerd Font glyphs rather than freedesktop icons on purpose: the
+// Adwaita "symbolic" SVGs are flat black and Qt, unlike GTK, will not recolour
+// them, so they'd be invisible on this dark overlay.
+
+import QtQuick
+import qs.config
+
+Rectangle {
+    id: root
+
+    property string glyph: ""
+    property string label: ""
+    property bool active: false
+
+    signal clicked
+
+    implicitWidth: content.implicitWidth + 30
+    implicitHeight: 40
+    radius: Theme.pillRadius
+    border.width: 0
+
+    color: {
+        if (root.active)
+            return mouse.containsMouse ? Qt.lighter(Theme.accent, 1.1) : Theme.accent;
+        if (mouse.pressed)
+            return Theme.alpha(Theme.fg, Theme.activeAlpha);
+        if (mouse.containsMouse)
+            return Theme.alpha(Theme.fg, Theme.hoverAlpha);
+        return "transparent";
+    }
+
+    Behavior on color {
+        ColorAnimation {
+            duration: Theme.durFast
+        }
+    }
+
+    readonly property color contentColor: root.active ? Theme.bgDark : Theme.fg
+
+    Row {
+        id: content
+        anchors.centerIn: parent
+        spacing: 8
+
+        Text {
+            anchors.verticalCenter: parent.verticalCenter
+            text: root.glyph
+            color: root.contentColor
+            font.family: Theme.fontMono
+            font.pixelSize: Theme.fontSizeLarge
+        }
+
+        Text {
+            anchors.verticalCenter: parent.verticalCenter
+            text: root.label
+            color: root.contentColor
+            font.family: Theme.fontFamily
+            font.pixelSize: Theme.fontSize
+            font.weight: Font.Medium
+        }
+    }
+
+    MouseArea {
+        id: mouse
+        anchors.fill: parent
+        hoverEnabled: true
+        cursorShape: Qt.PointingHandCursor
+        onClicked: root.clicked()
+    }
+}

config/dot/quickshell/modules/capture/RecordingIndicator.qml

@@ -0,0 +1,109 @@
+// The "you are being recorded" pill.
+//
+// GNOME puts a red dot and a timer in the top bar while a screencast runs and
+// clicking it stops the recording. The bar is another module's window, so this
+// is its own tiny layer surface parked just below it.
+
+import Quickshell
+import Quickshell.Wayland
+import QtQuick
+import qs.config
+import qs.services
+
+PanelWindow {
+    id: win
+
+    visible: Capture.recording
+    color: "transparent"
+
+    // Top only: with neither left nor right anchored, layer-shell centres the
+    // surface horizontally.
+    anchors.top: true
+    margins.top: Theme.barGap * 2 + Theme.barHeight + Theme.barGap
+
+    implicitWidth: pill.implicitWidth
+    implicitHeight: pill.implicitHeight
+    exclusiveZone: 0
+
+    WlrLayershell.namespace: "qs-popover-recording"
+    WlrLayershell.layer: WlrLayer.Overlay
+    WlrLayershell.keyboardFocus: WlrKeyboardFocus.None
+
+    function elapsed(): string {
+        const t = Capture.recordingSeconds;
+        const s = ("0" + (t % 60)).slice(-2);
+        const m = Math.floor(t / 60) % 60;
+        const h = Math.floor(t / 3600);
+        return h > 0 ? h + ":" + ("0" + m).slice(-2) + ":" + s : m + ":" + s;
+    }
+
+    Rectangle {
+        id: pill
+        implicitWidth: row.implicitWidth + 12
+        implicitHeight: 34
+        radius: Theme.pillRadius
+        border.width: 0
+        color: Theme.redDeep
+
+        Row {
+            id: row
+            anchors.centerIn: parent
+            spacing: 8
+
+            // Static dot, not a blinking one: nothing in this shell repaints
+            // while idle.
+            Rectangle {
+                anchors.verticalCenter: parent.verticalCenter
+                width: 10
+                height: 10
+                radius: 5
+                border.width: 0
+                color: Theme.fg
+            }
+
+            Text {
+                anchors.verticalCenter: parent.verticalCenter
+                text: win.elapsed()
+                color: Theme.fg
+                // Tabular figures: the timer must not shuffle as it counts.
+                font.family: Theme.fontFamily
+                font.features: Theme.tabularFigures
+                font.pixelSize: Theme.fontSize
+                font.weight: Font.Medium
+            }
+
+            Rectangle {
+                id: stop
+                anchors.verticalCenter: parent.verticalCenter
+                width: 26
+                height: 26
+                radius: width / 2
+                border.width: 0
+                color: stopMouse.containsMouse ? Theme.alpha(Theme.fg, 0.28) : Theme.alpha(Theme.fg, 0.14)
+
+                Behavior on color {
+                    ColorAnimation {
+                        duration: Theme.durFast
+                    }
+                }
+
+                Text {
+                    anchors.centerIn: parent
+                    text: "󰓛"
+                    color: Theme.fg
+                    font.family: Theme.fontMono
+                    font.pixelSize: Theme.fontSize
+                }
+
+                MouseArea {
+                    id: stopMouse
+                    anchors.fill: parent
+                    hoverEnabled: true
+                    cursorShape: Qt.PointingHandCursor
+                    // SIGINT, so wf-recorder finalises the container.
+                    onClicked: Capture.stopRecording()
+                }
+            }
+        }
+    }
+}

config/dot/quickshell/modules/capture/SelectionLayer.qml

@@ -0,0 +1,278 @@
+// Selection mode: a GNOME-style rubber band over the frozen screen.
+//
+// Behaviours copied from GNOME 42: the overlay opens with a sensible centred
+// selection already in place (so the shutter is immediately useful), dragging
+// inside moves it, dragging a corner resizes from the opposite corner, and
+// dragging anywhere else starts a fresh band.
+//
+// A single MouseArea owns all of it. Nested MouseAreas for the handles would
+// fight the move/create area for the press, and the hit priorities are much
+// easier to reason about in one place.
+
+import QtQuick
+import qs.config
+
+Item {
+    id: root
+
+    // Anything smaller than this on release is treated as a stray click and the
+    // previous selection is restored.
+    readonly property real minSize: 12
+    // Pointer distance from a corner that counts as grabbing its handle.
+    readonly property real handleGrab: 24
+    readonly property real handleSize: 14
+
+    property real selX: 0
+    property real selY: 0
+    property real selW: 0
+    property real selH: 0
+
+    readonly property bool hasSelection: root.selW >= root.minSize && root.selH >= root.minSize
+    readonly property rect selection: Qt.rect(root.selX, root.selY, root.selW, root.selH)
+
+    // Double-clicking inside the band captures, like confirming a crop.
+    signal committed
+
+    // "none" | "new" | "move" | "nw" | "ne" | "sw" | "se"
+    property string _grab: "none"
+    property real _anchorX: 0
+    property real _anchorY: 0
+    property real _pressX: 0
+    property real _pressY: 0
+    property real _origX: 0
+    property real _origY: 0
+    property rect _prev: Qt.rect(0, 0, 0, 0)
+
+    onWidthChanged: root._resetIfEmpty()
+    onHeightChanged: root._resetIfEmpty()
+    Component.onCompleted: root._resetIfEmpty()
+
+    function _resetIfEmpty(): void {
+        if (root.selW === 0 && root.selH === 0)
+            root.resetSelection();
+    }
+
+    // Centred, roughly the middle half of the screen.
+    function resetSelection(): void {
+        if (root.width <= 0 || root.height <= 0)
+            return;
+        root.selW = Math.round(root.width * 0.55);
+        root.selH = Math.round(root.height * 0.55);
+        root.selX = Math.round((root.width - root.selW) / 2);
+        root.selY = Math.round((root.height - root.selH) / 2);
+    }
+
+    function _clampX(v: real): real {
+        return Math.max(0, Math.min(root.width, v));
+    }
+    function _clampY(v: real): real {
+        return Math.max(0, Math.min(root.height, v));
+    }
+
+    function _near(a: real, b: real): bool {
+        return Math.abs(a - b) <= root.handleGrab;
+    }
+
+    function _hitTest(px: real, py: real): string {
+        const x2 = root.selX + root.selW;
+        const y2 = root.selY + root.selH;
+        if (root.hasSelection) {
+            if (root._near(px, root.selX) && root._near(py, root.selY))
+                return "nw";
+            if (root._near(px, x2) && root._near(py, root.selY))
+                return "ne";
+            if (root._near(px, root.selX) && root._near(py, y2))
+                return "sw";
+            if (root._near(px, x2) && root._near(py, y2))
+                return "se";
+            if (px > root.selX && px < x2 && py > root.selY && py < y2)
+                return "move";
+        }
+        return "new";
+    }
+
+    function _cursorFor(m: string): int {
+        switch (m) {
+        case "nw":
+        case "se":
+            return Qt.SizeFDiagCursor;
+        case "ne":
+        case "sw":
+            return Qt.SizeBDiagCursor;
+        case "move":
+            return Qt.SizeAllCursor;
+        default:
+            return Qt.CrossCursor;
+        }
+    }
+
+    // Rebuild the band from a fixed anchor corner and the live pointer.
+    function _dragTo(px: real, py: real): void {
+        const cx = root._clampX(px);
+        const cy = root._clampY(py);
+        root.selX = Math.min(root._anchorX, cx);
+        root.selY = Math.min(root._anchorY, cy);
+        root.selW = Math.abs(cx - root._anchorX);
+        root.selH = Math.abs(cy - root._anchorY);
+    }
+
+    Spotlight {
+        anchors.fill: parent
+        holeVisible: root.hasSelection
+        hole: root.selection
+    }
+
+    Frame {
+        x: root.selX
+        y: root.selY
+        width: root.selW
+        height: root.selH
+        visible: root.hasSelection
+        strokeWidth: 2
+        strokeColor: Theme.accent
+    }
+
+    // ── Corner handles ──────────────────────────────────────────────────────
+    Repeater {
+        model: [
+            {
+                gx: 0,
+                gy: 0
+            },
+            {
+                gx: 1,
+                gy: 0
+            },
+            {
+                gx: 0,
+                gy: 1
+            },
+            {
+                gx: 1,
+                gy: 1
+            }
+        ]
+
+        Rectangle {
+            required property var modelData
+
+            visible: root.hasSelection
+            width: root.handleSize
+            height: root.handleSize
+            radius: width / 2
+            border.width: 0
+            color: Theme.accent
+            x: root.selX + modelData.gx * root.selW - width / 2
+            y: root.selY + modelData.gy * root.selH - height / 2
+
+            // A dark core keeps the handle readable on top of a light photo.
+            Rectangle {
+                anchors.centerIn: parent
+                width: parent.width - 6
+                height: width
+                radius: width / 2
+                border.width: 0
+                color: Theme.bgDark
+            }
+        }
+    }
+
+    // ── Live size readout ───────────────────────────────────────────────────
+    Rectangle {
+        id: readout
+        visible: root.hasSelection
+        implicitWidth: readoutText.implicitWidth + 24
+        implicitHeight: 34
+        radius: Theme.pillRadius
+        border.width: 0
+        color: Theme.alpha(Theme.bgPopover, Theme.popoverAlpha)
+
+        x: Math.max(0, Math.min(root.width - width, root.selX + (root.selW - width) / 2))
+        // Inside the band when there is room, otherwise tucked just above it.
+        y: root.selH > 110 ? root.selY + (root.selH - height) / 2 : Math.max(0, root.selY - height - 10)
+
+        Text {
+            id: readoutText
+            anchors.centerIn: parent
+            text: Math.round(root.selW) + " × " + Math.round(root.selH)
+            color: Theme.fg
+            // Tabular figures so the readout doesn't twitch while dragging.
+            font.family: Theme.fontFamily
+            font.features: Theme.tabularFigures
+            font.pixelSize: Theme.fontSize
+        }
+    }
+
+    MouseArea {
+        id: area
+        anchors.fill: parent
+        hoverEnabled: true
+        cursorShape: root._cursorFor(root._grab !== "none" ? root._grab : root._hitTest(area.mouseX, area.mouseY))
+
+        onPressed: event => {
+            root._prev = root.selection;
+            root._grab = root._hitTest(event.x, event.y);
+            root._pressX = event.x;
+            root._pressY = event.y;
+            root._origX = root.selX;
+            root._origY = root.selY;
+
+            const x2 = root.selX + root.selW;
+            const y2 = root.selY + root.selH;
+            switch (root._grab) {
+            case "nw":
+                root._anchorX = x2;
+                root._anchorY = y2;
+                break;
+            case "ne":
+                root._anchorX = root.selX;
+                root._anchorY = y2;
+                break;
+            case "sw":
+                root._anchorX = x2;
+                root._anchorY = root.selY;
+                break;
+            case "se":
+                root._anchorX = root.selX;
+                root._anchorY = root.selY;
+                break;
+            case "new":
+                root._anchorX = root._clampX(event.x);
+                root._anchorY = root._clampY(event.y);
+                root.selX = root._anchorX;
+                root.selY = root._anchorY;
+                root.selW = 0;
+                root.selH = 0;
+                break;
+            }
+        }
+
+        onPositionChanged: event => {
+            if (root._grab === "none")
+                return;
+            if (root._grab === "move") {
+                root.selX = Math.max(0, Math.min(root.width - root.selW, root._origX + (event.x - root._pressX)));
+                root.selY = Math.max(0, Math.min(root.height - root.selH, root._origY + (event.y - root._pressY)));
+            } else {
+                root._dragTo(event.x, event.y);
+            }
+        }
+
+        onReleased: {
+            // A plain click outside the band would otherwise wipe the selection
+            // down to nothing; treat it as "no change" instead.
+            if (root._grab !== "move" && !root.hasSelection) {
+                root.selX = root._prev.x;
+                root.selY = root._prev.y;
+                root.selW = root._prev.width;
+                root.selH = root._prev.height;
+            }
+            root._grab = "none";
+        }
+
+        onDoubleClicked: event => {
+            if (root.hasSelection && event.x > root.selX && event.x < root.selX + root.selW && event.y > root.selY && event.y < root.selY + root.selH)
+                root.committed();
+        }
+    }
+}

config/dot/quickshell/modules/capture/Spotlight.qml

@@ -0,0 +1,72 @@
+// Dims everything except one rectangle, GNOME-style.
+//
+// Four dimming rectangles laid around the hole, because QML has no way to
+// subtract a shape from another without an OpacityMask shader — and a shader
+// here would mean a full-screen 4500x3000 offscreen texture on every pointer
+// move.
+
+import QtQuick
+import qs.config
+
+Item {
+    id: root
+
+    // The region left undimmed, in this item's coordinates.
+    property rect hole: Qt.rect(0, 0, 0, 0)
+    // When false the whole item dims uniformly (nothing selected yet).
+    property bool holeVisible: false
+    property color dimColor: Theme.alpha(Theme.bgDark, Theme.overlayAlpha)
+
+    readonly property real _l: Math.max(0, Math.min(root.width, root.hole.x))
+    readonly property real _t: Math.max(0, Math.min(root.height, root.hole.y))
+    readonly property real _r: Math.max(root._l, Math.min(root.width, root.hole.x + root.hole.width))
+    readonly property real _b: Math.max(root._t, Math.min(root.height, root.hole.y + root.hole.height))
+
+    Rectangle {
+        anchors.fill: parent
+        visible: !root.holeVisible
+        color: root.dimColor
+        border.width: 0
+    }
+
+    // Above the hole
+    Rectangle {
+        visible: root.holeVisible
+        x: 0
+        y: 0
+        width: root.width
+        height: root._t
+        color: root.dimColor
+        border.width: 0
+    }
+    // Below
+    Rectangle {
+        visible: root.holeVisible
+        x: 0
+        y: root._b
+        width: root.width
+        height: Math.max(0, root.height - root._b)
+        color: root.dimColor
+        border.width: 0
+    }
+    // Left of the hole, between top and bottom bands
+    Rectangle {
+        visible: root.holeVisible
+        x: 0
+        y: root._t
+        width: root._l
+        height: Math.max(0, root._b - root._t)
+        color: root.dimColor
+        border.width: 0
+    }
+    // Right
+    Rectangle {
+        visible: root.holeVisible
+        x: root._r
+        y: root._t
+        width: Math.max(0, root.width - root._r)
+        height: Math.max(0, root._b - root._t)
+        color: root.dimColor
+        border.width: 0
+    }
+}

config/dot/quickshell/modules/capture/WindowPicker.qml

@@ -0,0 +1,140 @@
+// Window mode: outline every window on the focused workspace, highlight the one
+// under the pointer and dim the rest, click to capture it.
+//
+// Geometry comes from `hyprctl -j clients` via services/Capture.qml, because
+// Quickshell's HyprlandToplevel exposes no position or size.
+
+import QtQuick
+import qs.config
+import qs.services
+
+Item {
+    id: root
+
+    // Layout-global origin of the output this overlay covers.
+    property real originX: 0
+    property real originY: 0
+
+    signal picked
+
+    readonly property var windows: Capture.windows
+
+    // Front-to-back hit test: Capture.windows is already sorted by
+    // focusHistoryID, so the first hit is the topmost window.
+    readonly property int hoveredIndex: {
+        if (!area.containsMouse)
+            return -1;
+        const mx = area.mouseX;
+        const my = area.mouseY;
+        for (let i = 0; i < root.windows.length; i++) {
+            const w = root.windows[i];
+            const x = w.x - root.originX;
+            const y = w.y - root.originY;
+            if (mx >= x && mx <= x + w.w && my >= y && my <= y + w.h)
+                return i;
+        }
+        return -1;
+    }
+
+    // Once a window has been hovered it stays highlighted after the pointer
+    // moves down onto the control bar, so the shutter button always has
+    // something to shoot. Index 0 is the most recently focused window, which is
+    // what GNOME preselects.
+    property int stickyIndex: 0
+    onHoveredIndexChanged: {
+        if (root.hoveredIndex >= 0)
+            root.stickyIndex = root.hoveredIndex;
+    }
+    onWindowsChanged: root.stickyIndex = 0
+
+    readonly property int activeIndex: root.hoveredIndex >= 0 ? root.hoveredIndex : root.stickyIndex
+    readonly property var hovered: (root.activeIndex >= 0 && root.activeIndex < root.windows.length) ? root.windows[root.activeIndex] : null
+
+    // Layout-global rect of the hovered window, or null. The overlay hands this
+    // straight to Capture.commit().
+    readonly property var selectedRect: root.hovered ? Qt.rect(root.hovered.x, root.hovered.y, root.hovered.w, root.hovered.h) : null
+
+    Spotlight {
+        anchors.fill: parent
+        holeVisible: root.hovered !== null
+        hole: root.hovered ? Qt.rect(root.hovered.x - root.originX, root.hovered.y - root.originY, root.hovered.w, root.hovered.h) : Qt.rect(0, 0, 0, 0)
+    }
+
+    // Faint outline on every candidate so the user can see what is pickable
+    // before moving the pointer, the way GNOME's window shots do.
+    Repeater {
+        model: root.windows
+
+        Frame {
+            required property var modelData
+            required property int index
+
+            x: modelData.x - root.originX
+            y: modelData.y - root.originY
+            width: modelData.w
+            height: modelData.h
+            visible: index !== root.activeIndex
+            strokeWidth: 1
+            strokeColor: Theme.alpha(Theme.fg, 0.35)
+        }
+    }
+
+    Frame {
+        visible: root.hovered !== null
+        x: root.hovered ? root.hovered.x - root.originX : 0
+        y: root.hovered ? root.hovered.y - root.originY : 0
+        width: root.hovered ? root.hovered.w : 0
+        height: root.hovered ? root.hovered.h : 0
+        strokeWidth: 3
+        strokeColor: Theme.accent
+        fillColor: Theme.alpha(Theme.accent, 0.08)
+    }
+
+    // Title chip on the highlighted window — stacked windows are otherwise very
+    // hard to tell apart once the rest of the screen is dimmed.
+    Rectangle {
+        id: chip
+        visible: root.hovered !== null
+        x: (root.hovered ? root.hovered.x - root.originX : 0) + 12
+        y: (root.hovered ? root.hovered.y - root.originY : 0) + 12
+        implicitWidth: Math.min(chipText.implicitWidth + 24, root.hovered ? root.hovered.w - 24 : 0)
+        implicitHeight: 32
+        radius: Theme.pillRadius
+        border.width: 0
+        color: Theme.alpha(Theme.bgPopover, Theme.popoverAlpha)
+
+        Text {
+            id: chipText
+            anchors.centerIn: parent
+            width: chip.width - 24
+            text: root.hovered ? (root.hovered.title || root.hovered.appId) : ""
+            color: Theme.fg
+            elide: Text.ElideRight
+            horizontalAlignment: Text.AlignHCenter
+            font.family: Theme.fontFamily
+            font.pixelSize: Theme.fontSizeSmall
+        }
+    }
+
+    // Shown when hyprctl gave us nothing — a blank dimmed screen with no
+    // explanation would just look broken.
+    Text {
+        anchors.centerIn: parent
+        visible: root.windows.length === 0
+        text: "No windows to capture on this workspace"
+        color: Theme.fgDim
+        font.family: Theme.fontFamily
+        font.pixelSize: Theme.fontSizeLarge
+    }
+
+    MouseArea {
+        id: area
+        anchors.fill: parent
+        hoverEnabled: true
+        cursorShape: root.hovered ? Qt.PointingHandCursor : Qt.ArrowCursor
+        onClicked: {
+            if (root.hovered)
+                root.picked();
+        }
+    }
+}

config/dot/quickshell/modules/clipboard/ClipboardEntry.qml

@@ -0,0 +1,171 @@
+// One row of clipboard history: what was copied, where it came from, and how
+// long ago. Clicking it puts the entry back on the clipboard.
+//
+// Rows are cards on an already-glass surface, so they get no prism edge — the
+// hairline marks a pane of glass, not every item sitting on one.
+
+import QtQuick
+import qs.config
+import qs.services
+
+Rectangle {
+    id: root
+
+    required property var entry
+
+    signal activated
+
+    implicitHeight: Math.max(52, body.implicitHeight + 18)
+
+    radius: Theme.cardRadius
+    // border.width: 0 works around QTBUG-137166, where transparent rounded
+    // rectangles can render with holes at the corners.
+    border.width: 0
+
+    color: {
+        if (mouse.pressed)
+            return Theme.alpha(Theme.accent, Theme.activeAlpha);
+        if (mouse.containsMouse)
+            return Theme.alpha(Theme.fg, Theme.hoverAlpha);
+        return "transparent";
+    }
+
+    // Fast in, relaxed out — the row should feel like it answers the pointer
+    // rather than fading after it.
+    Behavior on color {
+        ColorAnimation {
+            duration: mouse.containsMouse ? Theme.durFast : Theme.durNormal
+            easing.type: Easing.OutQuad
+        }
+    }
+
+    // Nerd Font glyph for the kind of thing that was copied. Text is the common
+    // case and gets the quietest icon, so the odd link or image stands out.
+    readonly property string kindGlyph: {
+        switch (root.entry.kind) {
+        case Clipboard.kindLink:
+            return "\u{F0C1}";   // nf-fa-link
+        case Clipboard.kindImage:
+            return "\u{F03E}";   // nf-fa-picture_o
+        case Clipboard.kindFile:
+            return "\u{F016}";   // nf-fa-file_o
+        default:
+            return "\u{F15C}";   // nf-fa-file_text_o
+        }
+    }
+
+    // Where it came from. Vicinae leaves `source` empty for clients it cannot
+    // attribute (anything pasted by a script, for one), in which case a link's
+    // host is more informative than nothing.
+    readonly property string origin: root.entry.source || root.entry.host || ""
+
+    Text {
+        id: glyph
+        anchors.left: parent.left
+        anchors.leftMargin: 12
+        anchors.top: parent.top
+        anchors.topMargin: 11
+        text: root.entry.encrypted ? "\u{F023}" : root.kindGlyph
+        // fontMono is the Nerd Font, used here only to draw an icon.
+        font.family: Theme.fontMono
+        font.pixelSize: 14
+        color: root.entry.pinned ? Theme.accent : Theme.fgMuted
+    }
+
+    Column {
+        id: body
+        anchors.left: glyph.right
+        anchors.leftMargin: 10
+        anchors.right: timeLabel.left
+        anchors.rightMargin: 10
+        anchors.verticalCenter: parent.verticalCenter
+        spacing: 3
+
+        Text {
+            width: parent.width
+            text: root.entry.encrypted ? "Concealed by Vicinae" : root.entry.preview
+            color: root.entry.encrypted ? Theme.fgMuted : Theme.fg
+            font.family: Theme.fontFamily
+            font.pixelSize: Theme.fontSize
+            font.italic: root.entry.encrypted
+            wrapMode: Text.Wrap
+            maximumLineCount: 2
+            elide: Text.ElideRight
+        }
+
+        Row {
+            spacing: 6
+            visible: chip.visible || originLabel.visible
+
+            // Images and file drags have no text worth reading, so the type is
+            // spelled out rather than left to the glyph alone.
+            Rectangle {
+                id: chip
+                visible: !root.entry.textual
+                width: chipLabel.implicitWidth + 12
+                height: chipLabel.implicitHeight + 4
+                radius: 4
+                border.width: 0
+                color: Theme.alpha(Theme.fg, 0.10)
+
+                Text {
+                    id: chipLabel
+                    anchors.centerIn: parent
+                    text: root.entry.typeLabel
+                    color: Theme.fgDim
+                    font.family: Theme.fontFamily
+                    font.pixelSize: Theme.fontSizeSmall
+                    font.weight: Font.Medium
+                }
+            }
+
+            Text {
+                id: originLabel
+                anchors.verticalCenter: chip.verticalCenter
+                visible: root.origin !== ""
+                text: root.origin
+                color: Theme.fgMuted
+                font.family: Theme.fontFamily
+                font.pixelSize: Theme.fontSizeSmall
+                elide: Text.ElideRight
+            }
+        }
+    }
+
+    Row {
+        id: timeLabel
+        anchors.right: parent.right
+        anchors.rightMargin: 12
+        anchors.top: parent.top
+        anchors.topMargin: 11
+        spacing: 5
+
+        Text {
+            anchors.verticalCenter: parent.verticalCenter
+            visible: root.entry.pinned
+            text: "\u{F0403}"   // nf-md-pin
+            font.family: Theme.fontMono
+            font.pixelSize: 11
+            color: Theme.accent
+        }
+
+        Text {
+            anchors.verticalCenter: parent.verticalCenter
+            text: Clipboard.relativeTime(root.entry.ts)
+            color: Theme.fgMuted
+            font.family: Theme.fontFamily
+            // The list is full of these stacked in a column; tabular figures
+            // keep them from stepping sideways row to row.
+            font.features: Theme.tabularFigures
+            font.pixelSize: Theme.fontSizeSmall
+        }
+    }
+
+    MouseArea {
+        id: mouse
+        anchors.fill: parent
+        hoverEnabled: true
+        cursorShape: Qt.PointingHandCursor
+        onClicked: root.activated()
+    }
+}

config/dot/quickshell/modules/clipboard/ClipboardPanel.qml

@@ -0,0 +1,230 @@
+// Clipboard history, backed by Vicinae's existing database. Opening the panel
+// performs one read-only query; nothing polls or repaints while it is closed.
+
+import QtQuick
+import Quickshell
+import Quickshell.Wayland
+import Quickshell.Hyprland
+import qs.config
+import qs.services
+import qs.widgets
+import qs.modules.quicksettings
+
+PanelWindow {
+    id: root
+
+    visible: ShellState.clipboardOpen
+    color: "transparent"
+
+    anchors {
+        top: true
+        right: true
+    }
+    margins {
+        top: Theme.barHeight + Theme.barGap * 2
+        right: Theme.barSideMargin
+    }
+
+    exclusiveZone: 0
+    implicitWidth: 430
+    implicitHeight: 550
+
+    WlrLayershell.namespace: "qs-popover-clipboard"
+    WlrLayershell.layer: WlrLayer.Overlay
+    WlrLayershell.keyboardFocus: WlrKeyboardFocus.OnDemand
+
+    property string filter: ""
+
+    readonly property var filteredEntries: Clipboard.entries.filter(entry => {
+        const needle = root.filter.trim().toLowerCase();
+        if (!needle)
+            return true;
+        return [entry.preview, entry.source, entry.host, entry.typeLabel]
+            .join(" ").toLowerCase().includes(needle);
+    })
+
+    function close(): void {
+        ShellState.close();
+    }
+
+    function activateFirst(): void {
+        if (root.filteredEntries.length === 0)
+            return;
+        Clipboard.copyEntry(root.filteredEntries[0].id);
+        root.close();
+    }
+
+    onVisibleChanged: {
+        if (root.visible) {
+            root.filter = "";
+            search.clear();
+            Clipboard.refresh();
+            openAnim.restart();
+            Qt.callLater(search.grab);
+        }
+    }
+
+    HyprlandFocusGrab {
+        windows: [root]
+        active: root.visible
+        onCleared: root.close()
+    }
+
+    Rectangle {
+        id: surface
+        anchors.fill: parent
+        radius: Theme.popoverRadius
+        color: Theme.alpha(Theme.bgPopover, Theme.popoverAlpha)
+        border.width: 1
+        border.color: Theme.alpha(Theme.fg, 0.08)
+
+        PrismEdge {
+            anchors {
+                top: parent.top
+                left: parent.left
+                right: parent.right
+                topMargin: 1
+            }
+            inset: parent.radius
+        }
+
+        transform: Scale {
+            id: openScale
+            origin.x: surface.width
+            origin.y: 0
+            xScale: 1
+            yScale: 1
+        }
+
+        Column {
+            anchors.fill: parent
+            anchors.margins: Theme.popoverPadding
+            spacing: Theme.sectionSpacing
+
+            Item {
+                width: parent.width
+                height: 30
+
+                Row {
+                    anchors.left: parent.left
+                    anchors.verticalCenter: parent.verticalCenter
+                    spacing: 9
+
+                    ThemedIcon {
+                        anchors.verticalCenter: parent.verticalCenter
+                        size: 17
+                        icon: "edit-paste-symbolic"
+                        iconFallback: "edit-copy-symbolic"
+                        tint: Theme.accent
+                    }
+
+                    Text {
+                        anchors.verticalCenter: parent.verticalCenter
+                        text: "Clipboard"
+                        color: Theme.fg
+                        font.family: Theme.fontFamily
+                        font.pixelSize: Theme.fontSizeTitle
+                        font.weight: Font.DemiBold
+                    }
+                }
+
+                Text {
+                    anchors.right: parent.right
+                    anchors.verticalCenter: parent.verticalCenter
+                    text: Clipboard.entries.length === 1
+                        ? "1 item"
+                        : Clipboard.entries.length + " items"
+                    color: Theme.fgMuted
+                    font.family: Theme.fontFamily
+                    font.features: Theme.tabularFigures
+                    font.pixelSize: Theme.fontSizeSmall
+                }
+            }
+
+            SearchField {
+                id: search
+                width: parent.width
+                placeholder: "Search clipboard history"
+                onTextChanged: root.filter = text
+                onAccepted: root.activateFirst()
+                onDismissed: root.close()
+            }
+
+            Rectangle {
+                width: parent.width
+                height: 1
+                border.width: 0
+                color: Theme.alpha(Theme.fg, 0.1)
+            }
+
+            Item {
+                width: parent.width
+                height: parent.height - y
+
+                Text {
+                    anchors.centerIn: parent
+                    visible: Clipboard.loading
+                    text: "Loading clipboard history…"
+                    color: Theme.fgMuted
+                    font.family: Theme.fontFamily
+                    font.pixelSize: Theme.fontSize
+                }
+
+                Text {
+                    anchors.centerIn: parent
+                    width: parent.width - 40
+                    visible: !Clipboard.loading && !Clipboard.available
+                    horizontalAlignment: Text.AlignHCenter
+                    wrapMode: Text.Wrap
+                    text: "Clipboard history is unavailable. Start Vicinae to restore it."
+                    color: Theme.fgMuted
+                    font.family: Theme.fontFamily
+                    font.pixelSize: Theme.fontSize
+                }
+
+                Text {
+                    anchors.centerIn: parent
+                    visible: !Clipboard.loading && Clipboard.available
+                             && root.filteredEntries.length === 0
+                    text: root.filter ? "No matching clipboard items" : "Nothing copied yet"
+                    color: Theme.fgMuted
+                    font.family: Theme.fontFamily
+                    font.pixelSize: Theme.fontSize
+                }
+
+                ScrollColumn {
+                    anchors.fill: parent
+                    maxHeight: parent.height
+                    spacing: 4
+                    visible: !Clipboard.loading && Clipboard.available
+                             && root.filteredEntries.length > 0
+
+                    Repeater {
+                        model: root.filteredEntries
+
+                        ClipboardEntry {
+                            required property var modelData
+
+                            width: parent.width
+                            entry: modelData
+                            onActivated: {
+                                Clipboard.copyEntry(modelData.id);
+                                root.close();
+                            }
+                        }
+                    }
+                }
+            }
+        }
+    }
+
+    NumberAnimation {
+        id: openAnim
+        target: openScale
+        property: "yScale"
+        from: 0.96
+        to: 1
+        duration: Theme.durFast
+        easing.type: Easing.OutCubic
+    }
+}

config/dot/quickshell/modules/clipboard/ClipboardWidget.qml

@@ -0,0 +1,24 @@
+// The bar entry for clipboard history. The icon is intentionally familiar and
+// quiet: the history itself is a utility, not another permanent status readout.
+
+import QtQuick
+import qs.config
+import qs.services
+import qs.widgets
+
+Pill {
+    id: root
+
+    implicitWidth: 30
+    implicitHeight: 28
+
+    onActivated: ShellState.toggle("clipboard")
+
+    ThemedIcon {
+        anchors.verticalCenter: parent.verticalCenter
+        size: 16
+        icon: "edit-paste-symbolic"
+        iconFallback: "edit-copy-symbolic"
+        tint: ShellState.clipboardOpen ? Theme.accent : Theme.fg
+    }
+}

config/dot/quickshell/modules/clipboard/SearchField.qml

@@ -0,0 +1,86 @@
+// The filter box at the top of the clipboard popover. Nothing is submitted:
+// the text is read live and narrows the list that is already loaded, which is
+// how GNOME's own search entries behave.
+
+import QtQuick
+import qs.config
+
+Rectangle {
+    id: root
+
+    property alias text: input.text
+    property string placeholder: "Search"
+
+    signal accepted
+    signal dismissed
+
+    implicitHeight: 32
+    radius: Theme.pillRadius
+    // border.width is set below rather than left at 0, so the focus ring has
+    // something to change. See QTBUG-137166 for why 0 matters elsewhere.
+    color: Theme.alpha(Theme.fg, 0.07)
+    border.width: 1
+    border.color: input.activeFocus ? Theme.alpha(Theme.accent, 0.55) : "transparent"
+
+    Behavior on border.color {
+        ColorAnimation {
+            duration: Theme.durFast
+        }
+    }
+
+    function clear(): void {
+        input.text = "";
+    }
+
+    function grab(): void {
+        input.forceActiveFocus();
+    }
+
+    Text {
+        id: glyph
+        anchors.left: parent.left
+        anchors.leftMargin: 12
+        anchors.verticalCenter: parent.verticalCenter
+        text: "\u{F002}"   // nf-fa-search — fontMono is the Nerd Font, icon only
+        font.family: Theme.fontMono
+        font.pixelSize: 12
+        color: input.activeFocus ? Theme.accent : Theme.fgMuted
+    }
+
+    TextInput {
+        id: input
+        anchors.left: glyph.right
+        anchors.leftMargin: 9
+        anchors.right: parent.right
+        anchors.rightMargin: 12
+        anchors.verticalCenter: parent.verticalCenter
+
+        color: Theme.fg
+        selectionColor: Theme.alpha(Theme.accent, 0.5)
+        selectedTextColor: Theme.fg
+        font.family: Theme.fontFamily
+        font.pixelSize: Theme.fontSize
+        clip: true
+
+        onAccepted: root.accepted()
+
+        // Escape clears a non-empty filter first and only closes the popover on
+        // a second press — losing a typed query to a stray Escape is worse than
+        // one extra keystroke.
+        Keys.onEscapePressed: {
+            if (input.text !== "")
+                input.text = "";
+            else
+                root.dismissed();
+        }
+
+        Text {
+            anchors.fill: parent
+            verticalAlignment: Text.AlignVCenter
+            visible: input.text === ""
+            text: root.placeholder
+            color: Theme.fgMuted
+            font: input.font
+        }
+    }
+}

config/dot/quickshell/modules/clipboard/qmldir

@@ -0,0 +1,5 @@
+module qs.modules.clipboard
+ClipboardEntry 1.0 ClipboardEntry.qml
+ClipboardPanel 1.0 ClipboardPanel.qml
+ClipboardWidget 1.0 ClipboardWidget.qml
+SearchField 1.0 SearchField.qml

config/dot/quickshell/modules/datemenu/AgendaEvent.qml

@@ -0,0 +1,128 @@
+import QtQuick
+import qs.config
+import qs.services
+
+Item {
+    id: root
+
+    required property var eventData
+    property bool past: false
+
+    signal activated
+    signal joinRequested
+
+    readonly property var sourceData: CalendarAgenda.sourceForId(eventData.sourceId)
+    readonly property color eventColor: sourceData?.color ?? Theme.accent
+    readonly property string timeText: eventData.allDay
+        ? "All day"
+        : Qt.formatTime(new Date(Number(eventData.start) * 1000), Settings.use24Hour ? "HH:mm" : "h:mm AP")
+    readonly property string detailText: {
+        const source = root.sourceData?.name ?? "Calendar";
+        const location = String(root.eventData.location ?? "").trim();
+        return location === "" ? source : source + " · " + location;
+    }
+
+    implicitHeight: 58
+    opacity: past ? 0.52 : 1
+
+    Rectangle {
+        anchors.fill: parent
+        radius: 9
+        border.width: 0
+        color: rowMouse.containsMouse ? Theme.alpha(Theme.fg, 0.07) : "transparent"
+
+        Behavior on color { ColorAnimation { duration: Theme.durFast } }
+    }
+
+    MouseArea {
+        id: rowMouse
+        anchors.fill: parent
+        hoverEnabled: true
+        cursorShape: Qt.PointingHandCursor
+        onClicked: root.activated()
+    }
+
+    Text {
+        id: timeLabel
+        anchors.left: parent.left
+        anchors.verticalCenter: parent.verticalCenter
+        width: 56
+        text: root.timeText
+        color: Theme.fgDim
+        horizontalAlignment: Text.AlignRight
+        font.family: Theme.fontFamily
+        font.features: Theme.tabularFigures
+        font.pixelSize: Theme.fontSizeSmall
+    }
+
+    Rectangle {
+        id: sourceRail
+        anchors.left: timeLabel.right
+        anchors.leftMargin: 10
+        anchors.verticalCenter: parent.verticalCenter
+        width: 3
+        height: 34
+        radius: 2
+        border.width: 0
+        color: root.eventColor
+    }
+
+    Column {
+        anchors.left: sourceRail.right
+        anchors.leftMargin: 10
+        anchors.right: joinPill.visible ? joinPill.left : parent.right
+        anchors.rightMargin: joinPill.visible ? 10 : 4
+        anchors.verticalCenter: parent.verticalCenter
+        spacing: 3
+
+        Text {
+            width: parent.width
+            text: root.eventData.summary || "Untitled event"
+            color: Theme.fg
+            elide: Text.ElideRight
+            font.family: Theme.fontFamily
+            font.pixelSize: Theme.fontSize
+            font.weight: Font.DemiBold
+        }
+
+        Text {
+            width: parent.width
+            text: root.detailText
+            color: Theme.fgDim
+            elide: Text.ElideRight
+            font.family: Theme.fontFamily
+            font.pixelSize: Theme.fontSizeSmall
+        }
+    }
+
+    Rectangle {
+        id: joinPill
+        anchors.right: parent.right
+        anchors.rightMargin: 4
+        anchors.verticalCenter: parent.verticalCenter
+        visible: String(root.eventData.joinUrl ?? "").startsWith("https://")
+        width: joinLabel.implicitWidth + 18
+        height: 26
+        radius: Theme.pillRadius
+        border.width: 0
+        color: joinMouse.containsMouse ? Theme.alpha(Theme.accent, 0.28) : Theme.alpha(Theme.accent, 0.14)
+
+        Text {
+            id: joinLabel
+            anchors.centerIn: parent
+            text: "Join"
+            color: Theme.accent
+            font.family: Theme.fontFamily
+            font.pixelSize: Theme.fontSizeSmall
+            font.weight: Font.DemiBold
+        }
+
+        MouseArea {
+            id: joinMouse
+            anchors.fill: parent
+            hoverEnabled: true
+            cursorShape: Qt.PointingHandCursor
+            onClicked: root.joinRequested()
+        }
+    }
+}

config/dot/quickshell/modules/datemenu/AgendaPane.qml

@@ -0,0 +1,292 @@
+import QtQuick
+import Quickshell
+import qs.config
+import qs.services
+import qs.modules.quicksettings
+
+Item {
+    id: root
+
+    readonly property bool isToday: CalendarAgenda.selectedDateKey === CalendarAgenda.dateKey(clock.date)
+    readonly property var upNext: CalendarAgenda.nextEventForSelectedDate
+    readonly property var listedEvents: CalendarAgenda.selectedEvents.filter(event => !root.upNext || event.id !== root.upNext.id)
+    readonly property string selectedLabel: root.isToday
+        ? "Today"
+        : Qt.formatDate(CalendarAgenda.selectedDate, "dddd, MMMM d")
+
+    implicitHeight: content.implicitHeight
+
+    SystemClock {
+        id: clock
+        precision: SystemClock.Minutes
+    }
+
+    Column {
+        id: content
+        width: parent.width
+        spacing: 12
+
+        Column {
+            width: parent.width
+            spacing: 3
+            visible: CalendarAgenda.phase === "loading"
+
+            Text {
+                text: "CALENDAR"
+                color: Theme.fgMuted
+                font.family: Theme.fontFamily
+                font.pixelSize: Theme.fontSizeSmall
+                font.weight: Font.DemiBold
+                font.letterSpacing: 1.1
+            }
+            Text {
+                text: "Loading calendars…"
+                color: Theme.fgDim
+                font.family: Theme.fontFamily
+                font.pixelSize: Theme.fontSizeLarge
+                font.weight: Font.DemiBold
+            }
+        }
+
+        Column {
+            width: parent.width
+            spacing: 10
+            visible: CalendarAgenda.phase === "unavailable"
+
+            Text {
+                text: "Calendar data is unavailable"
+                color: Theme.fg
+                font.family: Theme.fontFamily
+                font.pixelSize: Theme.fontSizeLarge
+                font.weight: Font.DemiBold
+            }
+            Text {
+                width: parent.width
+                wrapMode: Text.WordWrap
+                text: "Notifications, weather, and the month grid are still available. GNOME Calendar may have more detail."
+                color: Theme.fgDim
+                font.family: Theme.fontFamily
+                font.pixelSize: Theme.fontSize
+            }
+            ActionPill {
+                text: "Open Calendar"
+                onClicked: CalendarAgenda.openCalendar(CalendarAgenda.selectedDate)
+            }
+        }
+
+        Rectangle {
+            id: nextCard
+            width: parent.width
+            height: visible ? 88 : 0
+            visible: CalendarAgenda.available && root.isToday && root.upNext !== null
+            radius: Theme.cardRadius
+            border.width: 1
+            border.color: Theme.alpha(Theme.accent, 0.18)
+            color: Theme.alpha(Theme.accent, 0.105)
+            clip: true
+
+            Rectangle {
+                anchors.right: parent.right
+                anchors.rightMargin: -24
+                anchors.bottom: parent.bottom
+                anchors.bottomMargin: -34
+                width: 110
+                height: 110
+                radius: 55
+                border.width: 0
+                color: Theme.alpha(Theme.accentSecondary, 0.08)
+            }
+
+            Column {
+                anchors.left: parent.left
+                anchors.leftMargin: 14
+                anchors.right: nextJoin.visible ? nextJoin.left : parent.right
+                anchors.rightMargin: nextJoin.visible ? 10 : 14
+                anchors.verticalCenter: parent.verticalCenter
+                spacing: 5
+
+                Text {
+                    text: "UP NEXT · " + root.relativeStart(root.upNext)
+                    color: Theme.accent
+                    font.family: Theme.fontFamily
+                    font.features: Theme.tabularFigures
+                    font.pixelSize: Theme.fontSizeSmall
+                    font.weight: Font.Bold
+                    font.letterSpacing: 0.8
+                }
+                Text {
+                    width: parent.width
+                    text: root.upNext?.summary ?? ""
+                    color: Theme.fg
+                    elide: Text.ElideRight
+                    font.family: Theme.fontFamily
+                    font.pixelSize: Theme.fontSizeLarge
+                    font.weight: Font.DemiBold
+                }
+                Text {
+                    width: parent.width
+                    text: root.eventDetail(root.upNext)
+                    color: Theme.fgDim
+                    elide: Text.ElideRight
+                    font.family: Theme.fontFamily
+                    font.pixelSize: Theme.fontSizeSmall
+                }
+            }
+
+            ActionPill {
+                id: nextJoin
+                anchors.right: parent.right
+                anchors.rightMargin: 12
+                anchors.top: parent.top
+                anchors.topMargin: 12
+                visible: String(root.upNext?.joinUrl ?? "").startsWith("https://")
+                text: "Join"
+                accent: true
+                onClicked: CalendarAgenda.join(root.upNext)
+            }
+
+            MouseArea {
+                anchors.fill: parent
+                z: -1
+                cursorShape: Qt.PointingHandCursor
+                onClicked: CalendarAgenda.openEvent(root.upNext)
+            }
+        }
+
+        Item {
+            width: parent.width
+            height: 34
+            visible: CalendarAgenda.available
+
+            Column {
+                anchors.left: parent.left
+                anchors.verticalCenter: parent.verticalCenter
+                spacing: 2
+
+                Text {
+                    text: root.selectedLabel.toUpperCase()
+                    color: Theme.fgMuted
+                    font.family: Theme.fontFamily
+                    font.pixelSize: Theme.fontSizeSmall
+                    font.weight: Font.DemiBold
+                    font.letterSpacing: 0.9
+                }
+                Text {
+                    text: "Your schedule"
+                    color: Theme.fg
+                    font.family: Theme.fontFamily
+                    font.pixelSize: Theme.fontSizeLarge
+                    font.weight: Font.DemiBold
+                }
+            }
+
+            Text {
+                anchors.right: parent.right
+                anchors.bottom: parent.bottom
+                text: CalendarAgenda.selectedEvents.length + (CalendarAgenda.selectedEvents.length === 1 ? " event" : " events")
+                color: Theme.fgDim
+                font.family: Theme.fontFamily
+                font.features: Theme.tabularFigures
+                font.pixelSize: Theme.fontSizeSmall
+            }
+        }
+
+        Item {
+            width: parent.width
+            height: visible ? 92 : 0
+            visible: CalendarAgenda.available && CalendarAgenda.selectedEvents.length === 0
+
+            Column {
+                anchors.centerIn: parent
+                spacing: 8
+
+                Text {
+                    anchors.horizontalCenter: parent.horizontalCenter
+                    text: "Nothing scheduled"
+                    color: Theme.fgDim
+                    font.family: Theme.fontFamily
+                    font.pixelSize: Theme.fontSize
+                }
+                ActionPill {
+                    anchors.horizontalCenter: parent.horizontalCenter
+                    text: "Open Calendar"
+                    onClicked: CalendarAgenda.openCalendar(CalendarAgenda.selectedDate)
+                }
+            }
+        }
+
+        ScrollColumn {
+            width: parent.width
+            maxHeight: 286
+            spacing: 0
+            visible: CalendarAgenda.available && root.listedEvents.length > 0
+
+            Repeater {
+                model: root.listedEvents
+
+                AgendaEvent {
+                    required property var modelData
+
+                    width: parent.width
+                    eventData: modelData
+                    past: Number(modelData.end) <= CalendarAgenda.nowEpoch
+                    onActivated: CalendarAgenda.openEvent(modelData)
+                    onJoinRequested: CalendarAgenda.join(modelData)
+                }
+            }
+        }
+
+    }
+
+    function relativeStart(event: var): string {
+        if (!event)
+            return "";
+        const seconds = Number(event.start) - CalendarAgenda.nowEpoch;
+        if (seconds <= 0)
+            return "NOW";
+        if (seconds < 3600)
+            return "IN " + Math.ceil(seconds / 60) + " MINUTES";
+        return Qt.formatTime(new Date(Number(event.start) * 1000), Settings.use24Hour ? "HH:mm" : "h:mm AP");
+    }
+
+    function eventDetail(event: var): string {
+        if (!event)
+            return "";
+        const source = CalendarAgenda.sourceForId(event.sourceId)?.name ?? "Calendar";
+        const location = String(event.location ?? "").trim();
+        return location === "" ? source : source + " · " + location;
+    }
+
+    component ActionPill: Rectangle {
+        id: action
+
+        required property string text
+        property bool accent: false
+        signal clicked
+
+        width: actionLabel.implicitWidth + 20
+        height: 28
+        radius: Theme.pillRadius
+        border.width: 0
+        color: actionMouse.containsMouse
+            ? Theme.alpha(action.accent ? Theme.accent : Theme.fg, 0.24)
+            : Theme.alpha(action.accent ? Theme.accent : Theme.fg, action.accent ? 0.14 : 0.07)
+
+        Text {
+            id: actionLabel
+            anchors.centerIn: parent
+            text: action.text
+            color: action.accent ? Theme.accent : Theme.fg
+            font.family: Theme.fontFamily
+            font.pixelSize: Theme.fontSizeSmall
+            font.weight: Font.DemiBold
+        }
+        MouseArea {
+            id: actionMouse
+            anchors.fill: parent
+            hoverEnabled: true
+            cursorShape: Qt.PointingHandCursor
+            onClicked: action.clicked()
+        }
+    }
+}

config/dot/quickshell/modules/datemenu/CalendarGrid.qml

@@ -0,0 +1,281 @@
+// The month grid from GNOME's date menu.
+//
+// Six week rows always, so the grid height never changes as you page through
+// months and the panel below it never jumps. Days belonging to the neighbouring
+// months fill the edges, dimmed. Today wears the accent.
+//
+// Days become real navigation targets now that Evolution Data Server backs the
+// panel. Up to three source-coloured markers show whether a date has events.
+
+import Quickshell
+import QtQuick
+import qs.config
+import qs.services
+
+Item {
+    id: root
+
+    signal dateActivated(date value)
+    signal visibleMonthChanged(int year, int month)
+
+    implicitHeight: body.implicitHeight
+
+    // Cells divide the available width evenly; the height is fixed so the grid
+    // stays roughly square regardless of how wide the panel gets.
+    readonly property real cellWidth: root.width / 7
+    readonly property int cellHeight: 32
+
+    // Hours precision is enough: the only thing that has to change on its own
+    // is which cell counts as "today", and that only moves at midnight.
+    SystemClock {
+        id: clock
+        precision: SystemClock.Hours
+    }
+
+    readonly property int todayYear: clock.date.getFullYear()
+    readonly property int todayMonth: clock.date.getMonth()
+    readonly property int todayDay: clock.date.getDate()
+
+    // The month currently on screen. DateMenu calls showToday() every time the
+    // panel opens, so it never comes back showing wherever you paged off to.
+    property int viewYear: root.todayYear
+    property int viewMonth: root.todayMonth
+    property date selectedDate: CalendarAgenda.selectedDate
+
+    readonly property bool onCurrentMonth: root.viewYear === root.todayYear && root.viewMonth === root.todayMonth
+
+    function showToday(): void {
+        root.viewYear = root.todayYear;
+        root.viewMonth = root.todayMonth;
+    }
+
+    function stepMonth(delta: int): void {
+        // Built through Date rather than by hand so December -> January rolls
+        // the year over for us.
+        const d = new Date(root.viewYear, root.viewMonth + delta, 1);
+        root.viewYear = d.getFullYear();
+        root.viewMonth = d.getMonth();
+    }
+
+    function activateCell(model: var): void {
+        if (!model.current) {
+            root.viewYear = model.date.getFullYear();
+            root.viewMonth = model.date.getMonth();
+        }
+        root.dateActivated(model.date);
+    }
+
+    onViewYearChanged: root.visibleMonthChanged(root.viewYear, root.viewMonth)
+    onViewMonthChanged: root.visibleMonthChanged(root.viewYear, root.viewMonth)
+
+    readonly property var cells: {
+        const first = new Date(root.viewYear, root.viewMonth, 1);
+        const offset = first.getDay(); // 0 = Sunday, matching the header row
+
+        const out = [];
+        for (let i = 0; i < 42; i++) {
+            const date = new Date(root.viewYear, root.viewMonth, i - offset + 1);
+            out.push({
+                date: date,
+                day: date.getDate(),
+                current: date.getMonth() === root.viewMonth && date.getFullYear() === root.viewYear
+            });
+        }
+        return out;
+    }
+
+    Column {
+        id: body
+        anchors.left: parent.left
+        anchors.right: parent.right
+        anchors.top: parent.top
+        spacing: 6
+
+        // ── Month header ────────────────────────────────────────────────────
+        // Both arrows sit on the right so the left slot is free for the "Today"
+        // affordance, which only exists while you are looking at another month.
+        Item {
+            width: parent.width
+            height: 30
+
+            Rectangle {
+                id: todayPill
+                anchors.left: parent.left
+                anchors.verticalCenter: parent.verticalCenter
+                width: todayLabel.implicitWidth + 18
+                height: 24
+                radius: Theme.pillRadius
+                border.width: 0
+                visible: !root.onCurrentMonth
+                color: todayMouse.containsMouse ? Theme.alpha(Theme.accent, 0.30) : Theme.alpha(Theme.accent, 0.16)
+
+                Behavior on color {
+                    ColorAnimation {
+                        duration: todayMouse.containsMouse ? Theme.durFast : Theme.durNormal
+                    }
+                }
+
+                Text {
+                    id: todayLabel
+                    anchors.centerIn: parent
+                    text: "Today"
+                    color: Theme.accent
+                    font.family: Theme.fontFamily
+                    font.pixelSize: Theme.fontSizeSmall
+                    font.weight: Font.Medium
+                }
+
+                MouseArea {
+                    id: todayMouse
+                    anchors.fill: parent
+                    hoverEnabled: true
+                    cursorShape: Qt.PointingHandCursor
+                    onClicked: root.showToday()
+                }
+            }
+
+            // Centred on the row rather than between the pill and the arrows,
+            // so it does not shift sideways when the pill appears.
+            Text {
+                anchors.centerIn: parent
+                text: Qt.formatDateTime(new Date(root.viewYear, root.viewMonth, 1), "MMMM yyyy")
+                font.family: Theme.fontFamily
+                // The year ticks in place when you page across a boundary.
+                font.features: Theme.tabularFigures
+                font.pixelSize: Theme.fontSizeLarge
+                font.weight: Font.DemiBold
+                color: Theme.fg
+            }
+
+            Row {
+                anchors.right: parent.right
+                anchors.verticalCenter: parent.verticalCenter
+                spacing: 2
+
+                MonthArrow {
+                    glyph: "\u{F0141}"   // md-chevron_left
+                    onActivated: root.stepMonth(-1)
+                }
+
+                MonthArrow {
+                    glyph: "\u{F0142}"   // md-chevron_right
+                    onActivated: root.stepMonth(1)
+                }
+            }
+        }
+
+        // ── Weekday header ──────────────────────────────────────────────────
+        Row {
+            width: parent.width
+
+            Repeater {
+                model: ["S", "M", "T", "W", "T", "F", "S"]
+
+                delegate: Text {
+                    required property string modelData
+
+                    width: root.cellWidth
+                    height: 22
+                    text: modelData
+                    horizontalAlignment: Text.AlignHCenter
+                    verticalAlignment: Text.AlignVCenter
+                    font.family: Theme.fontFamily
+                    font.pixelSize: Theme.fontSizeSmall
+                    font.weight: Font.Medium
+                    color: Theme.fgMuted
+                }
+            }
+        }
+
+        // ── Day grid ────────────────────────────────────────────────────────
+        Grid {
+            width: parent.width
+            columns: 7
+
+            Repeater {
+                model: root.cells
+
+                delegate: Item {
+                    id: cell
+
+                    required property var modelData
+
+                    readonly property bool isToday: cell.modelData.current && cell.modelData.day === root.todayDay && root.onCurrentMonth
+                    readonly property bool isSelected: CalendarAgenda.dateKey(cell.modelData.date) === CalendarAgenda.dateKey(root.selectedDate)
+                    readonly property var markers: CalendarAgenda.markersForDate(cell.modelData.date).slice(0, 3)
+
+                    width: root.cellWidth
+                    height: root.cellHeight
+
+                    Rectangle {
+                        anchors.centerIn: parent
+                        width: root.cellHeight - 4
+                        height: root.cellHeight - 4
+                        radius: width / 2
+                        border.width: 0
+                        visible: cell.isToday || cell.isSelected || cellMouse.containsMouse
+                        color: {
+                            if (cell.isToday)
+                                return Theme.accent;
+                            if (cell.isSelected)
+                                return Theme.alpha(Theme.accent, 0.20);
+                            return Theme.alpha(Theme.fg, 0.08);
+                        }
+
+                        Behavior on color {
+                            ColorAnimation { duration: Theme.durFast }
+                        }
+                    }
+
+                    Text {
+                        anchors.centerIn: parent
+                        text: cell.modelData.day
+                        font.family: Theme.fontFamily
+                        font.features: Theme.tabularFigures
+                        font.pixelSize: Theme.fontSize
+                        font.weight: cell.isToday ? Font.DemiBold : Font.Normal
+
+                        color: {
+                            if (cell.isToday)
+                                return Theme.bgDark;
+                            if (cell.isSelected)
+                                return Theme.accent;
+                            return cell.modelData.current ? Theme.fg : Theme.fgMuted;
+                        }
+                    }
+
+                    Row {
+                        anchors.horizontalCenter: parent.horizontalCenter
+                        anchors.bottom: parent.bottom
+                        anchors.bottomMargin: 1
+                        spacing: 2
+
+                        Repeater {
+                            model: cell.markers
+
+                            Rectangle {
+                                required property var modelData
+
+                                width: 3
+                                height: 3
+                                radius: 2
+                                border.width: 0
+                                color: cell.isToday ? Theme.bgDark : modelData.color
+                            }
+                        }
+                    }
+
+                    MouseArea {
+                        id: cellMouse
+                        anchors.fill: parent
+                        hoverEnabled: true
+                        cursorShape: Qt.PointingHandCursor
+                        onClicked: root.activateCell(cell.modelData)
+                    }
+                }
+            }
+        }
+    }
+
+    Component.onCompleted: root.visibleMonthChanged(root.viewYear, root.viewMonth)
+}

config/dot/quickshell/modules/datemenu/DateMenu.qml

@@ -0,0 +1,122 @@
+// GNOME's date/time menu: calendar, ongoing activity and messages in one panel,
+// dropping from the top centre because that is where GNOME put it and the
+// muscle memory is the whole point.
+//
+// A layer-shell surface rather than a PopupWindow because the inline reply
+// fields have to be typeable, and because the clock it hangs from is owned by a
+// different module.
+//
+// Layer-shell centres a surface on whichever axis it is not anchored to, so
+// anchoring only `top` is what puts it in the middle.
+
+import QtQuick
+import Quickshell
+import Quickshell.Wayland
+import Quickshell.Hyprland
+import qs.config
+import qs.services
+import qs.widgets
+
+PanelWindow {
+    id: root
+
+    readonly property bool ongoingContentFits: panel.ongoingContentFits
+
+    // "notifications" remains the overlay key so existing keybinds keep their
+    // contract; the surface itself now has Agenda, Ongoing and Notifications.
+    visible: ShellState.notificationsOpen
+    color: "transparent"
+
+    anchors.top: true
+    margins.top: Theme.barHeight + Theme.barGap * 2
+    exclusiveZone: 0
+
+    implicitWidth: 760
+    implicitHeight: panel.implicitHeight
+
+    // The `qs-popover` prefix is matched by a layerrule in hypr/rules.lua.
+    WlrLayershell.namespace: "qs-popover-datemenu"
+    WlrLayershell.layer: WlrLayer.Overlay
+    // OnDemand rather than Exclusive: the panel must be able to take typing for
+    // inline replies, but must not steal it while merely visible.
+    WlrLayershell.keyboardFocus: WlrKeyboardFocus.OnDemand
+
+    onVisibleChanged: {
+        if (root.visible) {
+            CalendarAgenda.refresh();
+            if (ShellState.dateMenuPage === "notifications")
+                Notifs.markAllRead();
+            panel.prepare(ShellState.dateMenuPage);
+            openAnim.restart();
+        } else {
+            panel.reset();
+        }
+    }
+
+    Connections {
+        target: ShellState
+        function onDateMenuPageChanged(): void {
+            if (root.visible && ShellState.dateMenuPage === "notifications")
+                Notifs.markAllRead();
+        }
+    }
+
+    // Closes the panel when a click lands anywhere else on the desktop.
+    HyprlandFocusGrab {
+        windows: [root]
+        active: root.visible
+        onCleared: ShellState.close()
+    }
+
+    Rectangle {
+        id: surface
+        anchors.fill: parent
+        radius: Theme.popoverRadius
+        color: Theme.alpha(Theme.bgPopover, Theme.popoverAlpha)
+        border.width: 1
+        border.color: Theme.alpha(Theme.fg, 0.08)
+
+        // The prism edge — see widgets/PrismEdge.qml. Sits just inside the 1px
+        // border so the two don't fight for the same row of pixels.
+        PrismEdge {
+            anchors.top: parent.top
+            anchors.topMargin: 1
+            anchors.left: parent.left
+            anchors.right: parent.right
+            inset: parent.radius
+        }
+
+        // Grows out of the top edge it is anchored to, rather than out of its
+        // own centre — the panel should look like it came from the bar.
+        transform: Scale {
+            id: openScale
+            origin.x: surface.width / 2
+            origin.y: 0
+            xScale: 1
+            yScale: 1
+        }
+
+        // Escape reaches here by propagating up from whatever holds focus
+        // (usually a reply field), so it works in every sub-state.
+        Item {
+            anchors.fill: parent
+            focus: true
+            Keys.onEscapePressed: ShellState.close()
+
+            DateMenuPanel {
+                id: panel
+                anchors.fill: parent
+            }
+        }
+    }
+
+    NumberAnimation {
+        id: openAnim
+        target: openScale
+        property: "yScale"
+        from: 0.94
+        to: 1.0
+        duration: Theme.durNormal
+        easing.type: Easing.OutCubic
+    }
+}

config/dot/quickshell/modules/datemenu/DateMenuPanel.qml

@@ -0,0 +1,319 @@
+// The approved A · Daybook: month context on the left, the selected day's
+// schedule, persistent activity or grouped notification history on the right.
+
+import QtQuick
+import Quickshell
+import qs.config
+import qs.services
+import qs.widgets
+
+Item {
+    id: root
+
+    implicitWidth: 760
+    implicitHeight: frame.implicitHeight + Theme.popoverPadding * 2
+
+    function prepare(page: string): void {
+        calendar.showToday();
+        CalendarAgenda.selectDate(clock.date);
+        CalendarAgenda.setVisibleMonth(clock.date.getFullYear(), clock.date.getMonth());
+        if (page === "notifications")
+            Notifs.markAllRead();
+    }
+
+    function reset(): void {
+        notifications.reset();
+    }
+
+    SystemClock {
+        id: clock
+        precision: SystemClock.Minutes
+    }
+
+    Column {
+        id: frame
+        anchors.left: parent.left
+        anchors.right: parent.right
+        anchors.top: parent.top
+        anchors.margins: Theme.popoverPadding
+        spacing: 0
+
+        Item {
+            id: header
+            width: parent.width
+            height: 42
+
+            Text {
+                anchors.left: parent.left
+                anchors.leftMargin: 4
+                anchors.right: dateMenuTabs.left
+                anchors.rightMargin: Theme.itemSpacing
+                anchors.verticalCenter: parent.verticalCenter
+                text: Qt.formatDateTime(clock.date, "dddd, MMMM d")
+                color: Theme.fg
+                elide: Text.ElideRight
+                font.family: Theme.fontFamily
+                font.features: Theme.tabularFigures
+                font.pixelSize: Theme.fontSizeTitle
+                font.weight: Font.DemiBold
+            }
+
+            Row {
+                id: dateMenuTabs
+                anchors.right: parent.right
+                anchors.verticalCenter: parent.verticalCenter
+                spacing: 6
+
+                HeaderPill {
+                    text: "Agenda"
+                    active: ShellState.dateMenuPage === "agenda"
+                    onClicked: ShellState.dateMenuPage = "agenda"
+                }
+
+                HeaderPill {
+                    text: "Ongoing"
+                    active: ShellState.dateMenuPage === "ongoing"
+                    badge: Ongoing.count
+                    onClicked: ShellState.dateMenuPage = "ongoing"
+                }
+
+                HeaderPill {
+                    text: "Notifications"
+                    active: ShellState.dateMenuPage === "notifications"
+                    badge: Notifs.history.length
+                    onClicked: ShellState.dateMenuPage = "notifications"
+                }
+
+                HeaderPill {
+                    visible: ShellState.dateMenuPage === "agenda"
+                    text: "Calendar  ↗"
+                    onClicked: CalendarAgenda.openCalendar(CalendarAgenda.selectedDate)
+                }
+            }
+        }
+
+        Rectangle {
+            width: parent.width
+            height: 1
+            border.width: 0
+            color: Theme.alpha(Theme.fg, 0.10)
+        }
+
+        Row {
+            id: body
+            width: parent.width
+            height: Math.min(620, Math.max(438, leftContent.implicitHeight + 28, rightContentHeight + 28))
+
+            Item {
+                id: leftColumn
+                width: 310
+                height: body.height
+
+                Column {
+                    id: leftContent
+                    anchors.left: parent.left
+                    anchors.right: parent.right
+                    anchors.top: parent.top
+                    anchors.margins: 14
+                    spacing: 12
+
+                    CalendarGrid {
+                        id: calendar
+                        width: parent.width
+                        selectedDate: CalendarAgenda.selectedDate
+                        onDateActivated: date => CalendarAgenda.selectDate(date)
+                        onVisibleMonthChanged: (year, month) => CalendarAgenda.setVisibleMonth(year, month)
+                    }
+
+                    Rectangle {
+                        width: parent.width
+                        height: 1
+                        border.width: 0
+                        visible: media.visible || Weather.available
+                        color: Theme.alpha(Theme.fg, 0.08)
+                    }
+
+                    MediaCard {
+                        id: media
+                        width: parent.width
+                    }
+
+                    WeatherCard {
+                        width: parent.width
+                        visible: Weather.available
+                    }
+                }
+            }
+
+            Rectangle {
+                width: 1
+                height: body.height
+                border.width: 0
+                color: Theme.alpha(Theme.fg, 0.10)
+            }
+
+            Item {
+                id: rightColumn
+                width: body.width - leftColumn.width - 1
+                height: body.height
+
+                readonly property real availableWidth: width - 28
+
+                AgendaPane {
+                    id: agenda
+                    anchors.left: parent.left
+                    anchors.right: parent.right
+                    anchors.top: parent.top
+                    anchors.margins: 14
+                    visible: ShellState.dateMenuPage === "agenda"
+                }
+
+                OngoingPane {
+                    id: ongoingPane
+                    anchors.left: parent.left
+                    anchors.right: parent.right
+                    anchors.top: parent.top
+                    anchors.margins: 14
+                    maxHeight: body.height - 28
+                    visible: ShellState.dateMenuPage === "ongoing"
+                }
+
+                Column {
+                    id: notificationPane
+                    anchors.left: parent.left
+                    anchors.right: parent.right
+                    anchors.top: parent.top
+                    anchors.margins: 14
+                    spacing: 10
+                    visible: ShellState.dateMenuPage === "notifications"
+
+                    Item {
+                        width: parent.width
+                        height: 28
+
+                        Text {
+                            anchors.left: parent.left
+                            anchors.right: notificationActions.left
+                            anchors.rightMargin: 8
+                            anchors.verticalCenter: parent.verticalCenter
+                            text: "Notifications"
+                            color: Theme.fg
+                            font.family: Theme.fontFamily
+                            font.pixelSize: Theme.fontSizeLarge
+                            font.weight: Font.DemiBold
+                        }
+
+                        Row {
+                            id: notificationActions
+                            anchors.right: parent.right
+                            anchors.verticalCenter: parent.verticalCenter
+                            spacing: 6
+
+                            HeaderPill {
+                                text: "Do Not Disturb"
+                                active: Notifs.doNotDisturb
+                                icon: "notifications-disabled-symbolic"
+                                onClicked: Notifs.doNotDisturb = !Notifs.doNotDisturb
+                            }
+
+                            HeaderPill {
+                                visible: Notifs.hasNotifications
+                                text: "Clear all"
+                                onClicked: Notifs.dismissAll()
+                            }
+                        }
+                    }
+
+                    NotificationList {
+                        id: notifications
+                        width: parent.width
+                        maxHeight: body.height - 76
+                    }
+                }
+            }
+        }
+    }
+
+    readonly property real rightContentHeight: {
+        if (ShellState.dateMenuPage === "notifications")
+            return notificationPane.implicitHeight;
+        if (ShellState.dateMenuPage === "ongoing")
+            return ongoingPane.implicitHeight;
+        return agenda.implicitHeight;
+    }
+    readonly property bool ongoingContentFits: ongoingPane.implicitHeight <= body.height - 28
+
+    component HeaderPill: Rectangle {
+        id: pill
+
+        required property string text
+        property string icon: ""
+        property bool active: false
+        property int badge: -1
+        signal clicked
+
+        width: pillRow.implicitWidth + 20
+        height: 28
+        radius: Theme.pillRadius
+        border.width: 0
+        color: {
+            if (pill.active)
+                return pillMouse.containsMouse ? Theme.alpha(Theme.accent, 0.38) : Theme.alpha(Theme.accent, 0.24);
+            return pillMouse.containsMouse ? Theme.alpha(Theme.fg, 0.15) : Theme.alpha(Theme.fg, 0.07);
+        }
+
+        Behavior on color { ColorAnimation { duration: Theme.durFast } }
+
+        Row {
+            id: pillRow
+            anchors.centerIn: parent
+            spacing: 6
+
+            ThemedIcon {
+                anchors.verticalCenter: parent.verticalCenter
+                visible: pill.icon !== ""
+                size: visible ? 14 : 0
+                icon: pill.icon
+                tint: pill.active ? Theme.accent : Theme.fgDim
+            }
+
+            Text {
+                anchors.verticalCenter: parent.verticalCenter
+                text: pill.text
+                color: pill.active ? Theme.accent : Theme.fg
+                font.family: Theme.fontFamily
+                font.pixelSize: Theme.fontSizeSmall
+                font.weight: Font.Medium
+            }
+
+            Rectangle {
+                anchors.verticalCenter: parent.verticalCenter
+                visible: pill.badge > 0
+                width: visible ? badgeText.implicitWidth + 9 : 0
+                height: 17
+                radius: Theme.pillRadius
+                border.width: 0
+                color: Theme.alpha(pill.active ? Theme.accent : Theme.fg, 0.12)
+
+                Text {
+                    id: badgeText
+                    anchors.centerIn: parent
+                    text: String(pill.badge)
+                    color: pill.active ? Theme.accent : Theme.fgDim
+                    font.family: Theme.fontFamily
+                    font.features: Theme.tabularFigures
+                    font.pixelSize: 9
+                    font.weight: Font.DemiBold
+                }
+            }
+        }
+
+        MouseArea {
+            id: pillMouse
+            anchors.fill: parent
+            hoverEnabled: true
+            cursorShape: Qt.PointingHandCursor
+            onClicked: pill.clicked()
+        }
+    }
+}

config/dot/quickshell/modules/datemenu/MediaCard.qml

@@ -0,0 +1,152 @@
+// Compact media controls in the date menu: artwork, useful metadata, and the
+// three controls people expect. It disappears completely without a track.
+
+import QtQuick
+import Quickshell.Services.Mpris
+import qs.config
+import qs.widgets
+
+Rectangle {
+    id: root
+
+    readonly property bool compact: width < 360
+
+    readonly property MprisPlayer player: {
+        const players = Mpris.players ? Mpris.players.values : [];
+        return players.find(p => p.isPlaying) ?? players.find(p => p.trackTitle) ?? null;
+    }
+
+    visible: root.player !== null
+    implicitHeight: visible ? (compact ? 64 : 76) : 0
+    radius: Theme.cardRadius
+    border.width: 0
+    color: Theme.alpha(Theme.fg, 0.06)
+    clip: true
+
+    Rectangle {
+        id: artwork
+        anchors.left: parent.left
+        anchors.leftMargin: root.compact ? 8 : 10
+        anchors.verticalCenter: parent.verticalCenter
+        width: root.compact ? 46 : 56
+        height: width
+        radius: root.compact ? 9 : 10
+        border.width: 0
+        color: Theme.alpha(Theme.accentAlt, 0.16)
+        clip: true
+
+        Image {
+            anchors.fill: parent
+            source: root.player?.trackArtUrl ?? ""
+            asynchronous: true
+            cache: true
+            fillMode: Image.PreserveAspectCrop
+            visible: status === Image.Ready
+        }
+
+        ThemedIcon {
+            anchors.centerIn: parent
+            size: 24
+            icon: "audio-x-generic-symbolic"
+            iconFallback: "multimedia-player-symbolic"
+            tint: Theme.accentAlt
+            visible: !root.player?.trackArtUrl
+        }
+    }
+
+    Column {
+        anchors.left: artwork.right
+        anchors.leftMargin: root.compact ? 9 : 12
+        anchors.right: controls.left
+        anchors.rightMargin: root.compact ? 6 : 10
+        anchors.verticalCenter: parent.verticalCenter
+        spacing: 3
+
+        Text {
+            width: parent.width
+            text: root.player?.trackTitle || "Unknown track"
+            color: Theme.fg
+            elide: Text.ElideRight
+            font.family: Theme.fontFamily
+            font.pixelSize: Theme.fontSize
+            font.weight: Font.DemiBold
+        }
+
+        Text {
+            width: parent.width
+            text: root.player?.trackArtist || root.player?.identity || "Media"
+            color: Theme.fgDim
+            elide: Text.ElideRight
+            font.family: Theme.fontFamily
+            font.pixelSize: Theme.fontSizeSmall
+        }
+    }
+
+    Row {
+        id: controls
+        anchors.right: parent.right
+        anchors.rightMargin: root.compact ? 7 : 10
+        anchors.verticalCenter: parent.verticalCenter
+        spacing: 2
+
+        MediaButton {
+            icon: "media-skip-backward-symbolic"
+            enabled: root.player?.canGoPrevious ?? false
+            onClicked: root.player?.previous()
+        }
+
+        MediaButton {
+            icon: root.player?.isPlaying ? "media-playback-pause-symbolic" : "media-playback-start-symbolic"
+            enabled: root.player?.canTogglePlaying ?? false
+            emphasized: true
+            onClicked: root.player?.togglePlaying()
+        }
+
+        MediaButton {
+            icon: "media-skip-forward-symbolic"
+            enabled: root.player?.canGoNext ?? false
+            onClicked: root.player?.next()
+        }
+    }
+
+    component MediaButton: Rectangle {
+        id: button
+
+        required property string icon
+        property bool emphasized: false
+        signal clicked
+
+        width: root.compact ? (emphasized ? 30 : 27) : (emphasized ? 34 : 30)
+        height: width
+        radius: width / 2
+        border.width: 0
+        opacity: enabled ? 1 : 0.35
+        color: {
+            if (mouse.pressed)
+                return Theme.alpha(emphasized ? Theme.accent : Theme.fg, 0.34);
+            if (mouse.containsMouse)
+                return Theme.alpha(emphasized ? Theme.accent : Theme.fg, 0.22);
+            return emphasized ? Theme.alpha(Theme.accent, 0.14) : "transparent";
+        }
+
+        Behavior on color {
+            ColorAnimation { duration: Theme.durFast }
+        }
+
+        ThemedIcon {
+            anchors.centerIn: parent
+            size: 15
+            icon: button.icon
+            tint: button.emphasized ? Theme.accent : Theme.fg
+        }
+
+        MouseArea {
+            id: mouse
+            anchors.fill: parent
+            enabled: button.enabled
+            hoverEnabled: true
+            cursorShape: button.enabled ? Qt.PointingHandCursor : Qt.ArrowCursor
+            onClicked: button.clicked()
+        }
+    }
+}

config/dot/quickshell/modules/datemenu/MonthArrow.qml

@@ -0,0 +1,45 @@
+// Month-stepping arrow in CalendarGrid's header. A round hover target sized
+// like GNOME's calendar arrows rather than a bare glyph, so it reads as a
+// button before the pointer is anywhere near it.
+
+import QtQuick
+import qs.config
+
+Rectangle {
+    id: root
+
+    signal activated
+
+    required property string glyph
+
+    implicitWidth: 26
+    implicitHeight: 26
+    radius: width / 2
+    border.width: 0
+    color: mouse.containsMouse ? Theme.alpha(Theme.fg, Theme.hoverAlpha) : "transparent"
+
+    // Fast in, relaxed out — the arrow answers the pointer, so arriving should
+    // feel immediate and leaving should not snap.
+    Behavior on color {
+        ColorAnimation {
+            duration: mouse.containsMouse ? Theme.durFast : Theme.durNormal
+        }
+    }
+
+    Text {
+        anchors.centerIn: parent
+        text: root.glyph
+        // fontMono is the Nerd Font: used here to draw an icon, never text.
+        font.family: Theme.fontMono
+        font.pixelSize: Theme.fontSize
+        color: mouse.containsMouse ? Theme.fg : Theme.fgDim
+    }
+
+    MouseArea {
+        id: mouse
+        anchors.fill: parent
+        hoverEnabled: true
+        cursorShape: Qt.PointingHandCursor
+        onClicked: root.activated()
+    }
+}

config/dot/quickshell/modules/datemenu/NotificationGroup.qml

@@ -0,0 +1,172 @@
+// One app's worth of notifications in the date menu, GNOME-style: a header
+// carrying the app's identity and a clear button, over a collapsible stack of
+// cards.
+//
+// The header is the disclosure control in its entirety — a 4px chevron is a
+// poor click target, and GNOME lets you hit the whole row.
+
+import QtQuick
+import Quickshell
+import Quickshell.Widgets
+import qs.config
+import qs.services
+import qs.modules.notifications
+import qs.modules.quicksettings
+import qs.widgets
+
+Column {
+    id: root
+
+    // One entry from Notifs.groups: { app, icon, desktopEntry, items }.
+    required property var group
+
+    property bool expanded: true
+
+    signal toggled
+    signal cleared
+
+    spacing: 4
+
+    // The app icon the notifications themselves declared, falling back to the
+    // desktop entry — same resolution order NotificationCard uses.
+    readonly property string iconSource: {
+        if (root.group.icon)
+            return Quickshell.iconPath(root.group.icon, true);
+        const entry = DesktopEntries.byId(root.group.desktopEntry);
+        return entry ? Quickshell.iconPath(entry.icon, true) : "";
+    }
+
+    Rectangle {
+        id: header
+        width: parent.width
+        height: 28
+        radius: Theme.cardRadius - 4
+        border.width: 0
+        color: headerMouse.containsMouse ? Theme.alpha(Theme.fg, 0.07) : "transparent"
+
+        Behavior on color {
+            ColorAnimation {
+                duration: headerMouse.containsMouse ? Theme.durFast : Theme.durNormal
+            }
+        }
+
+        MouseArea {
+            id: headerMouse
+            anchors.fill: parent
+            hoverEnabled: true
+            cursorShape: Qt.PointingHandCursor
+            onClicked: root.toggled()
+        }
+
+        Row {
+            anchors.left: parent.left
+            anchors.leftMargin: 6
+            anchors.right: clearButton.left
+            anchors.rightMargin: 6
+            anchors.verticalCenter: parent.verticalCenter
+            spacing: 7
+
+            IconImage {
+                anchors.verticalCenter: parent.verticalCenter
+                implicitSize: 15
+                asynchronous: true
+                source: root.iconSource
+                visible: source !== ""
+            }
+
+            Text {
+                anchors.verticalCenter: parent.verticalCenter
+                text: root.group.app
+                color: Theme.fgDim
+                elide: Text.ElideRight
+                font.family: Theme.fontFamily
+                font.pixelSize: Theme.fontSizeSmall
+                font.weight: Font.DemiBold
+            }
+
+            // A bare count next to a collapsed group is the only way to know
+            // how much is hidden, so it is always shown once there is more
+            // than one.
+            Rectangle {
+                anchors.verticalCenter: parent.verticalCenter
+                width: countLabel.implicitWidth + 12
+                height: 16
+                radius: Theme.pillRadius
+                border.width: 0
+                visible: root.group.items.length > 1
+                color: Theme.alpha(Theme.fg, 0.12)
+
+                Text {
+                    id: countLabel
+                    anchors.centerIn: parent
+                    text: root.group.items.length
+                    color: Theme.fgDim
+                    font.family: Theme.fontFamily
+                    font.features: Theme.tabularFigures
+                    font.pixelSize: Theme.fontSizeSmall
+                }
+            }
+        }
+
+        IconButton {
+            id: clearButton
+            anchors.right: chevron.left
+            anchors.rightMargin: 2
+            anchors.verticalCenter: parent.verticalCenter
+            size: 22
+            iconSize: 12
+            tint: Theme.fgMuted
+            icon: "edit-clear-all-symbolic"
+            iconFallback: "window-close-symbolic"
+            onClicked: root.cleared()
+        }
+
+        ThemedIcon {
+            id: chevron
+            anchors.right: parent.right
+            anchors.rightMargin: 6
+            anchors.verticalCenter: parent.verticalCenter
+            size: 12
+            icon: "pan-down-symbolic"
+            iconFallback: "go-down-symbolic"
+            tint: Theme.fgMuted
+
+            // Pointing down when open, right when closed — the standard
+            // disclosure direction, animated only on the click that caused it.
+            rotation: root.expanded ? 0 : -90
+
+            Behavior on rotation {
+                NumberAnimation {
+                    duration: Theme.durNormal
+                    easing.type: Easing.OutCubic
+                }
+            }
+        }
+    }
+
+    // Section animates its own height and hides itself at zero, which also
+    // collapses the spacing the parent Column would otherwise leave behind.
+    Section {
+        width: parent.width
+        expanded: root.expanded
+
+        Column {
+            anchors.left: parent.left
+            anchors.right: parent.right
+            spacing: 4
+
+            Repeater {
+                model: root.group.items
+
+                NotificationCard {
+                    required property var modelData
+
+                    width: parent.width
+                    compact: true
+                    notification: modelData
+                    onDismissed: Notifs.dismiss(modelData)
+                }
+            }
+        }
+    }
+}

config/dot/quickshell/modules/datemenu/NotificationList.qml

@@ -0,0 +1,73 @@
+// The message tray inside the date menu: everything that has arrived, newest
+// first, grouped by app, scrolling once it outgrows `maxHeight`.
+
+import QtQuick
+import qs.config
+import qs.services
+import qs.modules.quicksettings
+
+Item {
+    id: root
+
+    property int maxHeight: 420
+
+    implicitHeight: Notifs.hasNotifications ? list.implicitHeight : empty.implicitHeight
+
+    // Which app groups are collapsed, keyed by app name. Kept here rather than
+    // on the group itself because Notifs.groups is rebuilt from scratch on
+    // every change to history, which destroys and recreates the delegates.
+    property var collapsedApps: ({})
+
+    function toggleApp(app: string): void {
+        // Reassigned rather than mutated: a property holding a JS object only
+        // re-evaluates bindings when the reference itself changes.
+        const next = Object.assign({}, root.collapsedApps);
+        if (next[app])
+            delete next[app];
+        else
+            next[app] = true;
+        root.collapsedApps = next;
+    }
+
+    // Called when the panel closes, so it always reopens fully expanded.
+    function reset(): void {
+        root.collapsedApps = ({});
+    }
+
+    Item {
+        id: empty
+        anchors.fill: parent
+        implicitHeight: 132
+        visible: !Notifs.hasNotifications
+
+        Text {
+            anchors.centerIn: parent
+            text: Notifs.doNotDisturb ? "Do Not Disturb is on" : "No notifications"
+            color: Theme.fgMuted
+            font.family: Theme.fontFamily
+            font.pixelSize: Theme.fontSize
+        }
+    }
+
+    ScrollColumn {
+        id: list
+        anchors.fill: parent
+        maxHeight: root.maxHeight
+        spacing: Theme.itemSpacing
+        visible: Notifs.hasNotifications
+
+        Repeater {
+            model: Notifs.groups
+
+            NotificationGroup {
+                required property var modelData
+
+                width: list.width
+                group: modelData
+                expanded: !root.collapsedApps[modelData.app]
+                onToggled: root.toggleApp(modelData.app)
+                onCleared: Notifs.dismissApp(modelData.app)
+            }
+        }
+    }
+}

config/dot/quickshell/modules/datemenu/NotificationSummary.qml

@@ -0,0 +1,58 @@
+import QtQuick
+import qs.config
+import qs.services
+
+Rectangle {
+    id: root
+
+    signal activated
+
+    visible: Notifs.hasNotifications
+    implicitHeight: visible ? 62 : 0
+    radius: Theme.cardRadius
+    border.width: 0
+    color: summaryMouse.containsMouse ? Theme.alpha(Theme.fg, 0.10) : Theme.alpha(Theme.fg, 0.055)
+
+    Behavior on color { ColorAnimation { duration: Theme.durFast } }
+
+    Column {
+        anchors.left: parent.left
+        anchors.leftMargin: 14
+        anchors.verticalCenter: parent.verticalCenter
+        spacing: 3
+
+        Text {
+            text: Notifs.history.length + (Notifs.history.length === 1 ? " notification" : " notifications")
+            color: Theme.fg
+            font.family: Theme.fontFamily
+            font.pixelSize: Theme.fontSize
+            font.weight: Font.DemiBold
+        }
+
+        Text {
+            text: "Grouped quietly until you open them"
+            color: Theme.fgDim
+            font.family: Theme.fontFamily
+            font.pixelSize: Theme.fontSizeSmall
+        }
+    }
+
+    Text {
+        anchors.right: parent.right
+        anchors.rightMargin: 14
+        anchors.verticalCenter: parent.verticalCenter
+        text: "View  →"
+        color: Theme.fgDim
+        font.family: Theme.fontFamily
+        font.pixelSize: Theme.fontSizeSmall
+        font.weight: Font.Medium
+    }
+
+    MouseArea {
+        id: summaryMouse
+        anchors.fill: parent
+        hoverEnabled: true
+        cursorShape: Qt.PointingHandCursor
+        onClicked: root.activated()
+    }
+}

config/dot/quickshell/modules/datemenu/OngoingPane.qml

@@ -0,0 +1,263 @@
+// Persistent work and privacy activity inside the Daybook.
+
+import QtQuick
+import qs.config
+import qs.services
+import qs.modules.quicksettings
+
+Item {
+    id: root
+
+    property real maxHeight: 500
+    implicitHeight: content.implicitHeight
+
+    Column {
+        id: content
+        width: parent.width
+        spacing: 12
+
+        Item {
+            width: parent.width
+            height: 38
+
+            Column {
+                anchors.left: parent.left
+                anchors.verticalCenter: parent.verticalCenter
+                spacing: 2
+
+                Text {
+                    text: "PERSISTENT ACTIVITY"
+                    color: Theme.fgMuted
+                    font.family: Theme.fontFamily
+                    font.pixelSize: Theme.fontSizeSmall
+                    font.weight: Font.DemiBold
+                    font.letterSpacing: 0.9
+                }
+                Text {
+                    text: "Ongoing"
+                    color: Theme.fg
+                    font.family: Theme.fontFamily
+                    font.pixelSize: Theme.fontSizeLarge
+                    font.weight: Font.DemiBold
+                }
+            }
+
+            Text {
+                anchors.right: parent.right
+                anchors.bottom: parent.bottom
+                text: Ongoing.count === 0 ? "Nothing active" : Ongoing.count + (Ongoing.count === 1 ? " activity" : " activities")
+                color: Theme.fgDim
+                font.family: Theme.fontFamily
+                font.features: Theme.tabularFigures
+                font.pixelSize: Theme.fontSizeSmall
+            }
+        }
+
+        Item {
+            width: parent.width
+            height: visible ? 190 : 0
+            visible: Ongoing.count === 0
+
+            Column {
+                anchors.centerIn: parent
+                spacing: 8
+
+                Text {
+                    anchors.horizontalCenter: parent.horizontalCenter
+                    text: "\u{F04A5}"
+                    color: Theme.fgMuted
+                    font.family: Theme.fontMono
+                    font.pixelSize: 24
+                }
+                Text {
+                    anchors.horizontalCenter: parent.horizontalCenter
+                    text: "Nothing ongoing"
+                    color: Theme.fg
+                    font.family: Theme.fontFamily
+                    font.pixelSize: Theme.fontSize
+                    font.weight: Font.DemiBold
+                }
+                Text {
+                    anchors.horizontalCenter: parent.horizontalCenter
+                    text: "Focus, Caffeine, recording and privacy activity appear here."
+                    color: Theme.fgDim
+                    font.family: Theme.fontFamily
+                    font.pixelSize: Theme.fontSizeSmall
+                }
+            }
+        }
+
+        ScrollColumn {
+            width: parent.width
+            // Header + footer + the two 12px Column gaps consume 116px.
+            // Keeping that outside the scroll budget prevents the pane from
+            // growing beyond the Daybook when every producer is active.
+            maxHeight: Math.max(0, root.maxHeight - 116)
+            spacing: 8
+            visible: Ongoing.count > 0
+
+            Repeater {
+                model: Ongoing.activities
+
+                Rectangle {
+                    id: activityRow
+                    required property var modelData
+
+                    width: parent.width
+                    height: 62
+                    radius: Theme.cardRadius
+                    border.width: 0
+                    color: rowMouse.containsMouse
+                        ? Theme.alpha(Theme.fg, 0.10)
+                        : Theme.alpha(Theme.fg, 0.055)
+
+                    Behavior on color { ColorAnimation { duration: Theme.durFast } }
+
+                    Text {
+                        id: activityIcon
+                        anchors.left: parent.left
+                        anchors.leftMargin: 13
+                        anchors.verticalCenter: parent.verticalCenter
+                        text: activityRow.modelData.glyph
+                        color: root.toneColor(activityRow.modelData.tone)
+                        font.family: Theme.fontMono
+                        font.pixelSize: 17
+                    }
+
+                    Column {
+                        anchors.left: activityIcon.right
+                        anchors.leftMargin: 11
+                        anchors.right: activityAction.visible ? activityAction.left : activityState.left
+                        anchors.rightMargin: 10
+                        anchors.verticalCenter: parent.verticalCenter
+                        spacing: 3
+
+                        Text {
+                            width: parent.width
+                            text: activityRow.modelData.label
+                            color: Theme.fg
+                            elide: Text.ElideRight
+                            font.family: Theme.fontFamily
+                            font.pixelSize: Theme.fontSize
+                            font.weight: Font.DemiBold
+                        }
+                        Text {
+                            width: parent.width
+                            text: activityRow.modelData.detail
+                            color: Theme.fgDim
+                            elide: Text.ElideRight
+                            font.family: Theme.fontFamily
+                            font.pixelSize: Theme.fontSizeSmall
+                        }
+                    }
+
+                    Rectangle {
+                        id: activityState
+                        anchors.right: activityAction.visible ? activityAction.left : parent.right
+                        anchors.rightMargin: activityAction.visible ? 7 : 12
+                        anchors.verticalCenter: parent.verticalCenter
+                        width: stateLabel.implicitWidth + 16
+                        height: 25
+                        radius: Theme.pillRadius
+                        border.width: 0
+                        color: Theme.alpha(root.toneColor(activityRow.modelData.tone), 0.12)
+
+                        Text {
+                            id: stateLabel
+                            anchors.centerIn: parent
+                            text: activityRow.modelData.state
+                            color: root.toneColor(activityRow.modelData.tone)
+                            font.family: Theme.fontFamily
+                            font.features: Theme.tabularFigures
+                            font.pixelSize: Theme.fontSizeSmall
+                            font.weight: Font.DemiBold
+                        }
+                    }
+
+                    Rectangle {
+                        id: activityAction
+                        z: 2
+                        anchors.right: parent.right
+                        anchors.rightMargin: 9
+                        anchors.verticalCenter: parent.verticalCenter
+                        visible: activityRow.modelData.action !== ""
+                        width: visible ? actionLabel.implicitWidth + 18 : 0
+                        height: 28
+                        radius: Theme.pillRadius
+                        border.width: 0
+                        color: actionMouse.containsMouse
+                            ? Theme.alpha(activityRow.modelData.tone === "danger" ? Theme.danger : Theme.fg, 0.20)
+                            : Theme.alpha(activityRow.modelData.tone === "danger" ? Theme.danger : Theme.fg, 0.08)
+
+                        Text {
+                            id: actionLabel
+                            anchors.centerIn: parent
+                            text: activityRow.modelData.action
+                            color: activityRow.modelData.tone === "danger" ? Theme.danger : Theme.fg
+                            font.family: Theme.fontFamily
+                            font.pixelSize: Theme.fontSizeSmall
+                            font.weight: Font.Medium
+                        }
+
+                        MouseArea {
+                            id: actionMouse
+                            anchors.fill: parent
+                            hoverEnabled: true
+                            cursorShape: Qt.PointingHandCursor
+                            onClicked: Ongoing.invoke(activityRow.modelData.kind)
+                        }
+                    }
+
+                    MouseArea {
+                        id: rowMouse
+                        anchors.fill: parent
+                        z: 1
+                        enabled: activityRow.modelData.kind !== "caffeine"
+                        hoverEnabled: enabled
+                        cursorShape: enabled ? Qt.PointingHandCursor : Qt.ArrowCursor
+                        onClicked: Ongoing.activate(activityRow.modelData.kind)
+                    }
+                }
+            }
+        }
+
+        Rectangle {
+            width: parent.width
+            height: 54
+            radius: Theme.cardRadius
+            border.width: 0
+            visible: Ongoing.count > 0
+            color: Theme.alpha(Theme.fg, 0.035)
+
+            Column {
+                anchors.left: parent.left
+                anchors.leftMargin: 13
+                anchors.verticalCenter: parent.verticalCenter
+                spacing: 3
+                Text {
+                    text: "Visible until it ends"
+                    color: Theme.fg
+                    font.family: Theme.fontFamily
+                    font.pixelSize: Theme.fontSizeSmall
+                    font.weight: Font.DemiBold
+                }
+                Text {
+                    text: "Completed screenshots, devices and other brief events stay in Signal Glass."
+                    color: Theme.fgDim
+                    font.family: Theme.fontFamily
+                    font.pixelSize: Theme.fontSizeSmall
+                }
+            }
+        }
+    }
+
+    function toneColor(tone: string): color {
+        if (tone === "danger")
+            return Theme.danger;
+        if (tone === "warn")
+            return Theme.warn;
+        if (tone === "ok")
+            return Theme.ok;
+        return Theme.accent;
+    }
+}

config/dot/quickshell/modules/datemenu/WeatherCard.qml

@@ -0,0 +1,65 @@
+// Current conditions, at the foot of the date menu — GNOME's weather section.
+//
+// The whole card disappears when services/Weather.qml has nothing: a weather
+// widget that cannot reach the network must go quiet, not show an error. The
+// caller collapses the separator above it off the same `Weather.available`.
+
+import QtQuick
+import qs.config
+import qs.services
+
+Rectangle {
+    id: root
+
+    implicitHeight: 62
+    radius: Theme.cardRadius
+    // Cards inside an already-glass panel do not get a prism edge — the edge
+    // marks a pane of glass, not every item sitting on one.
+    border.width: 0
+    color: Theme.alpha(Theme.fg, 0.06)
+
+    Text {
+        id: glyph
+        anchors.left: parent.left
+        anchors.leftMargin: 16
+        anchors.verticalCenter: parent.verticalCenter
+        text: Weather.icon
+        // fontMono is the Nerd Font, used here purely to draw an icon.
+        font.family: Theme.fontMono
+        font.pixelSize: 26
+        color: Theme.accentAlt
+    }
+
+    Column {
+        anchors.left: glyph.right
+        anchors.leftMargin: 14
+        anchors.right: parent.right
+        anchors.rightMargin: 16
+        anchors.verticalCenter: parent.verticalCenter
+        spacing: 2
+
+        Text {
+            width: parent.width
+            text: Math.round(Weather.temperature) + Weather.unitSuffix
+            color: Theme.fg
+            elide: Text.ElideRight
+            font.family: Theme.fontFamily
+            // The temperature changes in place on every refresh.
+            font.features: Theme.tabularFigures
+            font.pixelSize: Theme.fontSizeLarge
+            font.weight: Font.DemiBold
+        }
+
+        Text {
+            width: parent.width
+            // Description is empty for weather codes we don't have a label for,
+            // in which case the row is just the location.
+            text: Weather.description === "" ? Settings.weatherLocation : Weather.description + " · " + Settings.weatherLocation
+            color: Theme.fgDim
+            elide: Text.ElideRight
+            font.family: Theme.fontFamily
+            font.features: Theme.tabularFigures
+            font.pixelSize: Theme.fontSizeSmall
+        }
+    }
+}