repositories / dotfiles

dotfiles

bugabingas dorkfiles

owned by bugabinga

feat(quickshell): add osd ipc surface

87422706ff39c6e1c4f9c2d0d6ad5680dbcc66cb

Oliver Jan Krylow <oliver@bugabinga.net> ·

unsigned

Browse filesCompare with HEAD

Changed files (4)

docs/super/inventory/2026-06-17-quickshell-phase-4a-osd-verification.md

Added
new file mode 100644
1 +# Quickshell Phase 4A OSD Verification — 2026-06-17
3 +## Scope
5 +Added an independent Quickshell OSD surface and IPC methods. This is the first Phase 4 replacement target for current `hyprctl notify` wrappers, but Hypr binds are **not** migrated yet.
7 +## Implemented files
9 +- `quickshell/nugu/Osd.qml`
10 +- `quickshell/nugu/shell.qml` IPC wiring
11 +- `quickshell/nugu/README.md` usage notes
13 +## Design decision
15 +The OSD is separate from the native notification daemon so Phase 4 can progress while Phase 3 live notification ownership is blocked by the agent shell DBus problem. The surface is hidden unless IPC explicitly shows it.
17 +## IPC tested
19 +Temporary `XDG_CONFIG_HOME` named config was used; no live home symlink mutation.
21 +```sh
22 +qs ipc -c nugu call nugu showOsd 'Hyprland reloaded' info
23 +qs ipc -c nugu call nugu showVolumeOsd 42%
24 +qs ipc -c nugu call nugu showBrightnessOsd 77%
25 +qs ipc -c nugu call nugu hideOsd
26 +```
28 +Observed returns:
30 +```text
31 +show=Hyprland reloaded
32 +volume=Volume 42%
33 +brightness=Brightness 77%
34 +```
36 +Runtime output:
38 +```text
39 +INFO: Configuration Loaded
40 +```
42 +No QML errors, binding loops, reference errors, or lingering `qs` process were observed.
44 +## Screenshots
46 +- `/tmp/nugu-qs-osd-info.png`
47 +- `/tmp/nugu-qs-osd-volume.png`
48 +- `/tmp/nugu-qs-osd-brightness.png`
50 +Vision checks confirmed:
52 +- `Hyprland reloaded` OSD renders with dark translucent background and cyan/info border.
53 +- `Volume 42%` OSD renders clearly with Nugu dark style.
54 +- `Brightness 77%` OSD renders clearly with warning/yellow border.
56 +## Still open
58 +- Migrate `hypr/modules/hypr_osd.lua` only after OSD command wrappers are wired and tested against real key events.
59 +- Add launcher, full clipboard picker, and final power confirmation flow.
60 +- Do not retire `hyprctl notify` or old companion apps yet.

quickshell/nugu/Osd.qml

Added
new file mode 100644
1 +import QtQuick
2 +import Quickshell
3 +import Quickshell.Wayland
5 +PanelWindow {
6 + id: root
8 + required property QtObject theme
9 + property bool shown: false
10 + property string message: ""
11 + property string tone: "info"
13 + // OSDs replace transient `hyprctl notify` calls later. Keeping this surface
14 + // independent from notifications avoids blocking Phase 4 on DBus ownership.
15 + visible: shown
16 + anchors { top: true; left: true; right: true }
17 + margins { top: 72 }
18 + exclusiveZone: -1
19 + implicitHeight: 48
20 + color: "transparent"
22 + WlrLayershell {
23 + layer: WlrLayer.Overlay
24 + namespace: "nugu-osd"
25 + }
27 + function showText(nextMessage: string, nextTone: string): string {
28 + message = nextMessage
29 + tone = nextTone.length > 0 ? nextTone : "info"
30 + shown = true
31 + hideTimer.restart()
32 + return message
33 + }
35 + function hide(): void {
36 + hideTimer.stop()
37 + shown = false
38 + }
40 + function toneColor(): color {
41 + if (tone === "error") return theme.error
42 + if (tone === "warning") return theme.warning
43 + if (tone === "debug") return theme.debug
44 + return theme.info
45 + }
47 + Timer {
48 + id: hideTimer
49 + interval: 1400
50 + onTriggered: root.shown = false
51 + }
53 + Rectangle {
54 + anchors.top: parent.top
55 + anchors.horizontalCenter: parent.horizontalCenter
56 + width: Math.min(root.width - 32, Math.max(220, osdText.implicitWidth + 44))
57 + height: 40
58 + radius: 10
59 + color: `${theme.ui.backdrop}ee`
60 + border.width: 2
61 + border.color: root.toneColor()
63 + Text {
64 + id: osdText
65 + anchors.centerIn: parent
66 + width: parent.width - 24
67 + horizontalAlignment: Text.AlignHCenter
68 + elide: Text.ElideRight
69 + text: root.message
70 + color: theme.ui.normal
71 + font.family: "IBM Plex Sans"
72 + font.pixelSize: 15
73 + font.bold: true
74 + }
75 + }

quickshell/nugu/README.md

Modified
87 87 Do not disable Mako in dotfiles until native notification parity is proven and rollback is verified.
89 +## Phase 4A OSD IPC
91 +Phase 4A adds a Quickshell OSD surface before Hypr bind migration. This creates a
92 +stable replacement target for old `hyprctl notify` wrappers without changing live
93 +binds yet.
95 +```sh
96 +qs ipc -c nugu call nugu showOsd 'Hyprland reloaded' info
97 +qs ipc -c nugu call nugu showVolumeOsd 42%
98 +qs ipc -c nugu call nugu showBrightnessOsd 77%
99 +qs ipc -c nugu call nugu hideOsd
100 +```
102 +Hypr binds still use the old helpers until the OSD command path is verified with
103 +real key events and screenshots.

quickshell/nugu/shell.qml

Modified
60 60 function restoreNativeNotification(): void {
61 61 if (notificationLoader.item) notificationLoader.item.restoreLast()
64 + // OSD IPC gives Hypr binds a stable replacement target for current
65 + // `hyprctl notify` helpers before those binds are migrated.
66 + function showOsd(message: string, tone: string): string { return osd.showText(message, tone) }
67 + function hideOsd(): void { osd.hide() }
68 + function showVolumeOsd(level: string): string { return osd.showText(`Volume ${level}`, "info") }
69 + function showBrightnessOsd(level: string): string { return osd.showText(`Brightness ${level}`, "warning") }
65 72 Loader {
80 + Osd {
81 + id: osd
82 + theme: nuguTheme
83 + }
73 85 // Create one bar per monitor, matching Ironbar's multi-output behavior.
74 86 Variants {
75 87 model: Quickshell.screens