dotfiles bugabingas dorkfiles
owned by bugabinga
README Source History Refs Compare Notes Search feat(quickshell): add osd ipc surface
87422706ff39c6e1c4f9c2d0d6ad5680dbcc66cb
Oliver Jan Krylow <oliver@bugabinga.net > · 17 Jun 2026
unsigned
Browse files Compare 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 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.
9 + - `quickshell/nugu/Osd.qml`
10 + - `quickshell/nugu/shell.qml` IPC wiring
11 + - `quickshell/nugu/README.md` usage notes
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.
19 + Temporary `XDG_CONFIG_HOME` named config was used; no live home symlink mutation.
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
31 + show=Hyprland reloaded
33 + brightness=Brightness 77%
39 + INFO: Configuration Loaded
42 + No QML errors, binding loops, reference errors, or lingering `qs` process were observed.
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.
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 3 + import Quickshell.Wayland
8 + required property QtObject theme
9 + property bool
shown :
false 10 + property string
message :
"" 11 + property string
tone :
"info" 16 + anchors {
top :
true ;
left :
true ;
right :
true }
20 + color :
"transparent" 23 + layer :
WlrLayer .Overlay
24 + namespace :
"nugu-osd" 27 + function showText (nextMessage: string
, nextTone: string): string {
28 + message
= nextMessage
29 + tone
= nextTone.length
> 0 ? nextTone
: "info" 35 + function hide ():
void {
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
50 + onTriggered : root.shown
= false 54 + anchors.top: parent.top
55 + anchors.horizontalCenter: parent.horizontalCenter
56 + width :
Math .
min (root.width
- 32 ,
Math .
max (
220 , osdText.implicitWidth
+ 44 ))
59 + color :
` ${theme.ui.backdrop}
ee` 61 + border.color: root.toneColor()
65 + anchors.centerIn: parent
66 + width : parent.width
- 24 67 + horizontalAlignment :
Text .AlignHCenter
68 + elide :
Text .ElideRight
70 + color : theme.ui.normal
71 + font.family:
"IBM Plex Sans" quickshell/nugu/README.md Modified 87 87 Do not disable Mako in dotfiles until native notification parity is proven and rollback is verified.
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
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
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()
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" ) }
75 87 model :
Quickshell .screens