Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/112cxyz/MoltenVR-Preview/llms.txt

Use this file to discover all available pages before exploring further.

Before installing MoltenVR, make sure your Mac, headset, and software environment meet the requirements below. Most setups need nothing beyond the app itself — optional dependencies are only required for USB streaming and in-game audio routing.

Apple Silicon Mac

An M1, M2, M3, or M4 Mac running macOS 14 Sonoma or later. MoltenVR uses Apple’s VideoToolbox hardware encoder and Metal graphics API, both of which require Apple Silicon.

VR Headset

Any headset running the ALVR client v20.14.0. MoltenVR has been tested on Meta Quest 3. Install the ALVR client APK from the official GitHub release before connecting.

Wine Bottle

No separate Wine installation is needed. MoltenVR includes its own managed WhiskyWine/GPTK bottle, set up automatically by the wizard. Existing bottles from Whisky (frankea fork), CrossOver, or Wineskin are also supported.

macOS Permissions

MoltenVR requires Screen Recording permission (for the desktop view feature) and Microphone permission (for game audio routing). macOS will prompt for both on first use.

Optional Dependencies

The packages below are only required if you plan to use USB streaming or in-game audio. Wi-Fi streaming and basic gameplay work without them.
USB Streaming — install android-platform-tools via Homebrew to enable 100 Mbps wired streaming over USB:
brew install android-platform-tools
Game Audio — install BlackHole 2ch (the audio loopback driver) and switchaudio-osx (for automatic audio device switching):
brew install --cask blackhole-2ch && brew install switchaudio-osx

First-Launch Note

MoltenVR is not yet notarized by Apple. On your first launch, macOS will block the app with a security warning. Right-click MoltenVR.app → Open to bypass the check and launch normally. Subsequent launches will open without a prompt.

Build docs developers (and LLMs) love