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.

Game audio in MoltenVR is handled by routing the Wine game’s audio output through a virtual audio device, capturing it, and embedding it in the video stream sent to your headset. Two Homebrew packages are required to make this work.
If BlackHole 2ch is not installed, MoltenVR has no virtual audio device to route game sound through. You will see your game running in VR but hear no audio from it. Install both packages below before launching your first game.

​
Install the audio packages

1

Install BlackHole 2ch

BlackHole is a virtual audio loopback driver that MoltenVR uses to capture game audio.
brew install --cask blackhole-2ch
BlackHole 2ch adds a two-channel virtual output device to macOS. Source: github.com/ExistentialAudio/BlackHole
2

Install switchaudio-osx

switchaudio-osx is a command-line utility used alongside BlackHole for audio device switching.
brew install switchaudio-osx
3

Grant Microphone permission

Open MoltenVR and start a stream. The first time game audio is used, macOS will display a permission prompt for Microphone access.
macOS routes captured audio through the Microphone privacy permission, even though the source is a virtual device rather than a physical microphone. When prompted, click Allow. Without this permission, audio capture is blocked by macOS and you will hear nothing in the headset. You can review or re-grant the permission at any time in System Settings → Privacy & Security → Microphone.

​
Troubleshooting

If you hear no audio in the headset after completing setup:
  1. Verify BlackHole 2ch is installed — open System Settings → Sound and check that BlackHole 2ch appears in the Output list.
  2. Check Microphone permission — open System Settings → Privacy & Security → Microphone and confirm MoltenVR is listed and enabled.
  3. Reinstall if necessary — if BlackHole does not appear in the Sound panel, rerun brew install --cask blackhole-2ch and restart your Mac.

Build docs developers (and LLMs) love

Get started for freeTalk to us