Tested 2026-11-21: Steam Frame, SteamOS 0.5.10 beta, SteamVR 2.19.4, Freesm Launcher 2.3.2 (Flatpak from Discover), Minecraft 26.3, Fabric Loader 0.20.1, Visor 0.6.1.
I'll keep the Steam Community version up to date: https://steamcommunity.com/app/4165890/discussions/0/568177767008467186/
1. Switch to the SteamOS beta
Steam Settings → System → System Update Channel → Beta. The headset checks for updates; press Apply.
SteamVR 2.19 is the first version that lets a Flatpak app connect to SteamVR. On stable (SteamOS 0.4.5 / SteamVR 2.18.2), VR fails no matter what you set.
2. Set up the instance
- In Desktop Mode, install Flatseal from Discover. Freesm Launcher isn't on Flathub: add its official source to Discover by following FreesmTeam/flatpak (open the
.flatpakrepo link there), then install Freesm Launcher from Discover. - Create a Minecraft 26.3 instance with Fabric.
- Add Visor and Visor Essentials (0.6.0 or newer, which added ARM64 Linux) and Fabric API.
My full mod list: Visor 0.6.1, Visor Essentials 0.6.1, Fabric API 0.166.2, Sodium 0.9.3-beta.5, Controlify 3.5.3, YetAnotherConfigLib 3.9.7.
3. Flatseal → Freesm Launcher
Device: turn on Shared memory.
Filesystem → Other files: add these two:
/opt/steamvr:ro
xdg-config/openvr:ro
Environment → Variables: add these two:
XR_RUNTIME_JSON=/opt/steamvr/steamxr_linuxarm64.json
SDL_VIDEO_FORCE_EGL=1
Close Freesm completely after changing anything in Flatseal.
4. In Minecraft
Options → Video Settings → set the graphics API to OpenGL, then restart the game. Visor only renders VR with OpenGL.
5. Launch from Steam
In Desktop Mode, right-click Freesm Launcher in the app menu → Add to Steam. In Game Mode, start it from your library, launch the instance and enable VR in Visor.
6. Refresh rate
SteamVR starts the game at 72 Hz. To change it: in the dashboard, Minecraft shows up as an app; open it → VR settings, where you can set refresh rate, resolution and more. I use 45 Hz reprojected to 90 Hz, because the game couldn't hold higher frame rates on the Frame for me.
What each setting fixes
- Shared memory: SteamVR shares its data through
/dev/shm, and Flatpak's "all devices" permission doesn't include it. Without it: VRInitError_Init_Internal. - /opt/steamvr + XR_RUNTIME_JSON: lets the OpenXR loader find SteamVR. Without them:
ERROR_RUNTIME_UNAVAILABLE. - xdg-config/openvr: SteamVR's client reads its paths and settings from
~/.config/openvr. - SDL_VIDEO_FORCE_EGL=1: launched from Steam, the game runs on X11 and uses GLX by default, which made the left eye flicker. EGL fixes it.
- Don't set SDL_VIDEO_DRIVER=wayland: Game Mode doesn't offer Wayland to apps, so the game crashes with "wayland not available".
If it breaks
SteamVR's log for the game is ~/.local/share/Steam/logs/xrclient_java.txt. The sandbox can only write it if you also add ~/.local/share/Steam/logs (read-write) in Flatseal → Other files.