mirror of
https://github.com/Toastconcern/FrameStudio.git
synced 2026-10-29 00:02:23 +01:00
ToastconcernandClaude Opus 5.5
fedadd5ae3
CI stamps every Studio build with its commit (FRAME_BUILD) and the release gets latest.json: the commit, Frame Home's identity (a hash of the headset programs in frame/payload) and the files in the release. Frame Studio (studio/updater.h): checks a few seconds after start and every 6 hours (Help > Check for Updates any time). A newer build shows "Update Available" in the top bar; Download and Install fetches this computer's build with the system's curl, unpacks it with tar, and swaps each item in (the old one renamed aside first, so the running copy keeps working and a failure rolls everything back). Restart Now closes through the normal unsaved-changes prompt, then starts the new copy; the next start deletes what was set aside. Local builds never update. New platform calls: systemTool (System32's curl/tar on Windows) and launch. Frame Home (src/switcher.cpp): on the Steam Frame the Environments panel checks a minute after it starts and every 6 hours. When the installed programs' hash isn't the release's, "Update Frame Home" shows beside Restart Frame Home; it downloads FrameHome-installer.zip and runs its install.sh in its own session (which restarts Frame Home and the panel), and the new panel says "Frame Home is updated". Also frame-switcher --check-update / --update from a terminal. frame/payload: frame-switcher rebuilt on the Steam Frame with this. Tested: Studio's full cycle (check, download, unpack, swap, relaunch, cleanup) and its rollback against a local fake release on Windows; the headset's check and update against a fake release on the Frame (old panel and Frame Home replaced, then up to date); Linux compile of Studio; Studio --selftest unchanged (98 passed, same 6 known fails). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Frame Studio and Frame Home documentation
| Guide | What it covers |
|---|---|
| Getting started | What the two programs are, system requirements, downloads, first launch, a 5-minute walkthrough |
| Preparing the Steam Frame | Developer mode, SSH, the headset's address, an SSH key and a frame entry |
| Installing Frame Home | Three ways to install, what goes where, updating, uninstalling, the off switch |
| Using Frame Home | The Environments panel, adding environments, moving around, every setting |
| Environments and .fenv | The .fenv format, converting homes with fenv-tool, per-world settings and tuning |
| Performance | How Frame Home reaches 120 fps, checking it, fixing stutter, Studio's own pacing |
| Frame Studio guide | The Studio window, tools and panels |
| Bundles | Several environments in one .fbundle file |
| Building from source | Building on each system, the CI, the headset side, the repository layout |
| Troubleshooting | Symptoms and fixes, logs, the self-test |