Download the DMG · Install · Tested setup · Build from source · Contribute
TrailBridge VR runs Windows VR games under Wine on your Mac and streams them to the headset over a USB cable or Wi‑Fi. A patched DXMT translates Direct3D 11 to Metal, the project's own OpenXR runtime talks to the game, and a native macOS streamer sends the picture to the ALVR client on the headset. The app is free and open source, with no subscriptions, and it is built on BasaltVR.
Warning
TrailBridge VR is experimental. It was tested on one Mac with one headset (see Tested setup); other Macs, headsets and games may not work. The app is not signed by Apple.
- Add Steam Game: creates a Wine environment, installs the official Steam client, waits for Steam's downloads and updates, and adds the game to the Library. When Steam hangs, the app restarts it.
- Add Game from Folder: copies a Windows game from a folder on any disk into its own environment and leaves the folder unchanged.
- OpenVR and OpenXR games: OpenVR games run through OpenComposite, which the app downloads on request; OpenXR games run directly.
- Picture quality: presets from Performance to Maximum with a recommendation for your Mac, HEVC or H.264, per-eye sizes up to 3072 × 3280, and 72, 90 or 120 Hz.
- USB or Wi‑Fi: reconnect the headset without restarting the game; over Wi‑Fi the bitrate follows the network.
- Game audio from the Mac itself (macOS 14.2 or newer) or through BlackHole.
- Guided setup: a Learning guide from a new Mac to the first game, and a Setup page that downloads Wine, the ALVR client and Android platform tools with checksums.
- Clean removal: one button deletes everything the app stored on the Mac.
- 10 languages: English, Russian, Ukrainian, German, Spanish, French, Italian, Polish, Japanese and Korean. English and Russian are reviewed; the others are machine translations.
| Mac | Mac mini M4 with 32 GB of memory, macOS 27 |
| Headset | Meta Quest 3, 512 GB, ALVR client 20.14.1 |
| Connection | USB cable and Wi‑Fi |
| Games | Bought on Steam and installed through the official Steam client, and added from a game folder without Steam |
| Game | Runs through | Notes |
|---|---|---|
| BRUTALISTICK VR | OpenComposite (OpenVR) | |
| Blood Trail | OpenComposite (OpenVR) | Walking direction follows the controller setting; running is not available on controllers. |
| VTOL VR | OpenComposite (OpenVR) | TrailBridge VR switches the game to one render pass per eye; without it the right eye stays black. |
| BONELAB | The game's own OpenXR | |
| Blade & Sorcery | OpenComposite (OpenVR) |
Not tested: Macs with 8 GB or 16 GB of memory, other Mac models and other headsets. TrailBridge VR does not promise stable operation on them. Other games may work but are not verified.
-
Download
TrailBridge-VR-<version>-macos-arm64.dmgfrom Releases. Each release lists the file's SHA-256 and a VirusTotal report (0.2.1: no security vendor flagged it). -
Optionally check the file:
shasum -a 256 ~/Downloads/TrailBridge-VR-*.dmgmust print the published SHA-256. -
Open the DMG and drag TrailBridge VR to Applications.
-
Open the app. It is not signed by Apple, so macOS blocks the first start: open System Settings › Privacy & Security, click Open Anyway next to TrailBridge VR and confirm. This is needed once.
-
If the Mac has no Rosetta 2 yet, run this in Terminal:
softwareupdate --install-rosetta --agree-to-license
-
Follow Learning in the app. Choose the data folder (this Mac, an external disk or network storage) before the app downloads Wine 11.10 (about 190 MB) and your games.
- A Mac with Apple Silicon and macOS 14 or newer, with Rosetta 2. Intel Macs are not supported.
- A Meta Quest headset in developer mode. Only the Quest 3 is tested.
- Your own Steam account and games you bought, or Windows VR games you own in a folder.
- Free space on the disk with the data folder: about 720 MB for Wine, plus Steam and the games.
Known limits: the OpenXR runtime is not conformant; per-eye sizes above 1680 × 1760 need a strong Mac and a light game; Steam under Wine sometimes freezes (use Restart Steam on the Steam page); the headset's microphone is not passed to the Mac.
Windows VR game ──► [OpenComposite] ──► OpenXR runtime ──► DXMT fork (inside Wine)
(D3D11, PE) OpenVR games only (Windows DLL) (D3D11 → Metal)
│ │
control socket │ │ IOSurface per eye
▼ ▼
basalt-streamer: Metal stereo compose ──► VideoToolbox HEVC/H.264
│ (native macOS)
▼
ALVR transport (USB or Wi-Fi) ──► Quest headset
◄── head/controller tracking, buttons, haptics, statistics ──
docs/ARCHITECTURE.md describes the design in detail.
You need Xcode with the Metal toolchain, CMake, LLVM-MinGW, Meson and Ninja.
git clone https://github.com/abgitdev/TrailBridge-VR.git
cd TrailBridge-VR
./scripts/trailbridge-dev.zsh make doctor-dxmt # check the tools
./scripts/trailbridge-dev.zsh runtime/scripts/build-dxmt-fork.zsh
./scripts/trailbridge-dev.zsh make dxmt-test # pinned Wine, runtime and graphics tests
./scripts/trailbridge-dev.zsh make check # repository checks and Swift tests
./scripts/trailbridge-app.zsh # builds .local/apps/TrailBridge VR.app
./scripts/trailbridge-dev.zsh make release # builds the DMG in .local/distRun every development command through scripts/trailbridge-dev.zsh: it keeps caches,
temporary files and the app's data inside .local/ in the checkout. The first DXMT build
compiles LLVM and takes tens of minutes. make help lists all targets.
| Document | Covers |
|---|---|
| Management app | The app's screens and workflow |
| Bottles and launch profiles | basaltctl, environments, OpenComposite and launching games |
| Streamer | basalt-streamer over USB and Wi‑Fi, audio and stream settings |
| OpenXR runtime | What the runtime implements and how it is tested |
| Architecture | System design and BasaltVR's milestone history |
| DXMT interop | The D3D11 → Metal → IOSurface handoff and the DXMT fork |
Bug reports, compatibility reports for games and pull requests are welcome. Read CONTRIBUTING.md and use the issue forms. Setup help: SUPPORT.md. Report security problems privately as described in SECURITY.md. Leave out credentials, device serial numbers and home-folder paths; the app's diagnostic report removes them before you share it.
- BasaltVR: the OpenXR runtime, the DXMT fork, the streamer and the app that TrailBridge VR builds on.
- DXMT by Feifan He: Direct3D 11 on Metal.
- Wine and the macOS Wine builds by Gcenx.
- ALVR: the headset client and its streaming protocol.
- OpenComposite: OpenVR games on OpenXR.
- Khronos OpenXR SDK and LLVM-MinGW.
TrailBridge VR is released under the MIT License, like BasaltVR, whose copyright notice the license keeps. Components that the app contains or downloads keep their own licenses: see THIRD_PARTY_NOTICES.md and LICENSES. TrailBridge VR does not include, download or unlock games, and it never asks for store credentials. It is an independent project, not affiliated with or endorsed by the BasaltVR authors, Apple, Meta, Valve or the game developers; their names are trademarks of their owners.





