Home
This documentation covers the v1.0.0 architecture, featuring the Single Source of Truth (SSoT) logic, Atomic State management, and Full Open-Source driver integration.
- 📖 Project Overview: General vision, hardware requirements, and a first look at dynamic mapping features.
- 🚀 Installer Workflow: Technical breakdown of the
install.shlogic, dynamic user detection, and system linking. - 🏗️ Architecture & Stability: How we prevent file corruption using Atomic Writes and loop-based session transitions.
- ⚡ Zero-DM Boot & TTY1: Deep dive on bypassing SDDM/GDM for direct Gamescope GPU access via TTY1.
- 🎮 SteamOS Session Launcher: The core supervisor loop (
session_launch.py) that orchestrates session transitions and atomic state persistence. - ⚙️ Dynamic Gamescope Mapping: How the launcher injects custom Gamescope arguments directly from your YAML configurations.
- 🎮 Universal Game Wrapper (sdy): The discovery engine logic: directory climbing, AppID matching, and per-game
.yamloverrides.
- 🛠️ SteamMachine-DIY Control Center: Managing settings and monitoring real-time logs via the PyQt6 companion app.
- 📦 Backup & Recovery: Using the surgical backup tool to preserve system state, configs, and symbolic links.
- 🔍 Troubleshooting & Logs: Decoding
qlogtags, solving GPU DRI locks, and handling TTY handovers. - ❓ Frequently Asked Questions: Quick answers for the SSoT-based architecture.
- 🔗 Useful Links & Resources: Community tools, external guides, and credits.
This project is open-source and community-driven!
- 💡 Have an idea? Open a Feature Request.
- 🐛 Found a bug? Report it here.
- 🚀 Want to contribute? Feel free to fork the repository and submit a Pull Request!
*Maintained by Daniele Lucca (Lelo) | Back to Repository.