karim
05f0faa500
Ports tonight's live config.kdl fixes into the ISO/fresh-install niri
template so new TANINUX installs get them too, not just this machine:
- gestures { hot-corners { off } }: the native top-left hot corner has no
way to know about a centered multi-monitor layout, so approaching it lets
the cursor slide onto a neighboring output before the corner reacts — and
it fired even under fullscreen games. TANINUX already ships its own
configurable Overview trigger (Settings > Display), so the native corner
is pure liability with no unique value.
- Mod+Q { toggle-overview; }: this config's binds{} replaces niri's
defaults wholesale rather than merging, so niri's built-in Mod+O binding
never actually existed here. Q was free (W is close-window).
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 (TIDAL client) has moved to its own repo, taninux-music
(GPL-3.0, depends on taninux[gui]), and is no longer part of the base
ISO.
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.