back to the devlog
In ProductionOperating system2026

MarwanOS

A Fedora-based, image-mode Linux distribution built on bootc and Universal Blue that cold-boots into a gamepad-navigable gaming shell written in Godot 4. The OS is a container image; every change ships as `bootc upgrade` and every mistake is one `bootc rollback` away.

focus

Owning the whole stack of an appliance OS — kernel args, Plymouth splash, greetd/gamescope session, systemd supervision, udev rules — and drawing the only UI the machine ever shows in a Godot shell built TV-first with controller focus, held-direction repeat, and hotplug player-one detection. Architecture decisions are recorded as ADRs and never relitigated.

milestones

  1. 01

    Fedora bootc image with atomic upgrade/rollback, built and pushed to GHCR from GitHub Actions

  2. 02

    Godot 4 shell: controller-navigable tile grid, launch seam, settings/info screens, Wi-Fi seam, dev-mode terminal behind a flag

  3. 03

    Silent boot pipeline: custom Plymouth theme, hidden GRUB, no getty on the appliance — text only reachable via journalctl or devmode ssh

  4. 04

    systemd fleet: app scan/launch control, flatpak install units, flight recorder, boot-success watchdog, USB automount, display/window profiles

  5. 05

    Phase 1 contract: Godot shell ↔ Rust library daemon over JSON-RPC/WebSocket so installs survive shell restarts

  6. 06

    12 architecture decision records covering NVIDIA baseline, compositor choice, single-display appliance model, and an in-house Steam client