Files
steamify-cachyos-live-iso/TODO.md
T

2.9 KiB

To do (Steam Machine edition)

In progress (2026-09-27)

  1. Finish the running build (f663ce8+) on the Steam Machine (~/projects/steammachine-cachyos-live-iso, log ~/projects/iso-build.log; the harmless chown: missing operand error at the end is expected).
  2. Test install in the ISO VM (~/projects/iso-vm): power it off, delete disk.qcow2 and vars.fd (run.sh recreates them), point cachyos.iso at the new ISO, run.sh install --fremont as a user unit. Check:
    • Hello's Install opens Calamares without the "testing ISO" message (version-tag = CachyOS release);
    • Calamares starts without the manual Boost fix;
    • the "Setting up the Steam Machine (Steamify)" step runs;
    • after reboot: /var/log/steamify-install.log (every component OK, exit: 0), SDDM autologin into gamescope (black/looping in the VM is expected; Ctrl+Alt+F3 for a console), first desktop login: Vapor layout, single user's launcher, the app next to Hello. Likely problem: in the chroot uname -r is the live kernel, so the LED module load/check in machine_enable may fail although DKMS built for the installed kernel. Make those checks tolerate a different running kernel.
  3. Steamify PR: feat/defaults-mode (2.6.0, b948c20) in steamify-cachyos, pushed but no PR yet. Open it once the install test passes; the user merges (never commit to main).
  4. Test on the real Steam Machine from a USB stick (gamescope, LEDs, CEC, power-off) before calling the ISO usable.

Later

  • Power-off fix in the live session. Without it the Steam Machine starts again right after shutting down from the live ISO. Build steamify-fremont-poweroff.ko in steamify-prepare.sh against the headers of the ISO's kernel, put it in airootfs/usr/lib/modules/<version>/extra and run depmod (small); or ship DKMS packages from a local repo (~250 MB of headers on the ISO). Later maybe the CEC and LED drivers the same way.
  • Vapor theme in the live session. Add cachyos-vapor to packages_desktop.x86_64 and set it as the live user's look and feel in airootfs/etc/skel (kdeglobals LookAndFeelPackage, no layout file, so Plasma lays out Vapor at the live login).
  • Steamify options in the installer: a Calamares page (netinstall-style YAML or QML) listing Steamify's options; pass the ticked ids to steamify.sh --backend apply <ids> instead of --defaults.
  • Branding: name the ISO file and live session "Steam Machine CachyOS" (not plain cachyos-*.iso); check with the CachyOS team.
  • Release: a CI job that builds the ISO (privileged container, flags from the steam-machine-iso skill) and hosts it (>2 GB, not a GitHub release asset).
  • Drop the Boost 1.91 workaround in steamify-prepare.sh once cachyos-calamares-next is rebuilt against the repos' Boost.

Build and test details: the steam-machine-iso skill in steamify-cachyos-dev.