repositories / dotfiles

dotfiles

bugabingas dorkfiles

owned by bugabinga

docs(quickshell): verify launcher app execution

a91e8aa069de85c71b944340ee3de55f9176a6bb

Oliver Jan Krylow <oliver@bugabinga.net> ·

unsigned

Browse filesCompare with HEAD

Changed files (1)

docs/super/inventory/2026-06-17-quickshell-phase-4b-launcher-app-launch-verification.md

Added
new file mode 100644
1 +# Quickshell Phase 4B Launcher App Launch Verification — 2026-06-17
3 +## Scope
5 +Verified that the native Quickshell launcher can execute a selected desktop entry via Enter. This closes the safe app-launch validation gap without launching a real app and without migrating Hypr binds.
7 +## Test design
9 +A temporary `XDG_DATA_HOME` contained a synthetic desktop entry:
11 +```ini
12 +[Desktop Entry]
13 +Type=Application
14 +Name=Nugu Launcher Smoke
15 +Comment=Temporary Quickshell launcher smoke test
16 +Exec=/tmp/.../nugu-launcher-smoke.sh
17 +Icon=utilities-terminal
18 +Terminal=false
19 +NoDisplay=false
20 +Categories=Utility;
21 +```
23 +The script only wrote `launched` to a temporary marker file. Both the desktop entry and marker were removed after validation.
25 +Temporary `XDG_CONFIG_HOME` named config was used; no live home symlink mutation.
27 +## Commands
29 +```sh
30 +XDG_CONFIG_HOME=<tmp-config> XDG_DATA_HOME=<tmp-data> qs -c nugu
31 +qs ipc -c nugu call nugu openLauncher 'Nugu Launcher Smoke'
32 +qs ipc -c nugu call nugu launcherMatchCount
33 +qs ipc -c nugu call nugu launcherFirstMatchName
34 +wdotool --backend wlr-protocols key Return
35 +qs ipc -c nugu call nugu launcherVisible
36 +```
38 +Observed returns:
40 +```text
41 +open=Nugu Launcher Smoke
42 +count=1
43 +first=Nugu Launcher Smoke
44 +visible_after_enter=false
45 +launched=1
46 +```
48 +`launched=1` means the selected `.desktop` entry executed and wrote the expected marker.
50 +Runtime output:
52 +```text
53 +INFO: Configuration Loaded
54 +```
56 +No QML errors, binding loops, reference errors, annotation warnings, or lingering `qs` process were observed.
58 +## Screenshot
60 +- `/tmp/nugu-qs-launcher-app-smoke.png`
62 +Vision check confirmed:
64 +- search field contains `Nugu Launcher Smoke`
65 +- the single result is the synthetic smoke entry
66 +- style/readability are acceptable
68 +## Still open before replacing `SUPER+Space`
70 +- Live Hypr bind migration once Quickshell service is active/recoverable.
71 +- Human approval that launcher appearance is same/better than current `hyprlauncher`.