steamify-cachyos-live-iso/TODO.md

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.
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 wizard pages in the installer, before anything is installed: the same choices as Steamify's menu (conversion, boot into gamescope or desktop, theme, Deck icons, single user, shortcut + non-Steam game, notifications, VRAM booster, HDMI-CEC, Steam Machine support + power-off fix), defaults ticked like a first run. A Calamares page (netinstall-style YAML or a QML module in the show sequence) stores the ticked ids in global storage; steamify-install passes them to steamify.sh --backend apply <ids> (--boot gamescope|desktop) 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.