3 +Goal: rebuild the bar incrementally, one widget/behavior at a time, with Nugu colors, consistent clicks, and verification after each step.
7 +1. Propose exact minimal change.
8 +2. Experiment safely when behavior is unknown.
9 +3. Apply focused changes.
10 +4. Verify live with config validation, service state, logs, screenshots, and interaction tests.
11 +5. Remove superfluous widgets/CSS/scripts.
13 +Originally: stop after each step for discussion.
14 +Current standing goal: continue autonomously to completion while preserving brutal verification.
16 +Order rule: start with Bluetooth as requested, then proceed roughly easiest → hardest.
22 +- Bluetooth stack installed/running: `bluez`, `bluez-utils`, `bluetooth.service` active.
23 +- `bluetui` installed and preferred as Bluetooth manager.
24 +- Ironbar Bluetooth widget is status-only; builtin popup disabled because GTK switch popup looked bad.
25 +- Bluetooth left/middle click opens `bluetui` through shared Hypr Lua TUI launcher.
26 +- Ironbar icon theme switched to installed `Adwaita`.
27 +- Ironbar `popup_autohide = true` globally.
28 +- WezTerm mux service added under `wezterm/systemd/wezterm-mux-server.service`, enabled and active.
29 +- WezTerm config attaches GUI to Unix mux (`connect unix`) and status shows `MUX` for mux domain.
30 +- Hypr `SUPER+Enter` opens `wezterm connect unix`.
31 +- Hypr TUI app binds:
32 + - `SUPER+E` → `yazi`
33 + - `SUPER+N` → `impala`
34 + - `SUPER+U` → `bluetui`
35 +- TUI launcher activates the newly spawned WezTerm pane/tab.
36 +- XWayland disabled; obsolete XWayland drag workaround removed.
37 +- Mouse accel switched to adaptive; natural scroll enabled.
42 +- Physical wheel/trackpad scroll over the volume module remains unverified because `wdotool scroll` does not trigger Ironbar layer-shell scroll events here.
43 +- Existing visible WezTerm local-domain sessions may need manual migration/closure; no seamless transfer to mux known.
45 +##
Current live audit 47 +- Repo clean, ahead of origin; Ironbar commits are local.
48 +- Running services verified active: `ironbar.service`, `ironbar-workspaces.service`, `mako.service`, `hyprpaper.service`, `pipewire-pulse.socket`, system `upower.service`, system `bluetooth.service`.
49 +- Resource usage after settling: `ironbar` about 1.3% CPU / 77M RSS; `workspaces-watch.py` 0.0% CPU / 15M RSS.
50 +- Regions use Ironbar `start` / `center` / `end` boxes:
51 + - start: custom workspace switcher, clipboard, bindmode
52 + - center: music, clock
53 + - end: Mako status, WiFi, Bluetooth, tray, CPU, volume, brightness, battery, inhibit, power
55 + - Mako status script: 5000ms, shell + `makoctl list | grep`
56 + - WiFi status script: 30000ms, shell + `iwctl station wlan0 show`
57 + - sys_info CPU: interval 2
58 + - workspace state: Hypr socket2 event watcher, 10s idle refresh, no label polling
60 + - volume: `wpctl set-volume -l 1 @DEFAULT_AUDIO_SINK@ 2%+` / `wpctl set-volume @DEFAULT_AUDIO_SINK@ 2%-`, `smooth_scroll_speed = 1.0`
61 + - brightness: builtin systemd backlight backend, `smooth_scroll_speed = 0.5`
62 +- Hardcoded color grep reports only generated `ironbar/nugu.css`; `style.css` uses semantic Nugu vars.
63 +- Known broken/unproven widget behavior: physical volume scroll only. Slider drag and the configured scroll commands are verified.
67 +- Installed Ironbar: `0.19.0`.
68 +- `ironbar --print-schema` exposes needed modules:
69 + - `battery`, `bindmode`, `bluetooth`, `brightness`, `clipboard`, `clock`, `custom`, `focused`, `inhibit`, `launcher`, `music`, `notifications`, `script`, `sys_info`, `tray`, `volume`, `workspaces`.
70 +- WiFi stack: `iwd` + systemd-networkd.
71 + - `iwd.service`: active.
72 + - `NetworkManager`: not installed.
73 + - Ironbar `network_manager` module is wrong unless we intentionally switch network stacks.
74 +- Notifications: Mako currently.
75 + - Ironbar `notifications` module requires SwayNC.
76 + - SwayNC would replace/compete with Mako, so defer.
77 +- `hyprshutdown` installed; keybind uses `--dry-run`.
78 +- Music config must use `player_type = "mpris"`, not `playerctl`.
79 +- Builtin Ironbar workspaces dispatch legacy Hypr syntax; custom switcher is used for Lua-dispatcher compatibility.
80 +- Workspace highlighting is event-driven via Hypr socket2 + Ironbar vars; no polling labels.
82 +##
Upstream feature note 84 +From Ironbar compiling wiki/features:
86 +- Default build enables all features.
87 +- Custom builds can disable defaults and enable selected features.
88 +- Must enable at least one config feature.
89 +- If custom-building for this setup:
92 +cli,config+json,workspaces+hyprland,focused,launcher,music+mpris,sys_info,script,custom,tray,volume,battery,bluetooth,brightness,bindmode,inhibit,clipboard,clock,notifications
97 +- `cli` implies `ipc`.
98 +- `network_manager` omitted while using `iwd`.
99 +- `notifications` only useful if switching to SwayNC.
101 +##
Preferences / launch policy 103 +- Work one thing at a time: propose → experiment → change → verify.
104 +- Prefer awesome fast TUIs when they exist (`bluetui`, `impala`, `btm`, `wiremix`, `yazi`, etc.).
105 +- Prefer mux-backed WezTerm tabs for TUI apps over standalone terminal windows.
106 +- Prefer implementation logic in Lua over shell snippets; shell command strings are acceptable only at process boundary.
107 +- Prefer `require(...)` modules over `dofile(...)` in normal config and shared helpers.
108 +- Shared TUI launch logic lives in Hypr Lua: `hypr/scripts/tui_tab.lua`.
109 +- Hypr binds call it via `require("scripts.tui_tab")`; Ironbar actions bridge through `hyprctl eval 'require("scripts.tui_tab").spawn(...)'` so both use the same implementation.
110 +- TUI launcher should spawn into WezTerm mux and activate the new pane/tab.
111 +- Keep app-specific service/config files in app dirs when possible, e.g. WezTerm systemd unit under `wezterm/systemd/`.
112 +- Avoid fighting ugly GTK popups when a better TUI exists; use Ironbar as status/launcher if builtin popup is poor.
114 +##
Package/dependency report 127 +- `wezterm-nightly-bin`
134 +sudo pacman -S pavucontrol swaync networkmanager
139 +- `wiremix` replaces `pavucontrol` for audio.
140 +- Mako stays; SwayNC would replace/compete with it.
141 +- WiFi stack stays `iwd` + systemd-networkd; no NetworkManager.
143 +Optional only if requested later:
146 +sudo pacman -S resources
149 +Avoid unless intentionally switching network stack:
152 +sudo pacman -S networkmanager
155 +##
Verification loop for every step 157 +1. Edit only one widget/behavior.
161 + ironbar --validate-config -c ~/.config/ironbar/config.json -t ~/.config/ironbar/style.css
167 + systemctl --user restart ironbar.service
173 + systemctl --user status ironbar.service --no-pager
174 + journalctl --user -u ironbar.service -n 80 --no-pager
177 +5. Screenshot / visual check.
178 +6. Discuss before next step.
182 +- Left: popup or primary action.
183 +- Right: toggle/mute/secondary action.
184 +- Middle: open full external tool/TUI.
185 +- Scroll: adjust continuous value.
186 +- Tooltip: document behavior.
188 +##
WezTerm mux policy 190 +- WezTerm GUI should attach to Unix mux by default:
191 + - `cfg.unix_domains = { { name = "unix", no_serve_automatically = true } }`
192 + - `cfg.default_gui_startup_args = { "connect", "unix" }`
193 +- Mux server is systemd-managed:
194 + - `wezterm/systemd/wezterm-mux-server.service`
195 +- WezTerm status should make mux visible:
196 + - domain `unix` renders as `MUX`.
197 +- Hypr terminal bind should explicitly use mux:
198 + - `wezterm connect unix`
199 +- TUI app launcher should:
200 + 1. spawn into mux with `wezterm cli --prefer-mux spawn -- ...`
201 + 2. capture pane id in Lua
202 + 3. activate pane with `wezterm cli --prefer-mux activate-pane --pane-id ...`
203 +- Existing non-mux GUI sessions cannot be seamlessly transferred into mux; recreate/close manually.
205 +##
Nugu styling rules 207 +- Generated colors stay in `ironbar/nugu.css`.
208 +- Layout/behavior stay in `ironbar/config.json` + `ironbar/style.css`.
210 + - normal fg: `--fg`
211 + - muted/empty: `--muted` / `--unfocus`
212 + - active bg: `--focus`, fg `--on-focus`
213 + - hover/accent bg: `--accent`, fg `--on-focus`
216 +##
Ordered implementation steps 218 +###
Step 1 — Bluetooth — done 220 +Why first: explicit request.
224 +- `bluez` + `bluez-utils` installed by user; `bluetooth.service` active.
225 +- `bluetui` installed and preferred.
226 +- Ironbar builtin `bluetooth` module used only for bar status.
227 +- Builtin Bluetooth popup disabled; GTK switch popup looked bad even after CSS work.
228 +- Left/middle click opens `bluetui` through shared Hypr Lua TUI launcher:
229 + - `hyprctl eval 'require("scripts.tui_tab").spawn("bluetui")'`
230 +- Bar label uses fixed semantic Bluetooth battery icon, not dynamic percentage icon:
231 + - ` {device_battery_percent}%`
232 +- `icon_theme` switched from missing `Papirus` to installed `Adwaita`; broken device image fixed.
236 +- Ironbar config validates.
237 +- Ironbar restarts and stays active.
238 +- Popup autohide works globally.
239 +- Bluetooth status visible; clicks open `bluetui`.
241 +Follow-up if wanted:
243 +- Tune bar label length/format.
244 +- Add notification if Bluetooth disconnected/low battery.
246 +###
Step 2 — baseline validation + obvious fixes 248 +Difficulty: very easy.
252 +- Fix music `player_type`: `playerctl` → `mpris`.
253 +- Add `name`/`class` only where needed for CSS targeting.
259 +- Ironbar starts cleanly.
263 +Difficulty: very easy.
268 +- Improve popover padding/colors if needed.
272 +- Existing tray icons render.
273 +- Menus/popovers readable.
275 +###
Step 4 — clock/calendar colors 281 +- Fix hard-to-read calendar popup.
286 +- Explicit GTK calendar selectors:
287 + - `.popup-clock calendar`
288 + - `.popup-clock calendar header`
289 + - `.popup-clock calendar grid label.day-name`
290 + - `.popup-clock calendar grid label.day-number`
291 + - `.popup-clock calendar grid label.other-month`
292 + - `.popup-clock calendar grid label.today`
293 + - `.popup-clock calendar grid label:selected`
297 +- Popup readable in dark + light.
298 +- Today/current/other-month/day-name colors use Nugu vars.
300 +###
Step 5 — clipboard 306 +- Keep clipboard widget and make behavior explicit.
311 +- Middle: optional external launcher later.
312 +- Right: do **not** clear history unless confirmed.
317 +- Selection/paste still works.
319 +###
Step 6 — volume — done 323 +- Make volume behavior consistent.
327 +- Builtin `volume` module.
328 +- Scroll adjusts PipeWire output volume.
329 +- Right click mutes output.
330 +- Middle click opens `wiremix` through shared Hypr Lua TUI launcher.
331 +- Sources hidden on bar to reduce clutter.
335 +- `pipewire-pulse.socket` active.
336 +- Ironbar logs show volume client connected, no `PAErr(-1)`.
337 +- `wiremix` spawned into WezTerm mux tab and activated.
338 +- Popup/device picker colors fixed for dark+light Nugu.
339 +- Slider drag verified with `wdotool`: volume changed from 55% to 7%, then restored to 55% and unmuted.
340 +- Scroll actions are configured as oneshot scripts and `smooth_scroll_speed = 1.0` is explicit for wheel/trackpad input.
341 +- The exact scroll commands were executed manually: 55% → 57% → 55%.
342 +- `wdotool scroll` does not trigger Ironbar layer-shell scroll events in this live setup, so physical scroll remains the remaining manual check.
344 +###
Step 7 — battery — done 350 +- Add/keep robust battery widget.
354 +- Builtin `battery` module.
355 +- Show icon + percent.
356 +- Style low/critical/charging states using Nugu semantic colors.
360 +- Hidden on machines without `BAT*` via `show_if`.
361 +- Shows X230 battery percentage.
363 +- Warning/critical states styled with Nugu semantic colors.
365 +###
Step 8 — brightness — done 367 +Difficulty: easy-medium.
371 +- Add brightness widget.
375 +- Builtin `brightness` module.
376 +- Use `systemd`/`backlight` backend.
380 +- Builtin brightness module with `systemd`/`intel_backlight` backend.
381 +- Scroll adjusts brightness through Ironbar backend.
382 +- Rejected custom `brightnessctl` script experiment because direct set failed without permission.
386 +- Detects `intel_backlight`.
387 +- Brightness visible/readable in screenshots.
388 +- No config/service errors.
390 +Known issue (scroll does not change brightness):
392 +- `ironbar.service` runs under the user manager, so the process is in a sessionless scope. Ironbar's `systemd` brightness backend calls `org.freedesktop.login1` `SetBrightness`, which is rejected with `org.freedesktop.login1.NotYourDevice: Session is not in foreground, refusing.`
393 +- Root cause is session ownership, not config. The Ironbar config is already correct (`mode.type = systemd`, `smooth_scroll_speed = 0.5`); changing it cannot fix this. The fix is host-side, requires root, and the agent cannot apply it.
395 +Note on `udev` `uaccess`:
397 +- Rejected for this host: the seat's `ActiveSession` is the greeter (Type=wayland, Class=greeter) and the user session is `Idle=yes`. udev `uaccess` hands the device to the session that owns the seat, not the user session ironbar runs in. Live test: after installing `ACTION=="add", SUBSYSTEM=="backlight", TAG+="uaccess"`, `SetBrightness` still returned `NotYourDevice`. Rule was removed. Skip on this seat layout, or also reconfigure seat ownership.
399 +Note on polkit `login1.set-brightness`:
401 +- `NotYourDevice` is raised by `logind` **before** polkit is consulted, so the polkit rule cannot fix it on this seat layout. Staged at `polkit/10-brightness.rules` for completeness; install only after the seat is reconfigured so a real user session owns the foreground.
403 +Arch wiki ([Backlight](https://wiki.archlinux.org/title/Backlight)) recommended fix: udev `RUN+=` to chgrp/chmod the sysfs file, plus the `video` group. sysfs `brightness` is a `DEVICE_ATTR_RW` whose mode is hardcoded `0644`; udev `GROUP=` / `MODE=` keys do **not** apply to sysfs. The rule must include `KERNEL==` to avoid a `RUN+=` flood on every brightness change.
406 + # udev/backlight.rules
407 + ACTION=="add", SUBSYSTEM=="backlight", KERNEL=="intel_backlight", RUN+="/usr/bin/chgrp video /sys/class/backlight/intel_backlight/brightness"
408 + ACTION=="add", SUBSYSTEM=="backlight", KERNEL=="intel_backlight", RUN+="/usr/bin/chmod g+w /sys/class/backlight/intel_backlight/brightness"
412 + doas install -m 0644 /home/oli/Workspace/dotfiles/udev/backlight.rules /etc/udev/rules.d/backlight.rules
413 + doas udevadm control --reload
414 + doas udevadm trigger --subsystem-match=backlight --action=add
415 + doas usermod -aG video oli # log out / log in (or `newgrp video` for current shell)
418 + After that, logind `SetBrightness` from the user session still works through the builtin `systemd` backend; sysfs is also directly writable by members of `video` for any helper that bypasses logind (e.g. `brightnessctl` from inside the user session).
420 +###
Step 9 — bindmode 422 +Difficulty: easy-medium.
426 +- Show Hyprland submap/bindmode only when active.
430 +- Builtin `bindmode` module.
434 +- Hidden during normal use.
435 +- Appears/disappears correctly if a Hypr submap is active.
437 +###
Step 10 — inhibit — done 443 +- Add sleep/lock inhibition toggle.
447 +- Builtin `inhibit` module.
451 +- Left: toggle selected duration.
452 +- Right: cycle duration.
453 +- Format off/on clearly.
457 +- Toggle visible/readable.
458 +- Duration visible in screenshot.
459 +- No Ironbar errors.
461 +###
Step 11 — cute cat widget — skipped/removed 465 +- Cute but superfluous under the current goal.
466 +- Removed after screenshot showed the right/center area was already dense.
470 +- Bar validates/restarts without it.
471 +- Center media has more room.
473 +###
Step 12 — media/player controls — done 479 +- Make media useful and compact.
483 +- Builtin `music` module with MPRIS.
484 +- Format: status icon + truncated title/artist.
485 +- Popup: album art + controls.
489 +- Builtin `music` module with MPRIS.
490 +- Compact title/artist format with truncation.
491 +- No extra scroll action; avoid accidental media changes.
495 +- Firefox/MPRIS player detected.
496 +- Title visible and compact at 1366px.
497 +- Popup styled by Nugu CSS.
499 +###
Step 13 — system monitors 505 +- Add compact system monitor row.
509 +- Builtin `sys_info` module.
516 +- Disk root percent.
521 +- Compact CPU label via builtin `sys_info`.
522 +- Left/middle opens `btm` through shared Hypr Lua TUI launcher.
527 +sudo pacman -S bottom
533 +sudo pacman -S resources
538 +- Values update at sane intervals.
539 +- Compact enough for 1366px.
540 +- No excessive CPU wakeups.
542 +###
Step 14 — power menu 544 +Difficulty: medium-hard.
548 +- Polish power menu using installed `hyprshutdown`.
552 +- `custom` module popup.
556 +- poweroff: `hyprshutdown --post-cmd "systemctl poweroff"`
557 +- reboot: `hyprshutdown --post-cmd "systemctl reboot"`
558 +- logout: `hyprshutdown`
559 +- suspend: `loginctl lock-session && systemctl suspend`
561 +- Popup order puts destructive actions far left and safe lock nearest the right-side opener, avoiding accidental shutdown/reboot from a second click at the trigger position.
566 +- Lock/suspend/logout work.
567 +- Do not test reboot/poweroff without explicit confirmation.
569 +###
Step 15 — notifications — done 574 +- Do not install SwayNC; it would replace/compete with Mako.
575 +- Ironbar builtin `notifications` module remains unused.
579 +- Custom Mako indicator script:
581 + - active notifications: ` N`
582 +- Left click: `makoctl restore`.
583 +- Right click: `makoctl dismiss --all`.
587 +- Mako service active.
588 +- Count visible/readable in screenshots.
589 +- Dismissing all notifications via Mako works.
590 +- No SwayNC dependency.
592 +###
Step 16 — WiFi / network — done 596 +- Keep `iwd` + systemd-networkd.
597 +- Do not install/use NetworkManager.
601 +- Custom script module reads `iwctl station wlan0 show`.
602 +- Connected state is icon-only to reduce clutter.
603 +- Disconnected state shows ` off`.
604 +- Left/middle click opens `impala` through shared Hypr Lua TUI launcher.
608 +- `iwd.service` active.
609 +- `networkctl status wlan0` routable/online.
610 +- WiFi icon visible/readable.
611 +- No NetworkManager dependency.
613 +###
Step 17 — workspaces — done 617 +- Show fixed workspace favorites.
625 +- Empty favorites remain visible.
626 +- Active/occupied/empty states readable.
627 +- Click focuses correct workspace.
631 +- Builtin Ironbar `workspaces` sends legacy `hyprctl dispatch workspace N`.
632 +- Hyprland Lua dispatcher rejects that syntax:
633 + - `error: [string "return hl.dispatch(workspace 1)"]:1: ')' expected near '1'`
637 +- Migrated Hypr workspace rules/binds/window rules to numeric IDs.
638 +- Replaced builtin Ironbar workspaces with a custom workspace switcher.
639 +- Each button uses Lua dispatcher syntax:
640 + - `hyprctl eval 'hl.dispatch(hl.dsp.focus({ workspace = "N" }))'`
641 +- Replaced old polling `ironbar/scripts/workspace-label.lua` with `ironbar/scripts/workspaces-watch.py`.
642 +- Watcher listens to Hypr socket2 and writes Ironbar vars (`#ws1`, `#ws2`, ...), making highlight update immediately on switch.
643 +- Watcher uses direct Hypr Unix socket IPC for state reads and only writes changed Ironbar vars.
644 +- Watcher caches the Hypr socket directory and Nugu CSS vars, avoiding repeated `hyprctl instances` subprocesses and repeated CSS file reads on every workspace event.
645 +- Added `hypr/systemd/ironbar-workspaces.service`, symlink manifest entry, and service enable recipe.
646 +- `ironbar-workspaces.service` is `PartOf=ironbar.service` so bar restarts immediately refresh workspace vars.
647 +- Removed unused builtin `.workspaces` CSS.
648 +- Removed launcher underline styling after screenshot showed it clashed with the active workspace/focused launcher pills.
649 +- Increased system-module spacing slightly; verified clock/power still fit on 1366px.
650 +- Removed unused `.notifications` CSS and normalized `.sysinfo` spacing.
651 +- Removed normal `scratch` workspace from the bar; special scratch remains on `SUPER+S`.
655 +- Hypr reload ok; no config errors.
656 +- Existing named `web`/`term` windows moved to numeric `1`/`3`.
657 +- All six icons visible; no tofu/question mark glyphs.
658 +- Empty workspace active-state update verified 0.2s after click.
659 +- Service active and low overhead: `ironbar` ~1.8% CPU shortly after restart, watcher ~0.2% CPU / 6.6M RSS on X230.
660 +- Clicks verified via `wdotool`:
661 + - workspace `1` focuses `id=1`
662 + - empty workspace `2` focuses `id=2`
663 + - workspace `3` focuses `id=3`
664 +- Ironbar logs contain no workspace dispatch errors after custom switcher.
666 +##
Suggested final bar layout 676 +- focused window module; active app/title was redundant and made the left side noisy.
677 +- launcher module; colorful app/window icons broke the semantic Nugu bar aesthetic.
688 +4. Bluetooth battery/status
699 +- All hover states use the same semantic accent background + on-focus foreground, including music and clipboard.
700 +- Generic `:checked` styling was removed; persistent state is explicit per widget.
701 +- Power and volume checked/focus states are explicitly neutral so clicking elsewhere clears visible highlight.
702 +- Clock popup time/month/year/arrows/days were screenshot-verified readable after GTK calendar selector fixes.
703 +- Clipboard grouped with left utilities; notifications grouped with right status.
704 +- Bar edge padding increased so power does not sit flush against the display edge.
705 +- Region/group spacing added between workspace/utility and right-side connectivity/metrics/inhibit groups.
706 +- Active workspace pill widened to make instant highlight easier to see.
707 +- WiFi polling relaxed to 30s because connected state is icon-only and detail action opens `impala`.
708 +- Ironbar systemd unit sets `GSK_RENDERER=cairo`; this removes GTK/Mesa Vulkan startup noise on X230 while staying around 1.5% CPU / 77M RSS after settling.
709 +- Destructive power actions were not clicked during validation.
710 +- Power popup visual test confirmed destructive off/reboot buttons sit away from the opener cursor side.
714 +- Media scroll: next/prev, volume, or none? Current: no scroll action.
715 +- Optional later: richer Mako popup/history UI. Current: compact count + restore/dismiss actions.