Guide
Every group that has a recording and is not already in the introduction, rendered from fixtures, so the numbers are made up. The shell also has groups for the clock, disks, GPU, network interfaces, power, the system tray, systemd units and a few more, which look and behave the same way.
Widgets that look alike share one recording, with the others listed in a table below it. The compute page shows a group in its menu next to the same group pinned in the bar. The looks have a page of their own.
Group menus
Most groups live in menus behind a single icon on a panel. Pressing the icon opens the menu: one row per group, with settings that share a unit lined up in a table above them. Hovering a row opens the group’s items in a panel beside it, pressing it opens them at once, and hovering an item’s info icon there shows its card. A menu stays open until a press anywhere outside it, on any monitor, a press on its icon or Escape; while it is open, hovering or pressing another menu icon switches to that menu. Menus open downward from the top panel and upward from the bottom panel.
The pin on a row puts that group back on the panel, next to its menu icon; a pin on one of the group’s items puts only that item there. The unpin button in its card returns it to the menu. Pins are remembered across restarts. A group whose alert reaches group_menus.alert_promotion_severity also shows on the panel until the alert clears.
The Menus group in the Behaviour menu changes how every menu opens. Menus can open from their icon on hover instead of on press, and such a menu closes when the pointer leaves it. In an accordion, pressing a row opens the group’s items below it, and several groups can stay open.
| Menu | Panel | Groups |
|---|---|---|
| Hardware | top, left | power, compute, memory and board, GPUs, storage, drives |
| Network | top, left | Wi-Fi adapters, mobile modems, ethernet ports, Bluetooth, reachability, VPN |
| Application menu | top, left | the focused window’s menus, one group per top-level menu; off until switched on in Behaviour |
| Agenda | top, middle | calendar, weather, quiet schedule, focus session |
| Display | top, right | monitors, dark mode, colour temperature, wallpaper |
| Media | top, right | media players, audio, dictation, game controllers |
| Appearance | bottom, left | panel, sidebar, overlay, window and menu settings with a unit |
| Behaviour | bottom, left | the remaining panel, sidebar, overlay, window and menu settings, the application menu switch, looks |
| Applications | bottom, middle | frequently launched apps, one group per category, launcher options |
| Virtualization | bottom, right | virtual machines, microVMs, Incus instances, nspawn containers, LXC containers, Podman containers, Docker containers, Waydroid, Flatpak apps, memory limits |
| Services | bottom, right | local models, CI runs, AI usage, systemd units, journal, upgrades |
| Session | bottom, right | idle timeouts, login session |
Top panel
The Hardware, Network and Application menus on the left; the clock, Agenda menu and notifications in the middle; the Display and Media menus and the power menu on the right.
- Compute: load, clock, temperature and caches.
- Memory and board: memory use, modules and firmware.
- Weather: location, wind, rain and pollen.
- Audio and media: the playing track, volume and microphone.
- More of the top panel: VPN, dictation, agenda and game controllers.
- Wallpaper: the place in the wallpaper and its article.
Bottom panel
The Appearance and Behaviour menus and the workspaces on the left; the windows in the middle; the Virtualization, Services and Session menus and the system tray on the right.
- Windows and workspaces: previews, the window list and the process inspector.
- Idle and session: idle timeouts and the login session.
- AI usage: subscription windows, billing block and spend.
- Network: WireGuard tunnels with a switch to connect or disconnect them, and who may reach this machine over Tailscale.
- Virtualization and CI runs: running QEMU, libvirt and microVM guests, Incus instances, systemd-nspawn and LXC containers, the containers in each Podman and Docker engine, Waydroid and Flatpak sandboxes, memory caps on slices and services, and the runs of local CI runners.
- Appearance: the looks and how to switch them.
Notification toasts
- Notification toasts: arrival, progress and actions.