karim
8fb8efcbbd
- tanin-greet.install: post_remove restores the previous greetd config — removing the package no longer leaves greetd pointing at a dead binary - aur-autoupdate: skip packages when the AUR RPC is unreachable instead of building blind (fail closed) - build-tanin-repo: per-package makepkg logs instead of >/dev/null - live ISO: drop sshd.service enablement (root has an empty password on the live medium); encoded in bootstrap-profile.sh so it survives re-bootstrap - gtklock config: de-personalize hardcoded /home/karim path, mark as not-yet-packaged reference - tanin-desktop PKGBUILD: correct stale AUR-vs-extra comments (gtklock, awww, cliphist are in extra), document the eww-git provides=eww contract - docs/distribution.md: mark SigLevel TrustAll as temporary/insecure, add repo-signing TODO (repo-add -s, SigLevel Required), tick done roadmap items - tanin-calendar + niri-config.kdl: pending session work 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.