dotfiles bugabingas dorkfiles
owned by bugabinga
README Source History Refs Compare Notes Search feat(quickshell): add launcher ipc surface
2b9a8f34e38fe02a3c2f587ce327c81ef16a4894
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-4b-launcher-verification.md Added new file mode 100644 1 + #
Quickshell Phase 4B Launcher Verification — 2026-06-17 5 + Added a hidden native launcher surface backed by Quickshell `DesktopEntries`. This is the future `SUPER+Space` replacement for `hyprlauncher`, but the Hypr bind remains unchanged until app launch and real keyboard navigation are proven.
9 + - `quickshell/nugu/Launcher.qml`
10 + - `quickshell/nugu/shell.qml` IPC wiring
11 + - `quickshell/nugu/README.md` usage notes
15 + Throwaway probes showed:
17 + - `DesktopEntries.applications` itself is an `UntypedObjectModel`; direct `Variants.model` use logs `Non list data ... assigned to Variants.model`.
18 + - `DesktopEntries.applications.values` works as the app list and can be filtered/sliced for `ScriptModel`.
22 + Temporary `XDG_CONFIG_HOME` named config was used; no live home symlink mutation.
25 + qs ipc -c nugu call nugu openLauncher fire
26 + qs ipc -c nugu call nugu launcherVisible
27 + qs ipc -c nugu call nugu launcherMatchCount
28 + qs ipc -c nugu call nugu launcherFirstMatchName
29 + qs ipc -c nugu call nugu closeLauncher
45 + INFO: Configuration Loaded
48 + No QML errors, binding loops, reference errors, or lingering `qs` process were observed.
52 + - `/tmp/nugu-qs-launcher-fire.png`
54 + Vision check confirmed:
56 + - launcher popup is visible with Nugu border/background
57 + - search field contains `fire`
58 + - filtered result shows `Firefox`
61 + The screenshot also shows a white square near the bottom edge. Vision classified it as likely underlying/redacted background content rather than a launcher result icon or cursor.
63 + ##
Still open before replacing `hyprlauncher` 65 + - Real keyboard navigation: type, up/down, escape, enter.
66 + - Safe app-launch validation without disrupting the desktop.
67 + - Arbitrary command mode only if current `hyprlauncher` setup actually depends on it.
68 + - Hypr `SUPER+Space` bind migration after Quickshell service is live and recoverable.
quickshell/nugu/Launcher.qml Added new file mode 100644 3 + import Quickshell.Wayland
8 + required property QtObject theme
9 + property bool
open :
false 10 + property string
query :
"" 16 + anchors {
top :
true ;
left :
true ;
right :
true }
20 + color :
"transparent" 23 + layer :
WlrLayer .Overlay
24 + namespace :
"nugu-launcher" 25 + keyboardFocus : root.open
? WlrKeyboardFocus .Exclusive
: WlrKeyboardFocus .None
28 + ScriptModel {
id : matches }
31 + target :
DesktopEntries .applications
32 + function onValuesChanged ():
void { root.
rebuild () }
35 + Component .onCompleted: rebuild()
36 + onQueryChanged : rebuild()
38 + if (open)
Qt .callLater(search.forceActiveFocus)
41 + function show (initialQuery: string): string {
42 + query
= initialQuery
47 + function close ():
void {
52 + function matchCount (): int {
return matches.values.length }
53 + function firstMatchName (): string {
return matches.values.length
> 0 ? matches.values[
0 ].name
: "" }
55 + function rebuild ():
void {
56 + const needle
= query.toLowerCase().trim()
57 + const apps
= DesktopEntries .applications.values
|| []
58 + matches.values
= apps
59 + .filter(app
=> app
&& ! app.noDisplay
&& app.name.length
> 0 )
60 + .filter(app
=> needle.length
=== 0 || searchableText(app).indexOf(needle)
!== - 1 )
61 + .sort((a, b)
=> a.name.localeCompare(b.name))
63 + results.currentIndex
= matches.values.length
> 0 ? 0 : - 1 66 + function searchableText (app): string {
72 + app.categories.join(
" " ),
73 + app.keywords.join(
" " )
74 + ].join(
" " ).toLowerCase()
77 + function launchIndex (index: int):
void {
78 + if (index
< 0 || index
>= matches.values.length)
return 79 + const app
= matches.values[index]
85 + anchors.fill: parent
86 + onClicked : root.close()
90 + anchors.top: parent.top
91 + anchors.horizontalCenter: parent.horizontalCenter
92 + width :
Math .
min (parent.width
- 32 ,
620 )
93 + height : parent.height
95 + color :
` ${theme.ui.backdrop}
f2` 97 + border.color: theme.ui.accent
100 + anchors.fill: parent
101 + anchors.margins:
14 106 + width : parent.width
109 + onTextChanged : root.query
= text
110 + color : theme.ui.important_global
111 + selectionColor : theme.ui.focus
112 + selectedTextColor : theme.content.backdrop
113 + font.family:
"IBM Plex Sans" 119 + anchors.fill: parent
120 + anchors.margins:
- 6 123 + color : theme.content.backdrop
125 + border.color: theme.ui.unfocus
128 + Keys .onPressed: event
=> {
129 + if (event.key
=== Qt .Key_Escape) {
131 + event.accepted
= true 132 + }
else if (event.key
=== Qt .Key_Down) {
133 + results.currentIndex
= Math .
min (results.currentIndex
+ 1 , matches.values.length
- 1 )
134 + event.accepted
= true 135 + }
else if (event.key
=== Qt .Key_Up) {
136 + results.currentIndex
= Math .
max (results.currentIndex
- 1 ,
0 )
137 + event.accepted
= true 138 + }
else if (event.key
=== Qt .Key_Return
|| event.key
=== Qt .Key_Enter) {
139 + root.launchIndex(results.currentIndex)
140 + event.accepted
= true 147 + width : parent.width
148 + height : parent.height
- search.height
- parent.spacing
153 + delegate : Rectangle {
155 + required property
var modelData
156 + required property int index
158 + width : results.width
161 + color : results.currentIndex
=== index
? theme.ui.focus
: (rowMouse.containsMouse
? theme.ui.accent
: "transparent" )
165 + anchors.fill: parent
167 + onClicked : root.launchIndex(row.index)
171 + anchors.fill: parent
172 + anchors.leftMargin:
10 173 + anchors.rightMargin:
10 179 + anchors.verticalCenter: parent.verticalCenter
180 + source :
Quickshell .iconPath(row.modelData.icon,
true )
181 + fillMode :
Image .PreserveAspectFit
182 + visible : source.length
> 0 186 + anchors.verticalCenter: parent.verticalCenter
187 + width : parent.width
- 42 191 + width : parent.width
192 + text : row.modelData.name
193 + color : (results.currentIndex
=== row.index
|| rowMouse.containsMouse)
? theme.content.backdrop
: theme.ui.normal
194 + font.family:
"IBM Plex Sans" 197 + elide :
Text .ElideRight
201 + width : parent.width
202 + text : row.modelData.comment
|| row.modelData.genericName
|| row.modelData.id
203 + color : (results.currentIndex
=== row.index
|| rowMouse.containsMouse)
? theme.content.backdrop
: theme.ui.minor
204 + font.family:
"IBM Plex Sans" 206 + elide :
Text .ElideRight
quickshell/nugu/README.md Modified 102 102 Hypr binds still use the old helpers until the OSD command path is verified with
103 103 real key events and screenshots.
105 + ##
Phase 4B launcher IPC 107 + Phase 4B adds a native DesktopEntries launcher, still hidden until IPC opens it.
108 + This is the future `SUPER+Space` replacement for `hyprlauncher`, but the live
109 + bind is not migrated until filtering, keyboard navigation, and app launching are
110 + verified in the real session.
113 + qs ipc -c nugu call nugu openLauncher fire
114 + qs ipc -c nugu call nugu launcherVisible
115 + qs ipc -c nugu call nugu launcherMatchCount
116 + qs ipc -c nugu call nugu launcherFirstMatchName
117 + qs ipc -c nugu call nugu closeLauncher
quickshell/nugu/shell.qml Modified 67 67 function hideOsd ():
void { osd.hide() }
68 68 function showVolumeOsd (level: string): string {
return osd.showText(
`Volume ${level}
` ,
"info" ) }
69 69 function showBrightnessOsd (level: string): string {
return osd.showText(
`Brightness ${level}
` ,
"warning" ) }
73 + function openLauncher (query: string): string {
return launcher.show(query) }
74 + function closeLauncher ():
void { launcher.close() }
75 + function launcherVisible (): bool {
return launcher.open }
76 + function launcherMatchCount (): int {
return launcher.matchCount() }
77 + function launcherFirstMatchName (): string {
return launcher.firstMatchName() }
87 100 model :
Quickshell .screens