taninux/HANDOVER.md

TANINUX — Handover (Session 2026-06-23)

Context for a fresh instance. Repo: ~/projects/taninux (distro codename camel, niri-only GTK4/libadwaita + eww desktop). User: Karim (German; iterates visually; hates UI jank; blanket perms in ~/projects). UI strings are English.

---

THIS SESSION (2026-06-23) — Native GTK4 shell, CSS overhaul

TANINUX_UI=native means the app uses src/taninux/gui/ui/native.py widgets and loads src/taninux/gui/ui/style_apple.css instead of libadwaita. This session fixed the native theme comprehensively.

What was done

src/taninux/gui/ui/style_apple.css

• All hardcoded blue accents (#007aff, #0a84ff, rgba(0,122,255…)) replaced with @accent_color + alpha(@accent_color, 0.10).
• Dark headerbar: rgba(20,20,22,0.97) with box-shadow: none (matches sidebar, no GNOME "lighter band" effect).
• Light headerbar: #ebebeb. Light sidebar: #ebebeb. Light page bg: #f6f6f6 (matches libadwaita white).
• Explicit light-mode text colors (color: #1d1d1f) for all nav rows, nav header, group titles — because GTK4 Adwaita can leave text light-colored in light mode.
• button.suggested-action → background-color: @accent_color !important (was blue).
• progress, trough > progress → background-color: @accent_color !important.
• Nav selection dark: glass wash alpha(@accent_color, 0.18) + border.

src/taninux/gui/style.py

• apply() (native backend): now calls Gtk.Settings.get_default().set_property("gtk-application-prefer-dark-theme", dark) so GTK4 Adwaita widgets (buttons, sliders) follow the chosen scheme.
• _build_css() swatch buttons: selector is now button.fuji-swatch.swatch-{key} with background-color: {hex} !important; background: {hex} !important; — fixes swatches appearing black (Adwaita overrode them without !important).
• Swatch checked state: uses outline: 2px solid {hex}; outline-offset: 3px (removed box-shadow: inset 0 0 0 2px @window_bg_color which was undefined in native mode).
• _set_gsettings(): writes TANINUX-dark/TANINUX as the GTK3 theme (for greetd/GTK3 apps). Also sets color-scheme=prefer-dark/prefer-light. ⚠ This is SYSTEM-WIDE — affects eww and all other GTK4 apps.

src/taninux/gui/pages/settings.py

• persist(): after saving the color scheme, now also calls native.set_dark(root, …) live so the theme switches immediately without restart.

src/taninux/gui/console.py — complete rewrite

• LogConsole is now a plain Python class (NO GTK widget). Writes to ~/.local/share/taninux/taninux.log with timestamps.
• RunnerCard: button only (no embedded log widget). Process output goes to _write_log().
• log_expander() and collapsible_log(): kept as no-ops returning None — all callers already cleaned up.

Log expanders removed from all settings pages: backup.py, update.py, kernel.py, maintain.py, network.py, bluetooth.py, shares.py, bundles.py, appdetail.py, store.py, printers.py — all formerly called log_expander(…) which is now a no-op; the UI no longer has a "Log" section on any page.

PKGBUILDs (packaging/taninux/PKGBUILD, packaging/tanin-desktop/PKGBUILD)

• networkmanager, bluez-utils, wireplumber, brightnessctl, wlsunset, cups, pacman-contrib moved from optdepends → depends in taninux/PKGBUILD.
• wlsunset, cups moved from optdepends → depends in tanin-desktop/PKGBUILD.
• paru, flatpak, timeshift remain optdepends.

Files touched this session

src/taninux/gui/ui/style_apple.css
src/taninux/gui/style.py
src/taninux/gui/pages/settings.py
src/taninux/gui/console.py
src/taninux/gui/pages/{backup,update,kernel,maintain,network,bluetooth,shares,
  bundles,appdetail,store,printers}.py
packaging/taninux/PKGBUILD
packaging/tanin-desktop/PKGBUILD

Current state

Thing	State
Native CSS theme (dark + light)	✅ fixed, live
Accent colors correct (@accent_color)	✅
Live dark/light switch in Settings	✅
Log expanders removed everywhere	✅
PKGBUILDs updated	✅ source only
taninux package rebuilt	❌ needs ./packaging/finish-tanin-repo.sh
tanin-icons built+committed (c5b0848)	✅ from previous session
[tanin] repo published	❌ blocked on TANIN_PKG_TOKEN

---

THE CRITICAL BUG THIS SESSION — awww-daemon black screen

Symptom: Entire desktop goes black (no wallpaper, no windows visible). Opening any eww panel made it worse (visible as black backdrop).

Root cause: awww (the blurred-wallpaper daemon used for niri's Overview backdrop) creates a surface at the Wayland Background layer. After suspend/ resume, awww's cached blurred image goes stale or the surface loses its content → the surface renders as solid black. Because awww-daemon sits ABOVE swaybg in the Background layer stack, it covers the wallpaper entirely.

The transparent panel-backdrop was fine — what appeared "black" was the awww surface showing through the transparent backdrop, covering the wallpaper behind it.

Fix (immediate): pkill awww

• This kills the awww daemon, the black surface disappears from niri's Background layer, swaybg's wallpaper shows through again.

Permanent fix needed (TODO for next session): Option A — Regenerate blur cache on resume: Add a systemd user sleep hook that calls ~/projects/eww/scripts/overview-backdrop.sh sync on post-resume. File: ~/.config/systemd/user/awww-refresh.service + .path. Option B — Make awww not start at login (only at Overview open): Remove awww from launch.sh; call overview-backdrop.sh start only when niri's Overview is about to open. niri has no "overview-opening" IPC event yet → tricky. Option C — Restart awww after resume with a fresh cache: In the sleep hook: pkill awww; sleep 0.5; overview-backdrop.sh start.

Diagnosis dead-ends (don't re-investigate):

• ❌ NOT caused by our ~/.config/gtk-4.0/libadwaita.css (tested: removed → still black)
• ❌ NOT caused by color-scheme=prefer-dark gsettings (tested: default → still black)
• ❌ NOT caused by GSK renderer (GSK_RENDERER=cairo → still black)
• ✅ CONFIRMED: pkill awww → wallpaper returns instantly

---

CURRENT SYSTEM STATE (after this session's debugging)

⚠ gsettings were modified during debugging. Restore if needed:

gsettings set org.gnome.desktop.interface color-scheme prefer-dark
gsettings set org.gnome.desktop.interface gtk-theme TANINUX-dark

The awww daemon was killed (pkill awww). The desktop now shows swaybg's wallpaper correctly. Restarting eww (~/projects/eww/launch.sh) will restart awww via launch.sh — which may make the black screen return. If it does: pkill awww.

---

PREVIOUS SESSION (2026-06-22) — Icon theme

A. New packages in the [tanin] repo

• librewolf-bin, arch-update, timeshift (+ timeshift-autosnap), xdg-terminal-exec added to AUR rebuild list.
• paru built into repo but stays optdepend.
• papirus-folders removed.

B. Icon theme: tanin-icons

Custom package packaging/tanin-icons/ — 5 thin Adwaita-based themes (Tanin-<accent>) that recolour only folder/place icons in Fuji accent hues. Built + committed as c5b0848. Installed to ~/.local/share/icons/Tanin-* (user dir, not pacman). style.py → _set_gsettings() sets icon-theme=Tanin-<accent_key> on accent change. tanin-desktop/PKGBUILD: depends +tanin-icons, removed papirus-icon-theme. ⚠ NOT yet in the published [tanin] repo (needs TANIN_PKG_TOKEN).

---

Gotchas to respect

• NEVER run lock/swaylock/suspend commands to test (locked Karim out once). Exception: Karim explicitly authorised sudo systemctl suspend in the 2026-06-23 session — that's not a standing permission.
• write_global_theme() writes ~/.config/gtk-4.0/libadwaita.css which is read by ALL GTK4 apps including eww (USER priority 800 — above GTK theme). It only defines @define-color vars and button border-radius; it does NOT define window backgrounds. The globals are safe.
• TANINUX tree has unrelated uncommitted files (tanin-calendar, online_accounts, gtklock, iso/) — NOT from this session; do NOT git add -A.
• GTK3 can't exact-Fuji recolour at runtime (parse-time @define-color limit).

Open / not done

• Permanent fix for awww black screen after suspend (see above).
• Rebuild + publish [tanin] repo (needs TANIN_PKG_TOKEN env).
• Rebuild ISO.
• camel.toml rebuilt_aur list is stale (missing librewolf-bin, arch-update, timeshift-autosnap, xdg-terminal-exec).
• Manual icon picker in desktop.py still lists all 5 Tanin-* themes (minor).