tonarchy

#+TITLE: Tonarchy

#+AUTHOR: Tony, btw

#+OPTIONS: toc:2 num:nil

* Tonarchy

A zero-dependency Arch Linux installer with a clean TUI built from scratch in C.

*Status:* Alpha - Beginner (XFCE) and Oxidized (OXWM) modes functional, Wayland (Niri) coming soon

* Philosophy

Tonarchy is designed to take users from *zero to hero* with an opinionated beginner mode that sets up a complete, working Linux desktop environment. No choices, no confusion - just a solid foundation to start learning.

For experienced users, the Oxidized mode provides a minimal OXWM setup.

* Installation Modes

** Beginner (XFCE)

Opinionated setup with XFCE desktop, essential applications, and sane defaults. Perfect for your first Linux installation.

** Oxidized (OXWM)

Minimal setup with OXWM (Rust/Lua window manager), Alacritty, and Thunar. Lightweight tiling with Lua configuration.

* Keybindings

** General (XFCE Beginner Mode)

| Key              | Action                |

|------------------+-----------------------|

| Super+Return     | Terminal (Alacritty)  |

| Super+d          | App Launcher (Rofi)   |

| Super+e          | File Manager (Thunar) |

| Super+q          | Close Window          |

| Super+f          | Maximize Window       |

| Super+Shift+f    | Fullscreen            |

** Window Management

| Key              | Action                |

|------------------+-----------------------|

| Super+j          | Cycle Windows         |

| Super+k          | Cycle Windows Reverse |

| Super+Left       | Tile Left             |

| Super+Right      | Tile Right            |

| Super+Up         | Tile Up               |

| Super+Down       | Tile Down             |

** Workspaces

| Key              | Action                |

|------------------+-----------------------|

| Super+1-9        | Switch to Workspace   |

| Super+Shift+1-9  | Move Window to WS     |

| Super+Tab        | Next Workspace        |

| Super+Shift+Tab  | Previous Workspace    |

* Technical Highlights

- *Zero dependencies* :: Raw terminal control using termios + ANSI codes (no ncurses)

- *Single C file* :: Entire installer in ~1500 lines of C

- *Fuzzy finding* :: fzf integration for keyboard and timezone selection

- *Static binary* :: Ships as a single static executable on the ISO

* Requirements

- UEFI or BIOS system

- Internet connection

- Boot from Tonarchy ISO

* Beginner Mode Setup

The beginner installation handles everything:

** Desktop Environment

- XFCE with preconfigured keybindings

- Autologin via getty (no display manager)

- Adwaita-dark theme

** Applications

- Firefox (with uBlock Origin, Dark Reader)

- Neovim

- Alacritty terminal

- Thunar file manager

- VLC media player

- Rofi launcher

** System Configuration

- Locale: =en_US.UTF-8=

- Timezone: User selected via fzf

- Keyboard: User selected via fzf

- NetworkManager enabled

- Sudo configured for wheel group

** Disk Layout (UEFI)

- 1GB FAT32 EFI partition

- 4GB swap partition

- Remaining space for ext4 root

** Disk Layout (BIOS)

- 4GB swap partition

- Remaining space for ext4 root (bootable)

* Roadmap

- [X] XFCE Beginner Mode

- [X] Oxidized Mode (OXWM)

- [X] BIOS support

- [ ] Niri Wayland Mode

- [ ] Encrypted disk support

- [ ] Multi-disk configurations

* Building the ISO

** On Arch Linux

#+BEGIN_SRC bash

make build_iso

./build_iso --container podman

#+END_SRC

Or natively (requires =archiso= and =musl=):

#+BEGIN_SRC bash

make build_iso

./build_iso

#+END_SRC

** On NixOS

#+BEGIN_SRC bash

nix run .#build_iso -- --container podman

#+END_SRC

** Testing

#+BEGIN_SRC bash

make test-nix   # NixOS

make test       # Arch

#+END_SRC

* License

GPL