1 +#
Nugu Quickshell IPC inventory 3 +All calls use the named config target:
6 +qs ipc -c nugu call nugu
<method
> [args...
] 9 +This inventory is audited against `shell.qml`. It exists so later Hypr config
10 +simplification can replace old companion commands with stable Quickshell IPC
11 +instead of rediscovering ad-hoc function names.
15 +| Method | Purpose | Rollout status |
17 +| `showDiagnostics` | Show the safe diagnostics surface for visual/theme probing. | Scaffold verified. |
18 +| `hideDiagnostics` | Hide the diagnostics surface. | Scaffold verified. |
19 +| `toggleDiagnostics` | Toggle diagnostics during manual visual checks. | Scaffold verified. |
20 +| `showBar` | Show the Quickshell bar beside Ironbar during rollout. | Scaffold verified; not live default. |
21 +| `hideBar` | Hide the Quickshell bar. | Scaffold verified. |
22 +| `toggleBar` | Toggle the Quickshell bar for screenshots/manual checks. | Scaffold verified. |
23 +| `reloadTheme` | Reload bundled Nugu palette and mode cache. | Smoke verified. |
24 +| `setThemeMode` | Select `light`, `dark`, or `auto` without writing global state. | Smoke verified. |
25 +| `themeMode` | Return current effective theme mode. | Smoke verified. |
26 +| `themeSource` | Return `preview` or `auto`. | Smoke verified. |
27 +| `themeState` | Return mode/source plus key loaded Nugu tokens. | Token smoke verified. |
28 +| `scaffoldState` | Return one compact JSON snapshot for smoke tests. | Smoke verified. |
29 +| `hideAll` | Close Quickshell surfaces and disable gated native notifications. | Smoke verified. |
30 +| `enableNativeNotifications` | Opt in to native notification daemon while Mako is stopped. | Implemented; DBus parity blocked. |
31 +| `disableNativeNotifications` | Disable native notification daemon for rollback. | Implemented; rollback path pending live DBus. |
32 +| `nativeNotificationCount` | Report tracked native notification count. | Implemented; DBus parity blocked. |
33 +| `dismissNativeNotifications` | Dismiss all native notification toasts. | Implemented; DBus parity blocked. |
34 +| `restoreNativeNotification` | Restore last native notification. | Implemented; DBus parity blocked. |
35 +| `showOsd` | Show arbitrary OSD text with a semantic tone. | Scaffold verified. |
36 +| `hideOsd` | Hide the OSD. | Scaffold verified. |
37 +| `showVolumeOsd` | Show volume text without changing audio. | Scaffold verified. |
38 +| `showBrightnessOsd` | Show brightness text without changing backlight. | Scaffold verified. |
39 +| `osdVolumeUp` | Raise volume and show OSD. | Implemented; live bind validation pending. |
40 +| `osdVolumeDown` | Lower volume and show OSD. | Implemented; live bind validation pending. |
41 +| `osdMuteAudio` | Toggle output mute and show OSD. | Implemented; live bind validation pending. |
42 +| `osdMuteMic` | Toggle microphone mute and show OSD. | Implemented; live bind validation pending. |
43 +| `osdBrightnessUp` | Raise brightness and show OSD. | Implemented; live bind validation pending. |
44 +| `osdBrightnessDown` | Lower brightness and show OSD. | Implemented; live bind validation pending. |
45 +| `osdMediaNext` | Advance media player and show OSD. | Implemented; DBus/MPRIS/live player validation pending. |
46 +| `osdMediaToggle` | Toggle media playback and show OSD. | Implemented; DBus/MPRIS/live player validation pending. |
47 +| `osdMediaPrev` | Previous media item and show OSD. | Implemented; DBus/MPRIS/live player validation pending. |
48 +| `osdReloadHypr` | Reload Hyprland and show OSD. | Implemented; bind migration pending. |
49 +| `osdSessionLock` | Lock session and show OSD. | Implemented; lock live validation pending. |
50 +| `osdSessionSuspendDryRun` | Dry-run suspend path and show OSD. | Dry-run verified. |
51 +| `osdCaptureRegion` | Capture a selected region and show OSD. | Implemented; interactive validation pending. |
52 +| `osdCaptureWindow` | Capture a selected window and show OSD. | Implemented; interactive validation pending. |
53 +| `osdCaptureOutput` | Capture an output and show OSD. | Implemented; interactive validation pending. |
54 +| `osdCaptureAnnotate` | Capture region and open annotation flow. | Implemented; interactive validation pending. |
55 +| `osdPickColor` | Pick a color and show OSD. | Implemented; interactive validation pending. |
56 +| `lastOsdAction` | Report last OSD command result for tests. | Smoke/dry-run helper. |
57 +| `openLauncher` | Open native desktop-entry launcher with optional query. | Keyboard/app-launch verified; bind migration pending. |
58 +| `closeLauncher` | Close launcher. | Verified. |
59 +| `launcherVisible` | Report launcher visibility. | Verified. |
60 +| `launcherMatchCount` | Report launcher result count. | Verified. |
61 +| `launcherFirstMatchName` | Report first launcher match name. | Verified. |
62 +| `openClipboardPicker` | Open clipboard picker with optional query. | Verified frontend; cliphist bridge remains. |
63 +| `closeClipboardPicker` | Close clipboard picker. | Verified. |
64 +| `clipboardPickerVisible` | Report clipboard picker visibility. | Verified. |
65 +| `clipboardPickerMatchCount` | Report clipboard picker result count. | Verified. |
66 +| `clipboardPickerFirstPreview` | Report first clipboard preview text. | Verified. |
67 +| `chooseClipboardIndex` | Copy selected clipboard result by index. | Verified frontend; cliphist bridge remains. |
68 +| `openPowerMenu` | Open confirmed power menu. | Dry-run matrix verified. |
69 +| `closePowerMenu` | Close power menu and clear pending action. | Dry-run matrix verified. |
70 +| `powerMenuVisible` | Report power menu visibility. | Dry-run matrix verified. |
71 +| `requestPowerAction` | Stage lock/sleep/logout/reboot/poweroff action. | Dry-run matrix verified. |
72 +| `pendingPowerAction` | Report currently staged power action. | Dry-run matrix verified. |
73 +| `confirmPowerAction` | Confirm staged action; non-lock remains dry-run. | Dry-run matrix verified. |
74 +| `lastPowerAction` | Report last power command result. | Dry-run matrix verified. |