diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.md index 4f2730e..b597920 100644 --- a/docs/CHANGELOG.md +++ b/docs/CHANGELOG.md @@ -5,6 +5,15 @@ this file is the curated, human-readable summary. ## Unreleased — Fast defaults with user-controlled source builds +- **Phoebus Updates entry point (2026-10-02).** The launcher and Super+U now + open the Assistant's update view directly, including without an AI model. + Its Apply action opens the existing interactive `sys` update flow in Kitty, + where the exact Portage/Flatpak/Snap plan is reviewed and command progress + remains visible. DMS stays an ordinary Gentoo package updated by Portage; + no DMS updater fork or patch is maintained. Existing Mango profiles gain + the shortcut once without replacing a user binding. The live image now + includes both Assistant and Updates desktop entries. + - **Frame and OS launcher logo defaults (2026-10-02).** New DMS profiles start with the Frame layout and the OS logo on the bar and dock launcher buttons. Existing profiles keep their layout and logo choices; DMS stores diff --git a/docs/HANDOFF.md b/docs/HANDOFF.md index d00626a..d7fdac1 100644 --- a/docs/HANDOFF.md +++ b/docs/HANDOFF.md @@ -3,6 +3,16 @@ Rolling note between work sessions. **Update this file before you finish**, then commit it. It should be short and current; use `git log` for detail. +- **Phoebus Updates entry point (2026-10-02):** The Updates view now has a + dedicated launcher and Super+U shortcut, works without a connected model, + and opens the existing interactive `sys` apply flow in Kitty so review and + package progress stay visible. DMS itself is unchanged and updates through + Portage. A one-time Mango config migration adds the shortcut to existing + profiles unless Super+U is already bound. The live image now installs the + Assistant and Updates desktop entries. Host checks pass; the new graphical + flow still needs a fresh VM check when `make doctor`'s 20 GiB disk-space + gate is met (currently 10 GiB free). + - **Frame and OS launcher logo defaults (2026-10-02):** DMS 1.6.2's layout picker sets `frameEnabled=true`; its launcher button logo uses `launcherLogoMode=os` (and the dock uses `dockLauncherLogoMode=os`). The diff --git a/docs/STATUS.md b/docs/STATUS.md index 1b28c0f..4b007f2 100644 --- a/docs/STATUS.md +++ b/docs/STATUS.md @@ -48,6 +48,18 @@ disposable VM; `serial-driver.py recovery` now automates the same check. ## Matrix +Phoebus Updates entry point (2026-10-02): the installed and live desktops +provide a dedicated launcher and Super+U shortcut that open the Assistant's +Updates view without needing a connected model. Review & Apply launches +`sudo sys apply updates --legacy` in Kitty, retaining the existing typed +approval, snapshots and visible package output. DMS remains the Portage +package supplied by GURU and is included in normal Gentoo updates. The DMS +updater widget is absent from the default bar; custom user bar layouts are +preserved. The installed desktop entry has a provisioning test, and the +launcher script, desktop entry and Rust suite have host checks. A fresh +graphical ISO/install is not VM verified because `make doctor` reports 10 GiB +free versus the 20 GiB VM gate. + Frame and launcher defaults (2026-10-02): the session now seeds DMS 1.6.2's `frameEnabled=true`, `launcherLogoMode=os`, and `dockLauncherLogoMode=os` only when `settings.json` does not yet exist. DMS's sparse settings format makes diff --git a/docs/SYS.md b/docs/SYS.md index 7a0cbb2..a462513 100644 --- a/docs/SYS.md +++ b/docs/SYS.md @@ -316,6 +316,13 @@ Every result distinguishes three honest states per lane: **unavailable** Deterministic forms: +On the desktop, launch **Phoebus Updates** or press Super+U. The update view +checks sources without a model, and **Review & Apply** opens the same +interactive `sudo sys apply updates --legacy` flow in Kitty. Portage compiles +and other package progress stay visible through completion. DankMaterialShell +is updated as a normal Portage package; the default DMS bar does not use its +separate updater widget. + ```sh sys search firefox --legacy # every source sys search firefox --legacy --flatpak # one source diff --git a/installer-rs/crates/phoebus-core/src/system.rs b/installer-rs/crates/phoebus-core/src/system.rs index d43487f..cff9f24 100644 --- a/installer-rs/crates/phoebus-core/src/system.rs +++ b/installer-rs/crates/phoebus-core/src/system.rs @@ -1460,6 +1460,16 @@ if [ ! -e "$cursor_include_marker" ] && [ -w "$mango_conf" ]; then : > "$cursor_include_marker" fi fi +# Older user configs do not receive new packaged shortcuts. Add this one +# once, while respecting a user's existing Super+U binding or later removal. +updates_binding_marker="$HOME/.config/mango/dms/.phoebus-updates-binding-v1" +if [ ! -e "$updates_binding_marker" ] && [ -w "$mango_conf" ]; then + if grep -Eiq '^[[:space:]]*bind=SUPER,u,' "$mango_conf"; then + : > "$updates_binding_marker" + elif printf '\n# Open Phoebus Updates.\nbind=SUPER,u,spawn,phoebus-assistant --updates\n' >> "$mango_conf"; then + : > "$updates_binding_marker" + fi +fi # DMS manages these fragments; they must exist before Mango sources them. for f in colors layout outputs cursor; do [ -e "$HOME/.config/mango/dms/$f.conf" ] || : > "$HOME/.config/mango/dms/$f.conf" @@ -1882,6 +1892,7 @@ bind=SUPER+CTRL,m,spawn,dms ipc call processlist focusOrToggle bind=SUPER+CTRL,comma,spawn,dms ipc call settings focusOrToggle bind=SUPER,n,spawn,dms ipc call notifications toggle bind=SUPER,a,spawn,phoebus-assistant +bind=SUPER,u,spawn,phoebus-assistant --updates bind=SUPER,F1,spawn,phoebus-help bind=SUPER+SHIFT,w,spawn,phoebus-welcome --reopen bind=SUPER+ALT,w,spawn,dms ipc call welcome open @@ -1915,10 +1926,37 @@ After=graphical-session.target pub const PHOEBUS_ASSISTANT_SCRIPT: &str = r#"#!/bin/bash # Open the Phoebus assistant. If graphical environment and quickshell are available, # launch the desktop assistant GUI. Otherwise fall back to a terminal with `sys ask`. +# Variables in single-quoted bash -c arguments expand inside the Kitty child. +# shellcheck disable=SC2016 set -u +updates=false +case "${1:-}" in + "") ;; + --updates) updates=true ;; + --apply-updates) + if ! command -v kitty >/dev/null 2>&1; then + echo "phoebus-assistant: Kitty is required to show update progress" >&2 + exit 1 + fi + exec kitty --title "Phoebus Updates" -e bash -c ' + sudo /usr/local/bin/sys apply updates --legacy + result=$? + printf "\nUpdate session finished (exit %s). Press Enter to close.\n" "$result" + read -r + exit "$result" + ' + ;; + *) echo "Usage: phoebus-assistant [--updates|--apply-updates]" >&2; exit 2 ;; +esac if [ -n "${WAYLAND_DISPLAY:-}" ] || [ -n "${DISPLAY:-}" ]; then if command -v quickshell >/dev/null 2>&1 \ && [ -f /etc/xdg/quickshell/phoebus-assistant/shell.qml ]; then + if "$updates"; then + if quickshell ipc -c phoebus-assistant call panel updates >/dev/null 2>&1; then + exit 0 + fi + PHOEBUS_ASSISTANT_START_TAB=updates exec quickshell --no-duplicate -c phoebus-assistant + fi # Keep the active conversation when the shortcut is pressed again. if quickshell ipc -c phoebus-assistant call panel toggle >/dev/null 2>&1; then exit 0 @@ -1927,6 +1965,15 @@ if [ -n "${WAYLAND_DISPLAY:-}" ] || [ -n "${DISPLAY:-}" ]; then fi fi if command -v kitty >/dev/null 2>&1; then + if "$updates"; then + exec kitty --title "Phoebus Updates" -e bash -c ' + /usr/local/bin/sys updates --legacy + result=$? + printf "\nUpdate check finished (exit %s). Press Enter to close.\n" "$result" + read -r + exit "$result" + ' + fi exec kitty --title "Phoebus Assistant" -e bash -lc \ 'read -rp "Phoebus assistant request: " r; sudo sys ask "$r"; \ echo; read -rp "Press Enter to close"' @@ -1946,6 +1993,17 @@ Categories=System;Settings; Keywords=system;admin;assistant;ai;sys;install;update; "#; +pub const PHOEBUS_UPDATES_DESKTOP_ENTRY: &str = r#"[Desktop Entry] +Name=Phoebus Updates +Comment=Review and apply system and application updates +Exec=/usr/local/bin/phoebus-assistant --updates +Icon=software-update-available +Terminal=false +Type=Application +Categories=System; +Keywords=updates;portage;flatpak;snap;sys; +"#; + pub const PHOEBUS_HELP_SCRIPT: &str = r#"#!/bin/bash set -u page=/usr/share/phoebus/help/index.html @@ -2610,6 +2668,8 @@ pub fn desktop_asset(name: &str) -> Option { Some(match name { "session-mango" => PHOEBUS_MANGO_SESSION_SCRIPT.to_string(), "assistant" => PHOEBUS_ASSISTANT_SCRIPT.to_string(), + "assistant-desktop" => PHOEBUS_ASSISTANT_DESKTOP_ENTRY.to_string(), + "updates-desktop" => PHOEBUS_UPDATES_DESKTOP_ENTRY.to_string(), "help" => PHOEBUS_HELP_SCRIPT.to_string(), "help-html" => { include_str!("../../../../installer/live/desktop/phoebus-help/index.html").to_string() diff --git a/installer-rs/crates/phoebus-executor/src/desktop.rs b/installer-rs/crates/phoebus-executor/src/desktop.rs index b359752..1da829e 100644 --- a/installer-rs/crates/phoebus-executor/src/desktop.rs +++ b/installer-rs/crates/phoebus-executor/src/desktop.rs @@ -97,6 +97,11 @@ pub fn write_session_script(exec: &Exec, config: &InstallConfig) -> Result<()> { "usr/share/applications/phoebus-assistant.desktop", sysgen::PHOEBUS_ASSISTANT_DESKTOP_ENTRY, )?; + write_public( + &target, + "usr/share/applications/phoebus-updates.desktop", + sysgen::PHOEBUS_UPDATES_DESKTOP_ENTRY, + )?; write_script( &target, @@ -1101,6 +1106,10 @@ mod tests { .root .join("usr/share/applications/phoebus-assistant.desktop") .is_file()); + assert!(exec + .root + .join("usr/share/applications/phoebus-updates.desktop") + .is_file()); assert!(exec .root .join("etc/xdg/quickshell/phoebus-assistant/shell.qml") diff --git a/installer-rs/crates/phoebus-executor/tests/session_script.rs b/installer-rs/crates/phoebus-executor/tests/session_script.rs index bee5501..4aa36be 100644 --- a/installer-rs/crates/phoebus-executor/tests/session_script.rs +++ b/installer-rs/crates/phoebus-executor/tests/session_script.rs @@ -150,6 +150,27 @@ fn failure_to_create_the_socket_is_reported() { assert!(fixture.read("helpers.log").is_empty()); } +#[test] +fn existing_mango_profiles_gain_updates_shortcut_once_and_keep_custom_bindings() { + let fixture = Fixture::new(MANGO_FAIL); + let config = fixture.dir.path().join(".config/mango/config.conf"); + std::fs::create_dir_all(config.parent().unwrap()).unwrap(); + std::fs::write(&config, "bind=SUPER,a,spawn,phoebus-assistant\n").unwrap(); + let _ = fixture.run(); + let _ = fixture.run(); + let content = std::fs::read_to_string(&config).unwrap(); + assert_eq!(content.matches("bind=SUPER,u,").count(), 1); + + let custom = Fixture::new(MANGO_FAIL); + let custom_config = custom.dir.path().join(".config/mango/config.conf"); + std::fs::create_dir_all(custom_config.parent().unwrap()).unwrap(); + std::fs::write(&custom_config, "bind=SUPER,u,spawn,my-updater\n").unwrap(); + let _ = custom.run(); + let custom_content = std::fs::read_to_string(&custom_config).unwrap(); + assert!(custom_content.contains("bind=SUPER,u,spawn,my-updater")); + assert!(!custom_content.contains("bind=SUPER,u,spawn,phoebus-assistant")); +} + #[test] fn first_login_seeds_wallpaper_folder_and_letter_avatar_without_replacing_choices() { let fixture = Fixture::new(MANGO_OK); diff --git a/installer/live/build.sh b/installer/live/build.sh index f0acb4f..6741f0d 100755 --- a/installer/live/build.sh +++ b/installer/live/build.sh @@ -99,7 +99,7 @@ echo "releases OK" # --------------------------------------------------------------------------- say "emit shared desktop assets" assets=( - session-mango assistant help help-html help-desktop dms-welcome-desktop install welcome + session-mango assistant assistant-desktop updates-desktop help help-html help-desktop dms-welcome-desktop install welcome mango-config mango-session-target install-desktop wayland-session-mango greetd-live live-sudoers brand-emblem brand-wordmark brand-wallpaper brand-tokens @@ -240,6 +240,8 @@ install_asset() { install_asset session-mango /usr/local/bin/phoebus-session-mango 0755 ln -sf phoebus-session-mango "$rootfs/usr/local/bin/phoebus-session" install_asset assistant /usr/local/bin/phoebus-assistant 0755 +install_asset assistant-desktop /usr/share/applications/phoebus-assistant.desktop +install_asset updates-desktop /usr/share/applications/phoebus-updates.desktop install_asset help /usr/local/bin/phoebus-help 0755 install_asset help-html /usr/share/phoebus/help/index.html install_asset help-desktop /usr/share/applications/phoebus-help.desktop diff --git a/installer/live/desktop/phoebus-assistant/shell.qml b/installer/live/desktop/phoebus-assistant/shell.qml index a8e82fb..73d29f7 100644 --- a/installer/live/desktop/phoebus-assistant/shell.qml +++ b/installer/live/desktop/phoebus-assistant/shell.qml @@ -11,12 +11,13 @@ ShellRoot { // Keep the broker and conversation alive while the scratchpad is hidden. property bool panelOpen: true - property string currentTab: "assistant" // "assistant", "updates", "legacy", "alerts", "preferences" + property string currentTab: Quickshell.env("PHOEBUS_ASSISTANT_START_TAB") === "updates" ? "updates" : "assistant" property var conversation: [] property bool busy: false property string statusText: "Ready" property var activeAlerts: [] property var updateOverview: null + property string updateError: "" property var preferences: null // Truthful model connection: never "Connected" solely because the bridge // process started. `aiConfigured` follows the handshake's ai_configured. @@ -46,6 +47,8 @@ ShellRoot { shell.aiConfigured = !!result.ai_configured; shell.aiBackend = result.ai_backend || "direct"; shell.aiError = ""; + if (shell.currentTab === "updates") + shell.checkUpdates(); AssistantBridge.getProactiveAlerts(reply => { if (reply.ok && reply.result) shell.activeAlerts = reply.result.alerts || []; @@ -86,6 +89,8 @@ ShellRoot { } function checkUpdates() { + if (!AssistantBridge.ready) + return; shell.busy = true; shell.statusText = "Checking for updates across package sources..."; AssistantBridge.getUpdates(reply => { @@ -93,6 +98,9 @@ ShellRoot { shell.statusText = "Ready"; if (reply.ok && reply.result) { shell.updateOverview = reply.result; + shell.updateError = ""; + } else { + shell.updateError = reply.error || "Could not check for updates."; } }); } @@ -230,6 +238,14 @@ ShellRoot { shell.showPanel(); return "shown"; } + + function updates(): string { + shell.currentTab = "updates"; + shell.showPanel(); + if (!shell.updateOverview && !shell.busy && AssistantBridge.ready) + shell.checkUpdates(); + return "shown"; + } } Timer { @@ -245,7 +261,7 @@ ShellRoot { FloatingWindow { id: window - title: "Phoebus Assistant" + title: shell.currentTab === "updates" ? "Phoebus Updates" : "Phoebus Assistant" color: "transparent" visible: shell.panelOpen // Default fits 1024x768 and 1280x720. Content areas scroll at @@ -290,7 +306,7 @@ ShellRoot { spacing: 12 Label { - text: "Phoebus Assistant" + text: shell.currentTab === "updates" ? "Phoebus Updates" : "Phoebus Assistant" color: Theme.text font.pixelSize: 18 font.bold: true @@ -300,11 +316,11 @@ ShellRoot { Layout.preferredWidth: 8 Layout.preferredHeight: 8 radius: 4 - color: shell.assistantConnected ? Theme.primary : Theme.warning + color: (shell.currentTab === "updates" ? AssistantBridge.ready : shell.assistantConnected) ? Theme.primary : Theme.warning } Label { - text: shell.assistantConnected ? "Connected (" + shell.aiBackend + ")" : (shell.bridgeConnecting ? "Connecting…" : (AssistantBridge.ready ? "Setup required" : "Offline")) + text: shell.currentTab === "updates" ? (AssistantBridge.ready ? "System broker ready" : "Connecting…") : (shell.assistantConnected ? "Connected (" + shell.aiBackend + ")" : (shell.bridgeConnecting ? "Connecting…" : (AssistantBridge.ready ? "Setup required" : "Offline"))) color: Theme.muted font.pixelSize: 12 } @@ -378,7 +394,7 @@ ShellRoot { // and never approval controls for an error. Rectangle { Layout.fillWidth: true - visible: !shell.assistantConnected + visible: !shell.assistantConnected && shell.currentTab === "assistant" radius: 8 color: Theme.card border.color: Theme.warning @@ -686,12 +702,19 @@ ShellRoot { spacing: 12 Label { - text: "Unified Multi-Source Updates" + text: "System Updates" color: Theme.text font.pixelSize: 16 font.bold: true } + Label { + Layout.fillWidth: true + text: shell.updateError || "Portage, Flatpak and Snap updates appear below using your current repository metadata. Review the exact plan in the terminal before approving it." + wrapMode: Text.WordWrap + color: shell.updateError ? Theme.warning : Theme.muted + } + ListView { Layout.fillWidth: true Layout.fillHeight: true @@ -751,12 +774,14 @@ ShellRoot { Layout.fillWidth: true PhoebusButton { label: "Refresh Updates" - onClicked: refreshStatus() + actionEnabled: !shell.busy + onClicked: shell.checkUpdates() } PhoebusButton { - label: "Apply All Updates" + label: "Review & Apply" primary: true - onClicked: shell.submitPrompt("update system") + actionEnabled: !shell.busy + onClicked: Quickshell.execDetached(["/usr/local/bin/phoebus-assistant", "--apply-updates"]) } } } diff --git a/installer/live/desktop/phoebus-help/index.html b/installer/live/desktop/phoebus-help/index.html index 6c84199..d6e4d92 100644 --- a/installer/live/desktop/phoebus-help/index.html +++ b/installer/live/desktop/phoebus-help/index.html @@ -13,7 +13,7 @@ body{margin:0}header{background:#20242c;border-bottom:1px solid #3b414d;padding:

Getting started

Phoebus is a Gentoo workstation with the Mango Wayland compositor, DankMaterialShell (DMS), Portage, Flatpak, and Nix. The system remains usable offline after installation. The terminal tool sys is the shared interface for package management and system administration.

Open Phoebus Welcome from the app launcher or press Super+Shift+W. Open the original DMS Welcome from the launcher or press Super+Alt+W. Press Super+F1 to reopen this guide.

“Super” is usually the Windows or Command key. Settings and Welcome are regular windows; the Assistant is a floating scratchpad.

Desktop controls

The top bar holds the app launcher and workspaces on the left, clock and optional weather in the center, and system controls on the right. Click the right side for clipboard, process list, notifications, volume, connectivity, and quick settings. Click the clock for the calendar. Some controls appear only when the corresponding device or service exists.

Open the app launcher with Super+Space or Super+P. Type an app or command and press Enter. Press Escape to dismiss a panel. Open DMS Settings from the launcher or Super+Ctrl+,.

Keybinding cheat sheet

- +
KeysAction
Super+Shift+EnterTerminal
Super+Space or Super+PApp launcher
Super+AShow or hide Phoebus Assistant
Super+F1Phoebus Help
Super+Shift+W / Super+Alt+WPhoebus Welcome / DMS Welcome
Super+Ctrl+,DMS Settings
Super+V / Super+NClipboard history / notifications
Super+Ctrl+MProcess list
Super+Alt+LLock screen
Super+Shift+EnterTerminal
Super+Space or Super+PApp launcher
Super+AShow or hide Phoebus Assistant
Super+UPhoebus Updates
Super+F1Phoebus Help
Super+Shift+W / Super+Alt+WPhoebus Welcome / DMS Welcome
Super+Ctrl+,DMS Settings
Super+V / Super+NClipboard history / notifications
Super+Ctrl+MProcess list
Super+Alt+LLock screen
Super+1…9Switch workspace
Super+Shift+1…9Move focused window to workspace
Super+TabPrevious workspace
Super+J/K or arrow keysFocus another window
Super+Shift+J/K or arrow keysSwap focused window
Super+H/LShrink / grow master area
Super+I/DAdd / remove a master window
Super+EnterSwap focused window with master
Super+T/MTile / monocle layout
Super+FToggle fullscreen
Super+Shift+SpaceToggle floating
Super+Shift+CClose focused window
Super+RReload Mango configuration
Super+drag left/right mouse buttonMove / resize a floating window
Super+Shift+F9…F12Switch display resolution (1024×768, 1280×768, 1440×900, 1920×1080)

Advanced bindings also include Super+Ctrl+number to add a workspace to the view, Super+Ctrl+Shift+number to toggle a window tag, Super+comma/period to focus another monitor, and Super+Shift+comma/period to move a window there. Super+Shift+E exits the desktop session.

Apps and packages

Run sys --help for the full command reference. Plain sys commands use the connected model; --legacy uses deterministic actions and works without a model. A package source flag selects exactly one lane. Operations show a review before mutation and may require administrator authentication.

sys search firefox --legacy
@@ -26,7 +26,7 @@ sys updates --legacy
 sudo sys apply updates --legacy
 sys history --legacy

Available sources include Portage, Flatpak, Nix, Snap when snapd is installed, managed AppImages, and custom ebuilds. Search a lane first when the name is uncertain. A lane that is unavailable reports why; package management never silently switches sources. Portage, Flatpak, and other backend progress stays visible while work runs.

Assistant and models

Press Super+A to show or hide the Assistant without losing its conversation. The Assistant proposes typed system actions. Review and authenticate any change yourself; the model does not receive a root shell. Its Updates, Legacy, Alerts, and Preferences tabs give direct access to the same system capabilities. If no model is connected, use sys --legacy and the Legacy tab.

Model connection is configured through Phoebus setup or assistant preferences. Keep provider tokens in the supported secret storage; never paste them into a package request or terminal history.

-

Updates and recovery

Use sys updates --legacy to inspect available updates and sudo sys apply updates --legacy to review and apply them. sys history --legacy lists recorded actions. sys undo status --legacy shows recovery state; sudo sys undo --legacy begins a reviewed undo where available. Snapshots protect high risk operations, but complete Btrfs rollback is still under development. Keep regular backups of personal files.

For boot trouble, select the known good kernel from the boot menu. Phoebus uses UEFI, LUKS2 encryption, Btrfs, and systemd; do not erase or reformat disks while diagnosing a boot issue.

+

Updates and recovery

Open Phoebus Updates from the launcher or press Super+U. It checks Portage, Flatpak and Snap without a model. Portage checks use your last synced repository metadata; run sudo emerge --sync to discover newly published Gentoo and GURU packages. Choose Review & Apply to open an interactive sys update in a terminal, review the exact plan and approve it. Package progress stays visible until you close the terminal. This keeps DankMaterialShell updated through Portage along with other Gentoo packages. Use Phoebus Updates for system updates; the separate updater page in DMS Settings does not manage Portage. Nix, managed AppImages and custom ebuilds have separate update paths. You can also use sys updates --legacy to inspect and sudo sys apply updates --legacy to review and apply. sys history --legacy lists recorded actions. sys undo status --legacy shows recovery state; sudo sys undo --legacy begins a reviewed undo where available. Snapshots protect high risk operations, but complete Btrfs rollback is still under development. Keep regular backups of personal files.

For boot trouble, select the known good kernel from the boot menu. Phoebus uses UEFI, LUKS2 encryption, Btrfs, and systemd; do not erase or reformat disks while diagnosing a boot issue.

Settings and displays

DMS Settings controls appearance, bar, widgets, display, input, audio, notifications, network, and session options. On a virtual machine, resize the viewer first; use the display page if the guest resolution does not follow. The resolution shortcuts above offer an immediate fallback. Wallpaper files live in ~/Pictures/Wallpapers; DMS can choose one from its Wallpaper page.

Changes to your personal Mango config live under ~/.config/mango/. The packaged defaults are copied only for a new account, so updates preserve your custom bindings.

Troubleshooting

If the bar or a panel does not appear, run dms ipc call settings focusOrToggle from a terminal to check whether DMS responds. Reopen the Assistant with Super+A. To inspect the compositor, run mmsg get all-clients in a Wayland terminal. For package errors, run the same sys command in a terminal to read its status and backend output. sys --help and dms ipc --help list current commands.

This guide is stored on the local system at /usr/share/phoebus/help/index.html and remains available without network access.