TechTux OS is an Arch Linux-based desktop operating system project for x86_64, planned as a bootable live ISO with a KDE Plasma + Wayland desktop and a macOS-inspired visual design.
| Property | Value |
|---|---|
| Project name | TechTux OS |
| Base distribution | Arch Linux |
| Architecture | x86_64 |
| Desktop environment | KDE Plasma + Wayland (planned) |
| Visual design | macOS-inspired, modern, minimal, polished |
| Development host | Windows |
| Virtualization | QEMU |
| Project path | C:\Users\srira\Projects\TechTux |
- A real operating system, not a mockup. TechTux is intended to become a bootable Arch Linux-based desktop OS with its own branding, desktop configuration, system utilities, and eventually an installer.
- Arch Linux base. Simple, modern, rolling-release foundation with access to the official Arch package repositories.
- KDE Plasma on Wayland. Planned desktop environment with a polished, macOS-inspired look: centered bottom dock, clean top panel, consistent icon theme, dark and light appearance options.
- Windows-based development. Source is authored and maintained on Windows. Testing is done exclusively in QEMU virtual machines; TechTux is never installed on the physical laptop during development.
- Safety first. No physical disks, partitions, EFI, or host bootloaders are ever touched. Changes are small, documented, and reviewable.
TechTux/
├── README.md # This file: project overview and status
├── CLAUDE.md # Instructions for AI coding agents
├── .gitignore # Excludes build artifacts, VM disks, secrets
├── docs/ # Project documentation
│ ├── ROADMAP.md # Milestones and delivery plan
│ ├── SAFETY.md # Physical/virtual disk safety rules
│ ├── ARCHITECTURE.md # Planned system components
│ ├── WINDOWS-SETUP.md # Windows development workflow
│ ├── ARCH-BUILD.md # Arch ISO (archiso) build requirements
│ └── QEMU-TESTING.md # Planned QEMU testing procedure
├── assets/branding/ # Visual design specification and brand assets
│ └── README.md # macOS-inspired KDE Plasma design plan
├── profiles/techtux/ # Arch ISO profile (derived from archiso releng)
│ ├── packages.x86_64 # Initial live-desktop package selection
│ └── airootfs/ # Live-system root overlay (pending)
├── scripts/ # Windows PowerShell helper scripts
│ ├── check-environment.ps1
│ ├── validate-profile.ps1
│ └── build-iso.ps1
├── tests/ # Test plans and results
│ └── README.md
├── tools/ # Host-side helper tools
│ └── README.md
└── output/ # Build output (ISO images, logs) — excluded from Git
└── .gitkeep
Phase 1 is repository foundation and documentation only.
| Item | Status |
|---|---|
| Repository inspected | Complete |
| Project documentation | Complete (this file + docs/) |
| Initial package list | Documented in profiles/techtux/packages.x86_64 |
| ISO profile prepared | Partially — package list + profile layout; releng-derived files to be copied/adapted |
| PowerShell validation scripts | Created in scripts/ |
| Windows / Arch build workflows | Documented in docs/ |
| QEMU testing | Documented (not executed) |
| Non-destructive validation | Pending execution |
What does NOT exist yet: a bootable ISO, any virtual disk, any desktop configuration, an installer, or any physical installation.
See docs/ROADMAP.md. Milestones:
- Repository foundation (Phase 1 — current)
- Arch ISO profile derived from the official
relengprofile - First bootable live ISO
- KDE Plasma customization
- TechTux branding and desktop integration
- Hardware and networking tests
- Installer design and implementation
- Update, recovery, and release infrastructure
- No bootable ISO exists. The package list alone is not sufficient to build one; a correct ISO profile, boot configuration, live-system configuration, and an Arch build environment are all required.
- Arch ISO generation uses
archiso(mkarchiso), which does not run on native Windows. An Arch Linux build environment (for example WSL or an Arch virtual machine) is required. - KDE Plasma customization is a design document only; no desktop configuration has been deployed or tested.
- QEMU is installed on the development host but has not been used to boot TechTux.
- No package names in
packages.x86_64have been verified by building; treat the list as a documented plan to validate against https://archlinux.org/packages/ before use.