karim
30899de5a3
Bundles the pending native-UI session (dark shell, style overhaul, audio page) with review fixes: - native Row: set_subtitle_lines + set_activatable_widget (store and online-accounts pages crashed with AttributeError under TANINUX_UI=native) - wine page routed through the ui seam (last direct Adw import removed) - console: delete no-op log_expander/collapsible_log and .clear() call sites - ui/__init__ docstring now states the actual default backend (native) - tests/test_pages_native.py builds every registered page under the native backend (29 pass; skips headless) Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
TANINUX
Arch-based Linux distro (codename camel) built around the
niri scrollable-tiling Wayland compositor and
a GTK4 desktop with its own accent/theming system. Ships a central
maintenance TUI/GUI plus a small suite of first-party apps, distributed via a
custom [tanin] pacman repo and a Calamares-based installer ISO.
The pillars
The central taninux app is organized around five pillars:
- maintain — scan and clean up (orphans, caches, leftover kernel modules)
- update — aggregate updates from pacman, AUR and flatpak
- kernel — install/remove kernel variants, boot-default management
- suggest — rule-based setup suggestions
- health — system health checks
The apps
| Command | What it is |
|---|---|
taninux |
Maintenance TUI (Textual) |
taninux-gtk |
GTK4 shell |
tsettings |
Settings app (network, display, audio, users, …) |
thub |
Software Hub (repo/AUR/flatpak install) |
tfiles |
Native GTK4 file manager |
tmusic |
Music app |
The GTK apps run on a custom libadwaita-free backend
(src/taninux/gui/ui/native.py + style_apple.css); TANINUX_UI=adw
selects the libadwaita backend.
Installing
On an existing Arch system
Add the [tanin] repo to /etc/pacman.conf (see
docs/distribution.md), then:
pacman -S tanin-desktop # full desktop: niri + eww shell + apps
pacman -S taninux # just the maintenance tool
Via the ISO
See iso/BUILD.md — archiso profile with a Calamares installer (btrfs subvolume layout, snapper/snap-pac).
Repo layout
src/taninux/ Python source: cli, gui, core, pillars, files, music
packaging/ PKGBUILDs + helper scripts for the [tanin] repo packages
iso/ archiso profile (build-profile/ + overrides/) and BUILD.md
distro/ distro-level manifest (camel.toml, MANIFEST.md)
docs/ distribution plan, eww integration contracts
scripts/demo/ visual QA scripts for the native UI backend
Development
uv venv && uv pip install -e ".[gui]" # PyGObject/GTK4 come from pacman
taninux # TUI
TANINUX_UI=native tsettings # settings app, native backend
python scripts/demo/page_demo.py # render single pages for visual QA
Building packages
cd packaging/<pkg> && makepkg -si # single package
./packaging/build-tanin-repo.sh # rebuild the whole [tanin] repo
License
GPL-3.0-or-later — see LICENSE.