steam-frame/saphid--frame-control
1
0 Fork 0
mirror of https://github.com/saphid/frame-control.git synced 2026-10-06 05:02:50 +02:00
Code Issues Packages Projects Releases 6 Wiki Activity

Test against Valve's own Steam Frame OS from its recovery image

Browse Source 
tests/frame-container/frame-image.sh extracts rootfs-A from Valve's Frame
recovery image (steamdeck-images.steamos.cloud/recovery), mounts it read-only
with a throwaway writable layer and starts the image's own sshd, so the iPhone
app can pair with and run its server on the real SteamOS for Frame userland.
Verified: password pairing then key login in the image's sshd log, the power
password check through the image's sudo, status reading SteamOS 0.3.0.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
This commit is contained in:
saphidandClaude Opus 5.5 committed 2026-09-27 16:59:01 +10:00
1 parent b1fa3afd40
commit d65f7130d5
3 files changed
+62 -5
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

tests/frame-container/README.md
+23 -2
View File
@@ -1,6 +1,27 @@
# A Frame stand-in for testing without the headset
# Testing without the headset
Valve publishes no Steam Frame OS image. This builds the closest thing: Valve and
## Valve's own Frame OS, from its recovery image
Valve publishes a Steam Frame recovery image at
https://steamdeck-images.steamos.cloud/recovery/ (`steamframe-oobe-repair-*.img.bz2`,
~4 GB). `frame-image.sh` extracts its `rootfs-A` partition (btrfs), mounts it
read-only with a throwaway writable layer, and starts the image's own sshd on
port 2223, so the iPhone app can pair with, and run its server on, the real
SteamOS for Frame userland (Python, sudo, sshd, PAM). It needs Linux with btrfs,
e.g. Colima's VM on a Mac:
```sh
colima start --arch aarch64 --vm-type vz
colima ssh -- sudo sh tests/frame-container/frame-image.sh ~/Downloads/steamframe-oobe-repair-<build>.img.bz2
# pair with 127.0.0.1:2223, user steamos, password frame-test-pw
```
The image's kernel is built for the Frame's Qualcomm chip, so this runs its
userland, not the whole OS: no SteamVR, Steam client, battery or Lepton.
## Holo Core stand-in
A lighter option: Valve and
Collabora's [Holo Core aarch64 preview](https://www.collabora.com/news-and-blog/news-and-events/building-an-arch-linux-aarch64-port-for-holo-core.html)
(the Arch Linux ARM64 base the Frame's SteamOS is built on) with the Frame's SSH
surface: a `steamos` user with a password and sudo, OpenSSH taking keys and