LiviOS

A lightweight, retro‑inspired Linux distribution designed for clarity, learning, and fun.

LiviOS recreates the charm of classic terminal‑first computing while remaining fully modern and maintainable. It boots directly into a themed Openbox session with a C64‑styled URxvt terminal. The project began as a way to give my daughter a clean, expressive first computer experience and has grown into a systems‑engineering effort focused on reproducibility, clarity, and thoughtful design.

---

✨ Key Features

• Retro C64‑inspired terminal experience
• Instant boot into Openbox
• Unique custom UX throughout (GRUB theme, splash screen, terminal theme, Openbox layout)
• Ultra‑lightweight (32‑bit compatible) — antiX Edition
• Distraction‑free environment for learning and exploration
• Multiple editions (antiX now, openSUSE planned)

---

📚 Documentation Overview

• Project Overview
• Architecture
• Roadmap
• antiX Edition
• openSUSE Edition
• File Manifest

---

🧩 Editions

antiX Edition (current)

Ultra‑lightweight, 32‑bit compatible, designed for older hardware and minimal systems.

openSUSE Edition (planned)

Engineering‑grade, KIWI‑based build system. Directory structure reserved for future development.

---

🗂️ File Manifest

The antiX Edition includes a complete file manifest documenting all custom LiviOS files and their exact locations inside the root filesystem. See: docs/file-manifest/README.md

---

📦 Release Status

• antiX Edition: Active development (pre‑release)
• openSUSE Edition: Planned
• File manifest: Complete for antiX demo
• Build pipeline: Under review (scripts not yet validated)

---

🚀 Roadmap

See: docs/roadmap.md

---

📜 License

Licensed under the GNU General Public License v3.0 (GPLv3).