GalaxyFrame 1.0.0

Super Mario Galaxy in VR, running natively on the Valve Steam Frame. GalaxyFrame is a port of bigmak94's GalaxyQuest, built on the Petari decompilation, with its own Vulkan renderer and frame pacing for SteamVR. You need your own disc; no game data is included.

The game on the Frame

• A Linux Arm64 build that runs in the Frame's SteamVR. No Lepton, APK, adb or PC.
• The diorama in front of you, or a giant virtual screen, as in GalaxyQuest.
• Saves, settings and the converted disc in plain folders under your home.
• Sound through SDL2, and a clean exit when Steam stops the game.

Rendering

• A native Vulkan renderer that replays the game's recorded frames.
• Both eyes rendered on every refresh of the 120 Hz display, from the head pose of that refresh, at 0.9 of SteamVR's recommended resolution. Each pair is handed to SteamVR only once the GPU has finished it.
• When the GPU falls behind in a heavy scene, new eyes every second refresh until it is lighter again, then back.
• The shaders compiled to SPIR-V at run time and cached; a warmed cache has every pipeline ready at launch.
• GPU work cut by about a quarter per eye: the drawing state is sent once per run of draws, draws nothing reads are skipped, channel-only copies are blits, the HUD is drawn once per game frame, and the GPU renders directly to memory.
• Area loads with less of a hitch: textures decoded off the game thread, frame memory mapped ahead, and the game's threads at a raised priority.

Controls

• The Steam Frame controllers bound through SteamVR's own profile, with rumble on both controllers.
• Smooth turning of the diorama with the right stick, with a turn speed slider; 45 degree steps behind a blink as the alternative.
• Star Bits shot three times as fast, with a slider from 1x to 5x.

Comfort

• A comfort vignette: a clear circle around where you look, closing in as the view moves, with its strength set for slow and for fast movement.
• The game's in-engine cutscenes in the diorama, following their camera, with a switch per kind on a Cutscenes tab. The videos stay on the flat screen.

The settings panel

• Six tabs: Diorama, Screen, Cutscenes, Controls, Comfort and Display. The switches that do nothing on the Frame are hidden.
• One resolution setting, shown in pixels: 1.00 is what SteamVR's own resolution setting gives the game; 0.90 by default.

Install

• An installer that copies the program, adds the Steam library entry, sets SteamVR's per-app settings (120 Hz, no throttling, no motion smoothing) and sets them again at every launch.
• A script that converts your disc, and one that compiles the galaxies' shaders ahead of play.
• The Vulkan shader cache shipped in the tarball, so the first session does not compile.

Download

• galaxyframe-1.0.0-linux-arm64.tar.gz
• SHA256SUMS

Install

Unpack the tarball on the Frame and run steam-frame/install.sh from the repository with the tarball as its argument. It installs the program, creates the Steam shortcut and keeps your game files, saves and settings on an update. The README has the full steps, the controls and the settings.

Known

• Mario and the world move at the game's 60 frames a second. On the 120 Hz display an object your eye follows can look doubled along its movement. Head movement is not affected.
• Played on one Steam Frame with the US disc.

Reporting problems

Open an issue with what you did, what you expected and what happened, your disc's region, and petari_log.txt and launch.log from ~/.local/share/GalaxyFrame.

GalaxyQuest 0.1.8 for the Steam Frame (frame.2)

Super Mario Galaxy in VR, natively on the Steam Frame. Upstream GalaxyQuest 0.1.8 built for Linux arm64 on the Frame's own SteamVR, with frame pacing reworked for SteamVR, a Steam Frame control layout, and a shader warm-up. See the README for install and controls, and STEAM_FRAME.md for how it works and what was tried.

Since frame.1

• Both eyes complete and in step: eyes rendered from one head pose, kept until the GPU has finished them, three image sets; the right eye no longer stutters.
• SteamVR per-app settings (120 Hz, no throttling, no motion smoothing) set by the installer and re-applied at every launch; the pacing detects a throttled loop.
• Steam Frame controls: A/B are the Wii A/B, X or Y spin, Menu or View pause, D-pad is the Wii D-pad.
• Resolution held at 0.8 by default (steady picture, GPU room for the compositor); render targets kept by size; anisotropic filtering; game threads at raised priority.
• steam-frame/warm-shaders.sh: compiles 20 galaxies' shaders ahead of play, headless (the tarball now carries petari_headless for it).

Status: played at 60 fps on 120 Hz in the diorama; a hitch of about a second when a new area loads (less after the warm-up); SpaceWarp and passthrough not available on the Frame. Report problems with ~/.local/share/GalaxyQuest/petari_log.txt.

Install (on the Frame, Steam running):

git clone -b steam-frame https://github.com/simplysanatori/GalaxyQuest-steam-frame.git
cd GalaxyQuest-steam-frame
steam-frame/install.sh ~/Downloads/GalaxyQuest-steam-frame-v0.1.8-frame.2.tar.gz
steam-frame/prepare-game.sh /path/to/your/SuperMarioGalaxy.rvz

No game data is included; you need your own Super Mario Galaxy disc (US RMGE01 tested).

sha256: 08b08eb36e3273aa72e5e4c30afbf6d51cedb2db5f1b22c30a18c34901d97a5a

GalaxyQuest 0.1.8 for the Steam Frame (frame.1)

First native Linux arm64 build of GalaxyQuest for Valve's Steam Frame, running on the Frame's own SteamVR. Upstream GalaxyQuest 0.1.8 (d8a039c) plus the Linux target, the Steam Frame controller layout and the fixes in STEAM_FRAME.md.

Status: starts through SteamVR to the title screen at 120 Hz (60 game fps, two refreshes per frame), Steam Frame controllers bound, sound through SDL2, clean exit. Gameplay in levels not yet confirmed on hardware; please report what you find with ~/.local/share/GalaxyQuest/petari_log.txt.

Install (on the Frame, Steam running):

git clone -b steam-frame https://github.com/simplysanatori/GalaxyQuest-steam-frame.git
cd GalaxyQuest-steam-frame
steam-frame/install.sh ~/Downloads/GalaxyQuest-steam-frame-v0.1.8-frame.1.tar.gz
steam-frame/prepare-game.sh /path/to/your/SuperMarioGalaxy.rvz

Then launch Super Mario Galaxy VR from the Steam library.

The tarball holds galaxyquest (launcher), libgame.so (the game, stripped) and galaxyquest.sh. No game data is included; you need your own Super Mario Galaxy disc (US RMGE01 tested).

sha256: 0f6e698e3da02abd86b15afe958713e1c49d595367d30f2fafb60f65062eb6f2