GitHub - sriramkanuri-tech/TechTuxOS: TechTuxOS is an Arch based Operating System based on KDE · GitHub
Skip to content
sriramkanuri-techPublic

About

TechTuxOS is an Arch based Operating System based on KDE

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

1 Commit

Folders and files

Repository files navigation

TechTux OS

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.

Project identity

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

Goals and design philosophy

  • 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.

Repository structure

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

Current implementation status (Phase 1)

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.

Build and testing roadmap

See docs/ROADMAP.md. Milestones:

  1. Repository foundation (Phase 1 — current)
  2. Arch ISO profile derived from the official releng profile
  3. First bootable live ISO
  4. KDE Plasma customization
  5. TechTux branding and desktop integration
  6. Hardware and networking tests
  7. Installer design and implementation
  8. Update, recovery, and release infrastructure

Current limitations

  • 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_64 have been verified by building; treat the list as a documented plan to validate against https://archlinux.org/packages/ before use.

About

TechTuxOS is an Arch based Operating System based on KDE

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages