repositories / dotfiles

dotfiles

bugabingas dorkfiles

owned by bugabinga

docs(quickshell): plan bar status widgets

0543d08bfa0c39f753fda84f0aa986af7475ae90

Oliver Jan Krylow <oliver@bugabinga.net> ·

unsigned

Browse filesCompare with HEAD

Changed files (1)

docs/super/plans/2026-06-17-quickshell-hypr-companions-phase-2b-status-widgets.md

Added
new file mode 100644
1 +# Quickshell Hypr Companions Phase 2B Status Widgets Implementation Plan
3 +> **For agentic workers:** REQUIRED SUB-SKILL: Use /skill:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
5 +**Goal:** Extend the hidden Quickshell bar from Phase 2A with status/service widgets for MPRIS, WiFi, Bluetooth, CPU, volume, brightness, and battery while Ironbar remains live.
7 +**Architecture:** This is the second subplan of Roadmap Phase 2. It adds direct Quickshell-service widgets where APIs exist and bounded process adapters where they do not. Existing Ironbar/Mako services stay active; the Quickshell bar remains shown only by IPC for testing.
9 +**Tech Stack:** Quickshell 0.3.0, QML/QtQuick, `Quickshell.Services.Mpris`, `Quickshell.Services.Pipewire`, `Quickshell.Services.UPower`, `Quickshell.Bluetooth`, `Quickshell.Io.Process`, Nugu Theme service.
11 +**Roadmap:** [`docs/super/roadmaps/2026-06-17-quickshell-hypr-companions-roadmap.md`](../roadmaps/2026-06-17-quickshell-hypr-companions-roadmap.md)
13 +**Architecture Spec:** [`docs/super/specs/2026-06-17-quickshell-hypr-companions-architecture.md`](../specs/2026-06-17-quickshell-hypr-companions-architecture.md)
15 +**API Inventory:** [`docs/super/inventory/2026-06-17-quickshell-phase-2b-service-api-inventory.md`](../inventory/2026-06-17-quickshell-phase-2b-service-api-inventory.md)
17 +**Parity Checklist:** [`docs/super/inventory/2026-06-17-quickshell-parity-checklist.md`](../inventory/2026-06-17-quickshell-parity-checklist.md)
19 +**Phase:** Phase 2B: Status/service widgets
21 +---
23 +## Scope Boundary
25 +This plan implements only these Ironbar parity rows:
27 +- MPRIS music text.
28 +- WiFi status + impala launcher.
29 +- Bluetooth status + bluetui launcher.
30 +- CPU status + btm launcher.
31 +- Volume status/scroll/mute + wiremix launcher.
32 +- Brightness status/scroll.
33 +- Battery status + upower terminal launcher.
35 +Out of scope:
37 +- Tray.
38 +- Clipboard entry point.
39 +- Bind mode.
40 +- Notification bridge.
41 +- Inhibit.
42 +- Power menu.
43 +- Clock calendar popup.
44 +- Retiring Ironbar or `ironbar-workspaces`.
45 +- Hypr bind migration.
47 +Phase boundary: after this plan, Quickshell can show a richer partial bar on demand. Ironbar remains enabled and authoritative.
49 +## File Structure
51 +Create:
53 +- `quickshell/nugu/Commands.qml` — central external process launcher.
54 +- `quickshell/nugu/StatusItem.qml` — compact interactive text item with left/middle/right/wheel signals.
55 +- `quickshell/nugu/MediaWidget.qml` — MPRIS title/artist.
56 +- `quickshell/nugu/WifiWidget.qml` — iwd status through bounded `iwctl` poll.
57 +- `quickshell/nugu/BluetoothWidget.qml` — Quickshell Bluetooth service status.
58 +- `quickshell/nugu/CpuWidget.qml` — `/proc/stat` CPU percentage sampler.
59 +- `quickshell/nugu/VolumeWidget.qml` — Pipewire sink volume/mute.
60 +- `quickshell/nugu/BrightnessWidget.qml` — `brightnessctl -m` status + scroll commands.
61 +- `quickshell/nugu/BatteryWidget.qml` — UPower display device status.
63 +Modify:
65 +- `quickshell/nugu/shell.qml` — instantiate `Commands` and pass it into bars.
66 +- `quickshell/nugu/Bar.qml` — add center media widget and end status widgets.
67 +- `quickshell/nugu/README.md` — document Phase 2B coverage.
69 +Do not modify:
71 +- `hypr/modules/*`.
72 +- `ironbar/*`.
73 +- `mako/*`.
74 +- service manifests.
76 +## Task 1: Add command boundary
78 +**Files:**
80 +- Create: `quickshell/nugu/Commands.qml`
82 +- [ ] **Step 1: Write `Commands.qml`**
84 +Create this file exactly:
86 +```qml
87 +import QtQuick
88 +import Quickshell.Io
90 +QtObject {
91 + id: root
93 + property string sessionSlice: "session-graphical.slice"
94 + property string workSlice: "work.slice"
96 + function detached(args: var): void {
97 + runner.command = args
98 + runner.startDetached()
99 + }
101 + function uwsm(slice: string, args: var): var {
102 + return ["uwsm", "app", "-s", slice, "--"].concat(args)
105 + function tui(slice: string, name: string): void {
106 + detached(uwsm(slice, ["wezterm", "start", "--class", name, "--", name]))
109 + function openWifi(): void { tui(sessionSlice, "impala") }
110 + function openBluetooth(): void { tui(sessionSlice, "bluetui") }
111 + function openSystemMonitor(): void { tui(workSlice, "btm") }
112 + function openAudioMixer(): void { tui(sessionSlice, "wiremix") }
114 + function openBattery(): void {
115 + detached(uwsm(sessionSlice, [
116 + "wezterm", "start", "--class", "battery", "--",
117 + "nu", "-c", "loop { clear; upower -i /org/freedesktop/UPower/devices/battery_BAT0; sleep 2sec }"
118 + ]))
121 + Process { id: runner }
123 +```
125 +- [ ] **Step 2: Wire `Commands` into `shell.qml`**
127 +In `quickshell/nugu/shell.qml`, add this after `Theme { id: theme }`:
129 +```qml
130 + Commands { id: commands }
131 +```
133 +In the `Bar { ... }` delegate, add:
135 +```qml
136 + commands: commands
137 +```
139 +Expected `Bar` block shape:
141 +```qml
142 + Bar {
143 + required property var modelData
145 + screen: modelData
146 + theme: theme
147 + commands: commands
148 + shown: root.barVisible
150 +```
152 +## Task 2: Add interactive status primitive
154 +**Files:**
156 +- Create: `quickshell/nugu/StatusItem.qml`
158 +- [ ] **Step 1: Write `StatusItem.qml`**
160 +Create this file exactly:
162 +```qml
163 +import QtQuick
165 +Item {
166 + id: root
168 + required property QtObject theme
169 + property string text: ""
170 + property bool muted: false
171 + property bool warning: false
172 + property bool critical: false
173 + property bool active: false
174 + property int minWidth: 0
176 + signal leftClicked()
177 + signal middleClicked()
178 + signal rightClicked()
179 + signal wheelUp()
180 + signal wheelDown()
182 + implicitWidth: Math.max(minWidth, label.implicitWidth + 14)
183 + implicitHeight: 22
184 + visible: text.length > 0
186 + Rectangle {
187 + anchors.fill: parent
188 + radius: 7
189 + color: root.active ? root.theme.ui.focus : (mouse.containsMouse ? root.theme.ui.accent : "transparent")
192 + Text {
193 + id: label
194 + anchors.centerIn: parent
195 + text: root.text
196 + color: root.active || mouse.containsMouse
197 + ? root.theme.content.backdrop
198 + : (root.critical ? root.theme.error : (root.warning ? root.theme.warning : (root.muted ? root.theme.ui.minor : root.theme.ui.normal)))
199 + font.family: "IBM Plex Mono"
200 + font.pixelSize: 12
201 + font.features: { "tnum": 1 }
202 + elide: Text.ElideRight
203 + width: Math.min(implicitWidth, 240)
206 + MouseArea {
207 + id: mouse
208 + anchors.fill: parent
209 + hoverEnabled: true
210 + acceptedButtons: Qt.LeftButton | Qt.MiddleButton | Qt.RightButton
211 + onClicked: mouse => {
212 + if (mouse.button === Qt.MiddleButton) root.middleClicked()
213 + else if (mouse.button === Qt.RightButton) root.rightClicked()
214 + else root.leftClicked()
216 + onWheel: wheel => {
217 + if (wheel.angleDelta.y > 0) root.wheelUp()
218 + else if (wheel.angleDelta.y < 0) root.wheelDown()
222 +```
224 +- [ ] **Step 2: Validate shell still parses**
226 +Run:
228 +```bash
229 +timeout 3s qs -p quickshell/nugu/shell.qml >/tmp/nugu-qs-2b-primitive.out 2>/tmp/nugu-qs-2b-primitive.err; code=$?; printf 'exit=%s\n' "$code"; sed -n '1,160p' /tmp/nugu-qs-2b-primitive.err
230 +```
232 +Expected: exit `124`, no QML parse/type errors.
234 +## Task 3: Add MPRIS media widget
236 +**Files:**
238 +- Create: `quickshell/nugu/MediaWidget.qml`
240 +- [ ] **Step 1: Write `MediaWidget.qml`**
242 +Create this file exactly:
244 +```qml
245 +import QtQuick
246 +import Quickshell.Services.Mpris
247 +import "."
249 +StatusItem {
250 + id: root
252 + required property QtObject theme
254 + readonly property var player: Mpris.players.values.find(p => p.isPlaying) || Mpris.players.values[0] || null
255 + readonly property string title: player ? (player.trackTitle || "") : ""
256 + readonly property string artist: player ? (player.trackArtist || "") : ""
257 + readonly property string joined: title.length > 0 && artist.length > 0 ? `${title} / ${artist}` : (title || artist)
259 + text: joined.length > 42 ? `${joined.slice(0, 39)}…` : joined
260 + minWidth: 0
262 +```
264 +- [ ] **Step 2: Add media widget to `Bar.qml` center before clock**
266 +In the center `RowLayout`, replace:
268 +```qml
269 + ClockWidget { theme: root.theme }
270 +```
272 +with:
274 +```qml
275 + MediaWidget { theme: root.theme }
276 + ClockWidget { theme: root.theme }
277 +```
279 +- [ ] **Step 3: Parse-check**
281 +Run:
283 +```bash
284 +timeout 3s qs -p quickshell/nugu/shell.qml >/tmp/nugu-qs-2b-media.out 2>/tmp/nugu-qs-2b-media.err; code=$?; printf 'exit=%s\n' "$code"; sed -n '1,180p' /tmp/nugu-qs-2b-media.err
285 +```
287 +Expected: exit `124`, no QML errors mentioning `Mpris` or `MediaWidget`.
289 +## Task 4: Add Pipewire volume widget
291 +**Files:**
293 +- Create: `quickshell/nugu/VolumeWidget.qml`
295 +- [ ] **Step 1: Write `VolumeWidget.qml`**
297 +Create this file exactly:
299 +```qml
300 +import QtQuick
301 +import Quickshell.Services.Pipewire
302 +import "."
304 +StatusItem {
305 + id: root
307 + required property QtObject theme
308 + required property QtObject commands
310 + readonly property var sink: Pipewire.defaultAudioSink
311 + readonly property var audio: sink ? sink.audio : null
312 + readonly property int percent: audio ? Math.round(audio.volume * 100) : 0
314 + text: audio ? `${audio.muted ? "󰝟" : "󰕾"} ${percent}%` : ""
315 + muted: audio ? audio.muted : true
316 + minWidth: 52
318 + PwObjectTracker { objects: [ Pipewire.defaultAudioSink ] }
320 + onWheelUp: if (audio) audio.volume = Math.min(1.0, audio.volume + 0.02)
321 + onWheelDown: if (audio) audio.volume = Math.max(0.0, audio.volume - 0.02)
322 + onRightClicked: if (audio) audio.muted = !audio.muted
323 + onMiddleClicked: commands.openAudioMixer()
325 +```
327 +- [ ] **Step 2: Add volume widget to `Bar.qml` end section**
329 +In the end `RowLayout` that is currently empty, add:
331 +```qml
332 + VolumeWidget { theme: root.theme; commands: root.commands }
333 +```
335 +- [ ] **Step 3: Parse-check**
337 +Run:
339 +```bash
340 +timeout 3s qs -p quickshell/nugu/shell.qml >/tmp/nugu-qs-2b-volume.out 2>/tmp/nugu-qs-2b-volume.err; code=$?; printf 'exit=%s\n' "$code"; sed -n '1,200p' /tmp/nugu-qs-2b-volume.err
341 +```
343 +Expected: exit `124`, no QML errors mentioning `Pipewire`, `PwObjectTracker`, or `VolumeWidget`.
345 +## Task 5: Add UPower battery widget
347 +**Files:**
349 +- Create: `quickshell/nugu/BatteryWidget.qml`
351 +- [ ] **Step 1: Write `BatteryWidget.qml`**
353 +Create this file exactly:
355 +```qml
356 +import QtQuick
357 +import Quickshell.Services.UPower
358 +import "."
360 +StatusItem {
361 + id: root
363 + required property QtObject theme
364 + required property QtObject commands
366 + readonly property var device: UPower.displayDevice
367 + readonly property bool ready: device && device.ready
368 + readonly property int percent: ready ? Math.round(device.percentage) : 0
369 + readonly property bool hasBattery: UPower.devices.values.some(d => d.isLaptopBattery)
371 + text: hasBattery && ready ? `󰁹 ${percent}%` : ""
372 + warning: percent <= 20 && percent > 5
373 + critical: UPower.onBattery && percent <= 5
374 + minWidth: 52
376 + onLeftClicked: commands.openBattery()
377 + onMiddleClicked: commands.openBattery()
379 +```
381 +- [ ] **Step 2: Add battery widget to `Bar.qml` end section after volume**
383 +Add:
385 +```qml
386 + BatteryWidget { theme: root.theme; commands: root.commands }
387 +```
389 +- [ ] **Step 3: Parse-check**
391 +Run:
393 +```bash
394 +timeout 3s qs -p quickshell/nugu/shell.qml >/tmp/nugu-qs-2b-battery.out 2>/tmp/nugu-qs-2b-battery.err; code=$?; printf 'exit=%s\n' "$code"; sed -n '1,200p' /tmp/nugu-qs-2b-battery.err
395 +```
397 +Expected: exit `124`, no QML errors mentioning `UPower` or `BatteryWidget`.
399 +## Task 6: Add Bluetooth widget
401 +**Files:**
403 +- Create: `quickshell/nugu/BluetoothWidget.qml`
405 +- [ ] **Step 1: Write `BluetoothWidget.qml`**
407 +Create this file exactly:
409 +```qml
410 +import QtQuick
411 +import Quickshell.Bluetooth
412 +import "."
414 +StatusItem {
415 + id: root
417 + required property QtObject theme
418 + required property QtObject commands
420 + readonly property var adapter: Bluetooth.defaultAdapter
421 + readonly property var connected: Bluetooth.devices.values.find(d => d.connected) || null
422 + readonly property int batteryPercent: connected && connected.batteryAvailable ? Math.round(connected.battery * 100) : -1
424 + text: !adapter ? "" : (!adapter.enabled ? "󰂲" : (connected ? (batteryPercent >= 0 ? `󰂱 ${batteryPercent}%` : "󰂱") : "󰂯"))
425 + muted: !adapter || !adapter.enabled
426 + minWidth: connected && batteryPercent >= 0 ? 50 : 18
428 + onLeftClicked: commands.openBluetooth()
429 + onMiddleClicked: commands.openBluetooth()
431 +```
433 +- [ ] **Step 2: Add Bluetooth widget to `Bar.qml` end section before volume**
435 +Add:
437 +```qml
438 + BluetoothWidget { theme: root.theme; commands: root.commands }
439 +```
441 +Place it before `VolumeWidget`.
443 +- [ ] **Step 3: Parse-check**
445 +Run:
447 +```bash
448 +timeout 3s qs -p quickshell/nugu/shell.qml >/tmp/nugu-qs-2b-bluetooth.out 2>/tmp/nugu-qs-2b-bluetooth.err; code=$?; printf 'exit=%s\n' "$code"; sed -n '1,200p' /tmp/nugu-qs-2b-bluetooth.err
449 +```
451 +Expected: exit `124`, no QML errors mentioning `Quickshell.Bluetooth` or `BluetoothWidget`.
453 +## Task 7: Add WiFi iwd widget
455 +**Files:**
457 +- Create: `quickshell/nugu/WifiWidget.qml`
459 +- [ ] **Step 1: Write `WifiWidget.qml`**
461 +Create this file exactly:
463 +```qml
464 +import QtQuick
465 +import Quickshell.Io
466 +import "."
468 +StatusItem {
469 + id: root
471 + required property QtObject theme
472 + required property QtObject commands
474 + property bool connected: false
476 + text: connected ? "󰖩" : "󰖪 off"
477 + muted: !connected
478 + minWidth: connected ? 28 : 52
480 + onLeftClicked: commands.openWifi()
481 + onMiddleClicked: commands.openWifi()
483 + Timer {
484 + running: true
485 + repeat: true
486 + interval: 30000
487 + triggeredOnStart: true
488 + onTriggered: poll.exec(["sh", "-c", "iwctl station wlan0 show 2>/dev/null | sed 's/\\x1b\\[[0-9;]*m//g'"])
491 + Process {
492 + id: poll
493 + stdout: StdioCollector {
494 + onStreamFinished: root.connected = this.text.indexOf("State") >= 0 && this.text.indexOf("connected") >= 0
498 +```
500 +- [ ] **Step 2: Add WiFi widget to `Bar.qml` end section before Bluetooth**
502 +Add:
504 +```qml
505 + WifiWidget { theme: root.theme; commands: root.commands }
506 +```
508 +Place it before `BluetoothWidget`.
510 +- [ ] **Step 3: Parse-check**
512 +Run:
514 +```bash
515 +timeout 3s qs -p quickshell/nugu/shell.qml >/tmp/nugu-qs-2b-wifi.out 2>/tmp/nugu-qs-2b-wifi.err; code=$?; printf 'exit=%s\n' "$code"; sed -n '1,220p' /tmp/nugu-qs-2b-wifi.err
516 +```
518 +Expected: exit `124`, no QML errors mentioning `Process`, `StdioCollector`, or `WifiWidget`.
520 +## Task 8: Add CPU widget
522 +**Files:**
524 +- Create: `quickshell/nugu/CpuWidget.qml`
526 +- [ ] **Step 1: Write `CpuWidget.qml`**
528 +Create this file exactly:
530 +```qml
531 +import QtQuick
532 +import Quickshell.Io
533 +import "."
535 +StatusItem {
536 + id: root
538 + required property QtObject theme
539 + required property QtObject commands
541 + property int lastIdle: 0
542 + property int lastTotal: 0
543 + property int percent: 0
545 + text: ` ${percent}%`
546 + minWidth: 54
548 + onLeftClicked: commands.openSystemMonitor()
549 + onMiddleClicked: commands.openSystemMonitor()
551 + Timer {
552 + running: true
553 + repeat: true
554 + interval: 2000
555 + triggeredOnStart: true
556 + onTriggered: poll.exec(["sh", "-c", "awk '/^cpu /{print}' /proc/stat"])
559 + Process {
560 + id: poll
561 + stdout: StdioCollector {
562 + onStreamFinished: {
563 + const parts = this.text.trim().split(/\s+/).slice(1).map(x => parseInt(x, 10))
564 + if (parts.length < 5) return
565 + const idle = parts[3] + parts[4]
566 + const total = parts.reduce((a, b) => a + b, 0)
567 + const deltaIdle = idle - root.lastIdle
568 + const deltaTotal = total - root.lastTotal
569 + if (root.lastTotal > 0 && deltaTotal > 0) {
570 + root.percent = Math.max(0, Math.min(100, Math.round((1 - deltaIdle / deltaTotal) * 100)))
572 + root.lastIdle = idle
573 + root.lastTotal = total
578 +```
580 +- [ ] **Step 2: Add CPU widget to `Bar.qml` end section before volume**
582 +Add:
584 +```qml
585 + CpuWidget { theme: root.theme; commands: root.commands }
586 +```
588 +Place it before `VolumeWidget`.
590 +- [ ] **Step 3: Parse-check**
592 +Run:
594 +```bash
595 +timeout 3s qs -p quickshell/nugu/shell.qml >/tmp/nugu-qs-2b-cpu.out 2>/tmp/nugu-qs-2b-cpu.err; code=$?; printf 'exit=%s\n' "$code"; sed -n '1,220p' /tmp/nugu-qs-2b-cpu.err
596 +```
598 +Expected: exit `124`, no QML errors mentioning `CpuWidget`.
600 +## Task 9: Add brightness widget
602 +**Files:**
604 +- Create: `quickshell/nugu/BrightnessWidget.qml`
606 +- [ ] **Step 1: Write `BrightnessWidget.qml`**
608 +Create this file exactly:
610 +```qml
611 +import QtQuick
612 +import Quickshell.Io
613 +import "."
615 +StatusItem {
616 + id: root
618 + required property QtObject theme
620 + property int percent: 0
622 + text: `󰃠 ${percent}%`
623 + minWidth: 52
625 + function refresh(): void {
626 + read.exec(["brightnessctl", "-m"])
629 + onWheelUp: change.exec(["brightnessctl", "-e4", "-n2", "set", "5%+"])
630 + onWheelDown: change.exec(["brightnessctl", "-e4", "-n2", "set", "5%-"])
632 + Timer {
633 + running: true
634 + repeat: true
635 + interval: 10000
636 + triggeredOnStart: true
637 + onTriggered: root.refresh()
640 + Process {
641 + id: read
642 + stdout: StdioCollector {
643 + onStreamFinished: {
644 + const fields = this.text.trim().split(",")
645 + if (fields.length >= 4) root.percent = parseInt(fields[3].replace("%", ""), 10)
650 + Process {
651 + id: change
652 + onExited: root.refresh()
655 +```
657 +- [ ] **Step 2: Add brightness widget to `Bar.qml` end section after volume**
659 +Add:
661 +```qml
662 + BrightnessWidget { theme: root.theme }
663 +```
665 +Place it after `VolumeWidget` and before `BatteryWidget`.
667 +- [ ] **Step 3: Parse-check**
669 +Run:
671 +```bash
672 +timeout 3s qs -p quickshell/nugu/shell.qml >/tmp/nugu-qs-2b-brightness.out 2>/tmp/nugu-qs-2b-brightness.err; code=$?; printf 'exit=%s\n' "$code"; sed -n '1,220p' /tmp/nugu-qs-2b-brightness.err
673 +```
675 +Expected: exit `124`, no QML errors mentioning `BrightnessWidget`.
677 +## Task 10: Finalize `Bar.qml` status order
679 +**Files:**
681 +- Modify: `quickshell/nugu/Bar.qml`
683 +- [ ] **Step 1: Ensure end section has this exact Phase 2B order**
685 +The end `RowLayout` should contain exactly these widgets in this order for Phase 2B:
687 +```qml
688 + WifiWidget { theme: root.theme; commands: root.commands }
689 + BluetoothWidget { theme: root.theme; commands: root.commands }
690 + CpuWidget { theme: root.theme; commands: root.commands }
691 + VolumeWidget { theme: root.theme; commands: root.commands }
692 + BrightnessWidget { theme: root.theme }
693 + BatteryWidget { theme: root.theme; commands: root.commands }
694 +```
696 +- [ ] **Step 2: Ensure `Bar.qml` has `commands` property**
698 +Near the top of `PanelWindow`, ensure:
700 +```qml
701 + required property QtObject commands
702 +```
704 +- [ ] **Step 3: Parse-check full Phase 2B bar**
706 +Run:
708 +```bash
709 +timeout 3s qs -p quickshell/nugu/shell.qml >/tmp/nugu-qs-2b-full.out 2>/tmp/nugu-qs-2b-full.err; code=$?; printf 'exit=%s\n' "$code"; sed -n '1,260p' /tmp/nugu-qs-2b-full.err
710 +```
712 +Expected: exit `124`, no QML parse/type errors.
714 +## Task 11: Live IPC validation with Ironbar still active
716 +**Files:**
718 +- No tracked file changes.
720 +- [ ] **Step 1: Start temporary named config**
722 +Run:
724 +```bash
725 +mkdir -p ~/.config/quickshell
726 +ln -sfn "$PWD/quickshell/nugu" ~/.config/quickshell/nugu
727 +QS_NO_RELOAD_POPUP=1 qs -c nugu >/tmp/nugu-qs-2b-ipc.out 2>/tmp/nugu-qs-2b-ipc.err &
728 +printf '%s\n' $! >/tmp/nugu-qs-2b-ipc.pid
729 +sleep 2
730 +sed -n '1,220p' /tmp/nugu-qs-2b-ipc.err
731 +```
733 +Expected: no QML parse/type errors. Ironbar remains active.
735 +- [ ] **Step 2: Show bar**
737 +Run:
739 +```bash
740 +qs -c nugu ipc call nugu showBar
741 +sleep 2
742 +```
744 +Expected: Quickshell bar appears with Phase 2A widgets plus MPRIS/status widgets.
746 +- [ ] **Step 3: Validate visible local statuses**
748 +Manual observations to record:
750 +- Volume shows current muted/percent state (`wpctl get-volume @DEFAULT_AUDIO_SINK@` baseline was muted 30%).
751 +- Brightness shows percent close to `brightnessctl -m`.
752 +- Battery shows X230 battery percent close to `upower`.
753 +- WiFi shows connected icon `󰖩` on connected iwd state.
754 +- Bluetooth shows enabled icon `󰂯` or connected icon if a device is connected.
755 +- CPU shows ` N%` and changes after a few seconds.
756 +- MPRIS text is empty when no player is active, or `{title} / {artist}` if a player exists.
758 +- [ ] **Step 4: Validate safe interactions**
760 +Actions:
762 +```bash
763 +# external cross-checks after UI interactions
764 +wpctl get-volume @DEFAULT_AUDIO_SINK@
765 +brightnessctl -m
766 +```
768 +Manual interactions:
770 +- Scroll volume up/down: volume changes about 2%.
771 +- Right-click volume: mute toggles.
772 +- Middle-click volume: `wiremix` opens.
773 +- Scroll brightness up/down: backlight changes about 5%.
774 +- Left/middle click WiFi: `impala` opens.
775 +- Left/middle click Bluetooth: `bluetui` opens.
776 +- Left/middle click CPU: `btm` opens.
777 +- Left/middle click battery: upower terminal opens.
779 +- [ ] **Step 5: Hide bar and stop temporary Quickshell**
781 +Run:
783 +```bash
784 +qs -c nugu ipc call nugu hideBar
785 +kill "$(cat /tmp/nugu-qs-2b-ipc.pid)"
786 +rm -f /tmp/nugu-qs-2b-ipc.pid
787 +ps -eo pid,pcpu,rss,comm,args | grep -E 'qs -c nugu|quickshell' | grep -v grep || true
788 +```
790 +Expected: no temporary Quickshell process remains.
792 +## Task 12: README and verification record
794 +**Files:**
796 +- Modify: `quickshell/nugu/README.md`
797 +- Create: `docs/super/inventory/2026-06-17-quickshell-phase-2b-verification.md`
799 +- [ ] **Step 1: Append Phase 2B README section**
801 +Append:
803 +```markdown
805 +## Phase 2B status widgets
807 +Phase 2B adds partial Ironbar status parity while Ironbar remains live:
809 +- MPRIS media text
810 +- iwd WiFi status
811 +- Bluetooth status
812 +- CPU percent
813 +- Pipewire volume/mute with scroll/right-click/middle-click
814 +- Brightness percent with scroll
815 +- UPower battery percent
817 +Still deferred to Phase 2C: tray, clipboard entry point, bind mode, notification bridge, inhibit, power popup, calendar popup, full visual comparison.
818 +```
820 +- [ ] **Step 2: Write verification record**
822 +Run:
824 +```bash
825 +mkdir -p docs/super/inventory
827 + printf '# Quickshell Phase 2B Verification — 2026-06-17\n\n'
828 + printf '## Commands\n\n'
829 + printf -- '- `timeout 3s qs -p quickshell/nugu/shell.qml`\n'
830 + printf -- '- `qs -c nugu ipc call nugu showBar`\n'
831 + printf -- '- `wpctl get-volume @DEFAULT_AUDIO_SINK@`\n'
832 + printf -- '- `brightnessctl -m`\n'
833 + printf -- '- `systemctl --user is-active ironbar.service mako.service`\n\n'
834 + printf '## Final parse stderr\n\n```text\n'
835 + sed -n '1,260p' /tmp/nugu-qs-2b-full.err 2>/dev/null || true
836 + printf '\n```\n\n'
837 + printf '## IPC stderr\n\n```text\n'
838 + sed -n '1,260p' /tmp/nugu-qs-2b-ipc.err 2>/dev/null || true
839 + printf '\n```\n\n'
840 + printf '## Manual observations\n\n'
841 + printf -- '- MPRIS widget matched idle/player state: recorded during execution.\n'
842 + printf -- '- WiFi widget showed iwd connected/off state: recorded during execution.\n'
843 + printf -- '- Bluetooth widget showed adapter/device state: recorded during execution.\n'
844 + printf -- '- CPU widget updated around 2s cadence: recorded during execution.\n'
845 + printf -- '- Volume widget displayed current percent/mute and scroll/right/middle interactions worked: recorded during execution.\n'
846 + printf -- '- Brightness widget displayed percent and scroll changed backlight: recorded during execution.\n'
847 + printf -- '- Battery widget displayed X230 battery percent and click opened battery terminal: recorded during execution.\n'
848 + printf -- '- Ironbar and Mako remained live and were not retired.\n'
849 +} > docs/super/inventory/2026-06-17-quickshell-phase-2b-verification.md
850 +```
852 +- [ ] **Step 3: Confirm old services still run**
854 +Run:
856 +```bash
857 +systemctl --user --no-pager --plain is-active ironbar.service ironbar-workspaces.service mako.service
858 +```
860 +Expected: all three are active.
862 +## Task 13: Commit Phase 2B
864 +**Files:**
866 +- Add/modify all files from prior tasks.
868 +- [ ] **Step 1: Check status**
870 +Run:
872 +```bash
873 +git status --short
874 +```
876 +Expected: only intended Phase 2B files plus pre-existing unrelated dirty work.
878 +- [ ] **Step 2: Commit**
880 +Run:
882 +```bash
883 +git add quickshell/nugu/Commands.qml quickshell/nugu/StatusItem.qml quickshell/nugu/MediaWidget.qml quickshell/nugu/WifiWidget.qml quickshell/nugu/BluetoothWidget.qml quickshell/nugu/CpuWidget.qml quickshell/nugu/VolumeWidget.qml quickshell/nugu/BrightnessWidget.qml quickshell/nugu/BatteryWidget.qml quickshell/nugu/shell.qml quickshell/nugu/Bar.qml quickshell/nugu/README.md docs/super/inventory/2026-06-17-quickshell-phase-2b-verification.md
884 +git commit -m "feat(quickshell): add bar status widgets"
885 +```
887 +## Task 14: Phase boundary check
889 +**Files:**
891 +- No tracked changes unless verification found a bug.
893 +- [ ] **Step 1: Non-mutating final checks**
895 +Run:
897 +```bash
898 +hyprctl configerrors
899 +systemctl --user --no-pager --plain is-active ironbar.service mako.service
900 +ps -eo pid,pcpu,rss,comm,args | grep -E 'ironbar|mako|workspaces-watch|qs -c nugu|quickshell' | grep -v grep || true
901 +```
903 +Expected:
905 +- `hyprctl configerrors` empty.
906 +- Ironbar and Mako active.
907 +- No stray temporary `qs -c nugu` process unless explicitly left running for user review.
909 +- [ ] **Step 2: Report next subplan**
911 +Report:
913 +```text
914 +Phase 2B adds status/service widgets only. Ironbar remains live. Next plan: Phase 2C tray/clipboard/bindmode/notification bridge/inhibit/power/full visual comparison.
915 +```
917 +Do not start Phase 2C implementation in the same execution pass.