saphid / frame-control
git clone https://github.com/saphid/frame-control.git
v0.4.8 · 3d ago
Frame Control: a free, open-source app for Valve Steam Frame on macOS, Windows, Linux and iPhone. View the headset, install games and apps, transfer files, and manage your Frame.
+3
stars, 24h · #8,226
+~9
stars, 7 days · #12,646
+109
stars, 30 days · #6,679
109
★ total · +9% this week
3
forks · 34 open issues
Star history (as recorded here)
LanguagePython
LicenseMIT
Created2026-09-25 (27d ago)
Last push2d ago
Watchers1
OwnerUser
GitHub topics
Links
- GitHub: github.com/saphid/frame-control
- Homepage: https://framecontrol.fun
- Releases · Issues · Hacker News mentions
README excerpt
# Frame Control **Manage your Valve Steam Frame from your computer.** See what the headset sees, install games and Android apps, move files and text across, and check battery and status, all over SSH. **Website** · **Download** · Trailer · Features · Set up the headset · Feedback · Docs The trailer: 66 seconds, with sound. Downloads the MP4 from the trailer release. Unofficial hobby project, not affiliated with Valve. Free and open source. --- ## Features **👓 Headset view and Desktop** Live video of what the lenses show, or of the app panel in use, flat and still however the wearer looks around. Turn on Control and tap or click right on it to use the Frame from your phone or computer. **🔋 Battery and status** Charge, charging watts and time left, storage, memory, temperature, Wi-Fi, and what's running. **🎮 Steam games** Everything you own with its Steam Frame rating. Install onto the headset with live progress, and search the store. **🤖 Android apps** About 4,500 F-Droid apps rated for the Frame. One click installs each as its own app in your Steam library. **📁 Files, games and clipboard** Drag files onto the window to send them. Drop a game's .zip, folder or .exe to add it to the Steam library, with Proton or the Linux runtime picked for you. Send text or your clipboard straight to the headset's desktop. **📸 Screenshots** Browse the shots you take in the headset and save them to your Pictures folder. **⌨️ Keyboard and trackpad** Type and point in the Frame's apps from your computer or phone, through KDE Connect, which Frame Control brings along and sets up on the Frame. Nothing else to install, anywhere. **🧩 Flatpaks and display** Install desktop apps like Moonlight or VLC, and set each Android app's resolution and text size. **⚡ One-click tools** SSH, SFTP, Steam Link, remote desktop, volume, sleep, restart and shut down. The optional Family and comfort card adds session limits, breaks, local alerts and one-click casting. A session copies a small Frame Control worker into your headset user account. For the other features, nothing is installed on the Frame: the app uses what SteamOS already ships (sideloading a game copies Valve's own devkit scripts to `~/devkit-utils`, as Valve's Devkit Client does). The optional performance HUD copies our own Python helpers into `~/.local/share/frame-control/vr/`. How each feature works. ## Install | | Download | Needs | |---|---|---| | **macOS** (Apple Silicon) | Frame-Control-mac-arm64.dmg | Nothing extra | | **Windows** 10 / 11 (x64) | Frame-Control-Setup-x64.exe · portable .zip | Nothing extra | | **Linux** (x64) | AppImage · .deb | `ssh` (most desktops have it) | | **Linux** (arm64) | AppImage · .deb | `ssh`, and `adb` for Android apps (`sudo apt install adb`) | **iPhone and iPad:** the same features from your phone, with nothing to install on a computer. Build it from `ios/` in Xcode; see docs/iphone.md. The app brings its own Python and `adb`; SSH is built into macOS and Windows. From 0.4