repositories / dotfiles

dotfiles

bugabingas dorkfiles

owned by bugabinga

docs(quickshell): verify clipboard navigation

b9a64eb4d3383d3d9dec55449c0ac2988bd4e8ea

Oliver Jan Krylow <oliver@bugabinga.net> ·

unsigned

Browse filesCompare with HEAD

Changed files (1)

docs/super/inventory/2026-06-17-quickshell-phase-4c-clipboard-navigation-verification.md

Added
new file mode 100644
1 +# Quickshell Phase 4C Clipboard Navigation Verification — 2026-06-17
3 +## Scope
5 +Verified full Quickshell clipboard picker Up/Down selection, Enter selection, and Escape close behavior with multiple matches. This extends earlier clipboard IPC and keyboard typing verification.
7 +## Test
9 +Two synthetic non-secret clipboard entries with a shared prefix were inserted:
11 +- newer synthetic entry
12 +- older synthetic entry
14 +The previous clipboard text was saved to a temporary file and restored afterward without printing it.
16 +Temporary `XDG_CONFIG_HOME` named config was used; no live home symlink mutation.
18 +## Commands
20 +```sh
21 +qs ipc -c nugu call nugu openClipboardPicker <synthetic-prefix>
22 +qs ipc -c nugu call nugu clipboardPickerMatchCount
23 +qs ipc -c nugu call nugu clipboardPickerFirstPreview
24 +wdotool --backend wlr-protocols key Down
25 +wdotool --backend wlr-protocols key Return
26 +qs ipc -c nugu call nugu clipboardPickerVisible
27 +qs ipc -c nugu call nugu openClipboardPicker <synthetic-prefix>
28 +wdotool --backend wlr-protocols key Escape
29 +qs ipc -c nugu call nugu clipboardPickerVisible
30 +```
32 +Observed returns, redacted:
34 +```text
35 +open=[synthetic-clipboard-entry]
36 +count=2
37 +first=[synthetic-clipboard-entry]
38 +visible_after_enter=false
39 +open2=[synthetic-clipboard-entry]
40 +visible_after_escape=false
41 +selected_expected=1
42 +```
44 +`selected_expected=1` means pressing Down then Enter selected the expected second synthetic row, and `wl-paste --no-newline` matched it.
46 +Runtime output:
48 +```text
49 +INFO: Configuration Loaded
50 +```
52 +No QML errors, binding loops, reference errors, annotation warnings, or lingering `qs` process were observed.
54 +## Screenshots
56 +- `/tmp/nugu-qs-clipboard-nav-initial.png`
57 +- `/tmp/nugu-qs-clipboard-nav-down.png`
59 +Vision checks confirmed:
61 +- two matching synthetic rows are visible
62 +- first row is highlighted initially
63 +- pressing Down moves highlight to the second row
65 +## Still open before replacing `SUPER+V`
67 +- Live Hypr bind migration once Quickshell service is active/recoverable.
68 +- Human approval that picker appearance is same/better than current `hyprlauncher --dmenu`.