ckoch/bc250-console
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 1 Wiki Activity

1 Release 1 Tag

RSS Feed
  • v1.0.0 493e4528f3
    Compare

    v1.0.0 — first production release Stable

    ckoch released this 2026-07-18 18:40:08 -04:00 | 0 commits to main since this release

    bc250-console v1.0.0 — first production release

    A complete, reproducible couch gaming console for the AMD BC-250, built as
    a bootc/BlueBuild image on Bazzite GNOME. Validated end-to-end on real
    hardware — this release is what's running in production on the reference
    console.

    Highlights

    • One-command personalized installer: cp console.env.example console.env, fill in your accounts, ./build-console.sh → a 5 GB ISO
      that installs unattended with your users, passwords, and display names
      baked in. No post-install configuration beyond account logins.
    • Kid experience: auto-launching Steam Big Picture, Prism Launcher
      (Minecraft), Heroic, RetroDECK, ProtonUp-Qt, GeForce NOW (browser).
    • Parent experience: SSH always on; Sunshine auto-serves the kid's
      session to Moonlight for full remote control; Tailscale ready;
      operations manual baked at /usr/share/doc/bc250-console/.
    • Appliance behavior: never sleeps/locks, auto-updates OS + apps,
      survives power cuts (AC-switch power design, see WIRING.md).
    • OTA updates: consoles follow
      git.lazypugs.com/ckoch/bc250-console-gnome — this release is also
      published as the v1.0.0 image tag for pinning/rollback.

    Ships workarounds for (see README "Known issues")

    • mutter 50.x screencast cursor-metadata segfault on GFX1013 (kills RDP)
    • Sunshine SIGSEGV probing Vulkan H.264 encode on no-VCN GPUs
    • BlueBuild default-flatpaks@v1 multi-user notify failure
    • bazzite-steam-bpm "ERROR: code=0" login popup
    • GeForce NOW native client hardware-decode requirement (0xC0F11312)

    Docs

    WIRING.md (PSU/power switch) · BIOS-FLASH.md (modded firmware) ·
    BUILD-CONSOLE.md (build + publish) · OPERATIONS.md (day-2 admin)

    Install

    Build your own ISO (credentials are never distributed):

    cp console.env.example console.env   # edit
./build-console.sh

    Flash iso-output/bootiso/bc250-console-gnome.iso — warning: it wipes the
    first disk unattended. Hardware prerequisites in README/BIOS-FLASH.md.

    Downloads