This fork of AngelDark92/GalaxyXR-Driver adds manual render resolution and preserves non-square recommendations above 4096 pixels. Download this fork’s Windows package.
In Driver Settings → Headset, enable Override Render Resolution and enter the width and height per eye. The defaults and reset buttons use 3552 × 3840; existing custom dimensions are preserved. Restart SteamVR after changes and use Custom 100% to compare the base size. SteamVR Auto, global and per-game scaling still apply. Refresh rate and stream encoding size are independent. Explicit advanced VRLink overrides retain priority for their respective axes.
Use your Samsung Galaxy XR as a proper SteamVR headset over Steam Link: correct headset identity, working controllers, native panel resolution, and image processing before the stream is encoded.
It is a fork of CustomHeadsetOpenVR by sboys3 and installs as its own vendor driver (GalaxyXRNative), so it can live next to the original and be switched with one click.
This driver has to work in tandem with the latest patched Steam Link releases for 2.0.20 and 2.0.23 — patch set 2.0.0 for both at the time of writing. Install the patched Steam Link on the headset first:
→ steamlink-androidxr-patched releases
- Use the newest patch set available for your Steam Link version, with the newest driver release.
- The driver gives the headset its native identity, panel resolution and controller tracking, and owns the vrlink stream settings these builds expect. Without it, the stream falls back to generic vrlink defaults.
Headset
- Native Galaxy XR identity in SteamVR: model name, manufacturer, icons — no more generic vrlink HMD or Quest Pro.
- Manual render resolution: independently editable width and height per eye, defaulting to the panel’s 3552 × 3840. Values such as 5376 × 4973 remain rectangular rather than being clamped to a square.
- Stream quality controls for the vrlink encoder: tile width and bandwidth, with per-codec defaults.
Controllers
- Galaxy XR controller models, input profile and compositor bindings. Games without a native binding see Index controllers.
- Corrected grip origin and pose components, so held objects sit where the game expects them.
- Kalman pose filter that fixes throw velocity and improves tracking through dropouts in the streamed pose.
Image processing
- Saturation, vibrance, contrast, gamma, color matrix and brightness.
- CAS sharpening, FXAA, dither and stationary dimming.
- Distortion correction. The Galaxy XR owns its own lens correction, so this driver pre-warps the image before handing it off instead of replacing the profile. Corrections come from camera-measured per-eye displacement maps or by-eye radial curves, with profile export and import.
- Blackout for leaving the headset connected without burn-in.
Everything is configured in Galaxy XR Companion (Driver Settings, Image Settings, Distortion Profile, App Settings). Identity, input profile, resolution and quality changes need a SteamVR restart.
- Uninstall the existing Steam Link app on the headset, then install the patched build. Patched builds are signed with the patch tool's key, so they cannot update over a store install.
- Download the latest driver release from the releases page.
- Extract the whole folder from the zip. The
GalaxyXRDriverGUIandGalaxyXRNativefolders must stay next to each other. - Run
Galaxy XR Companion.exeinGalaxyXRDriverGUIand open Setup. - Press Install Driver. If the stock CustomHeadsetOpenVR driver is also enabled, the Companion shows a notice and a Switch to the Galaxy XR driver button on any tab — press it.
- Optional: before installing, use Setup → Advanced → Driver install location to choose a custom folder. The default remains
%LOCALAPPDATA%\GalaxyXR\Drivers. Use a local fixed drive; network, removable, cloud-synced, temporary and reparse-point folders are not supported. The saved choice applies only to the next install or reinstall; changing it does not move the current installation. - On Setup, choose Start SteamVR and connect the headset through Steam Link. Wait for Driver initialization verified in SteamVR, then check the picture and controller tracking in the headset. Installed files and a successful launch request alone do not count as runtime verification.
Older copies of this fork that were installed into SteamVR\drivers\CustomHeadsetOpenVR are removed automatically on the first install, and their settings and distortion profiles are copied into the new settings folder. Restore defaults and Uninstall driver also live on Setup; both need SteamVR closed.
In Driver Settings and Image Settings:
- Headset: Galaxy XR Recognition on, Native Panel Resolution on (default), Stream Quality: Tile Width 1536, Bandwidth 350 Mbit/s (defaults).
- Controllers: Disable All Controller Features off (default). Official Controller Layout on. Controller Motion Filter: Kalman CA (recommended). Leave the offsets alone unless the controllers visibly sit wrong in your hand; the shipped values were measured against the official models. The master switch turns off identity, pose corrections, the motion filter, Game Link Layout and everything else the driver does to the controllers; saved per-feature values return when it is off, and a SteamVR restart is required.
- Picture mode: SDR 10-bit baseline sends a 10-bit SDR stream (on by default; a saved Off stays Off; HEVC/AV1 only - selecting H.264 turns it off and keeps the switch disabled, and the driver suppresses the baseline request). It is independent of Image Enhancements (on by default): enable either in any order, no warning, and picture adjustments are not reset.
Then restart SteamVR once.
Same as installing: extract the new zip, run the Companion and press Install Driver (or Reinstall driver) on Setup. Your saved settings are kept.
The Companion checks this repository's latest stable release and tells you when a newer one exists; if the check fails, About shows the error and Check for updates retries it. Enable Developer Builds under App Settings → Updates to also see newer pre-release builds: a stable release is only offered the next dev line (for example, 1.14.0 is offered 1.15.0-dev.*), never an older dev build that shipped before it.
The Companion bundles the actively maintained djules75/OFXR-Bridge payload (v0.2.14.2, V557). You can also download any fork or newer build, unzip it, and use Image Settings → Optical Flow → Install from folder… in the Companion. The build must contain XR_APILAYER_XRFrameBridge_diagnostic.dll and its own ofxr_bridge.ini; the whole ofxr payload folder is copied, so fork-specific helper DLLs survive. There is deliberately no version-compatibility check: a build newer than this Companion is accepted.
The Companion owns only the settings every fork shares: backend and NVIDIA preset, NVIDIA bidirectional flow, flight-recorder on/size/flush, and overlay position. NVIDIA OFA resolution, Hybrid, 3X frame generation, frame-generation mode, Vulkan/D3D11 bridges and any other build-specific option stay in the downloaded build's own tray/INI and are preserved by the Companion's merge. If a fork's own tray is armed, disarm it there before letting the Companion arm its imported copy; the Companion never silently takes over another manager's registration. Imported builds are retained when the driver is uninstalled; Uninstall Optical Flow removes the Companion's copies only.
Open an issue here and attach Steam\logs\vrserver.txt if applicable. Please do not report problems with this fork on the original CustomHeadsetOpenVR repository.
The full setup, feature and troubleshooting notes live in the setup and image processing guide.
- Setup and image processing guide: install, recommended configuration, feature notes, distortion correction by eye, troubleshooting from
vrserver.txt. - OFXR Bridge builds: installing a downloaded fork, shared vs build-specific settings, and the verified layer contract.
- Camera-based distortion tuning: measuring lens correction with a fisheye camera, the sweep and overlay tools, mirroring one eye onto the other.
- Portable build cleanup: local builds and reclaiming generated files.
- Release workflow: how releases are built and published.
Manual configuration
Settings live in %APPDATA%\GalaxyXR\CustomHeadset\settings.json and are hot-reloaded by the driver. Distortion profiles go in a Distortion subfolder and are referenced by name. The Companion's own preferences, including the window's uiScale (30–150 percent, default 100), live beside them in gui-settings.json.
Calibration and tuning tools
tools/ holds the camera calibration and distortion tuning scripts (gxr_sweep.py, gxr_overlay.py, gxr_mirror.py, and the ChArUco / chessboard camera calibration). Python 3.9+, then pip install -r tools/requirements.txt. See the tuner guide.
Building or applying a source update
The source directories are GalaxyXRDriverGUI and GalaxyXRDriver, with GalaxyXRDriver.sln. Do not merge renamed folders blindly into an old layout; extract a source update separately and use tools/Apply-SourceUpdate.cjs. Existing AppData paths and the GalaxyXRNative OpenVR identifier are intentionally retained.
Other headsets
The image processing features should work on other direct-mode streamed headsets, but are untested.
Galaxy XR icons were made by Vilkka. Based on the original Quest Pro iconpack made by Lux / Hekky.
Built on CustomHeadsetOpenVR by sboys3, with modifications by timkhronos and compdoge (CustomHeadsetOpenVR). The camera calibration scripts in tools/ started from sboys3's calibration code (see tools/LICENSE-sboys3-camera-calibration).
The Optical Flow feature uses the independent OFXR-Bridge project (LGPL-3.0-or-later), originally by tig3rmast3r. The bundled payload is the actively maintained fork by djules75 (djules75/OFXR-Bridge, v0.2.14.2 / V557). elliotttate maintains the experimental native-DLSS frame-generation branch (native-dlss-fg).
Other public forks are credited here as a snapshot of the project's network; forks are experimental and are not endorsed or verified by this driver:
- joschi127/OFXR-Bridge
- funchat72/OFXR-Bridge
- srounce/OFXR-Bridge
- cdhiggs/OFXR-Bridge
- satyaloka93/OFXR-Bridge
- lerapeurdu62280-debug/OFXR-Bridge
- kireig/OFXR-Bridge
- hatrd/OFXR-Bridge
- XiaoMeow-1145/OFXR-Bridge
- Omni-NexusAI/OFXR-Bridge
- danny1marshall1587-maker/OFXR-Bridge
- feanor91/OFXR-Bridge
- StormRU/OFXR-Bridge
- Nikoyevitch/OFXR-Bridge
- gramster/OFXR-Bridge
See the OFXR-Bridge network for the current fork list.
GPLv2, same as the original project.
The bundled OFXR Bridge payload is a separate LGPL-3.0-or-later component and is shipped unmodified. Its source, tag, commit and license texts are recorded in GalaxyXRDriverGUI/ofxr/NOTICE, GalaxyXRDriverGUI/ofxr/payload.json and GalaxyXRDriverGUI/ofxr/LICENSE.