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

54 lines
3.0 KiB
Markdown

# 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.