Getting Started - Raemien/MRCPlus GitHub Wiki

Major changes ahead!

MRCPlus is undergoing major improvements to the streaming experience, along with a brand-new OBS plugin optimized for Beat Saber. The mod will remain backwards-compatible with Oculus's official MRC software, though some features such as gamma correction and streaming over USB may not be available. Be sure to upgrade to the modified plugin once it releases!

Introduction

MRCPlus is intended as a recording/streaming tool for Quest content creators. It creates a camera view with increased FOV and smoothing, then streams it to your PC over the network. While setup can be complicated, this guide details all necessary instructions.

Installing software

Quest content creation using the MRC camera system requires a fair amount of preparation.

Before continuing, you'll need to install the following:

MRC Setup

Once you've installed Mixed Reality Capture Tools, you'll need to agree to the Terms and Conditions and select your headset type.

Open the Mixed Reality Capture app on your Quest. Wait a few moments for the PC client to find your Quest, then click "Calibrate Your Camera."

Select "Create new calibration". Note that you do not need a real webcam to complete the setup. Unless you have an actual green-screen setup, you can skip past the calibration step using the right controller's trigger.

Important!

Once you reach the "Calibration Complete" window, you will need to download the OBS plugin. Make sure you click 'Install', else you will not be able to use MRC. If prompted, you may want to downgrade to an older version of OBS to avoid issues.

MRC Setup Window


OBS Setup

To receive live footage from your Quest, you will need to set up OBS Studio.

Click on the + button near the bottom-left corner of your screen to add a new scene. To keep things simple, we'll name it "Quest MRC".

OBS New Scene

Then, add 'Oculus MRC' via the sources panel. If you cannot find this option, you may need to redo the MRC setup.

Add MRC Source

You should now see a blue screen in the preview window.

Connecting to MRC

Good news! MRC is almost ready to use.

Right click on the "Oculus MRC" source and click 'Properties'. This panel is used to control MRC.

OBS Right-click Menu

Before connecting to your Quest, you will need to find your Quest's local IP address. Usually starting with 192.168, it is the same series of numbers used when connecting to BMBF. If you're unsure, run the Quest app and take note of the numbers on-screen.

Once you've found your IP, paste it into the panel. Leave the port at its default value!

MRC Properties

Finally, launch Beat Saber and enable MRCPlus. You may need to restart your game for MRC to fully activate.

Once everything is ready, go back to the OBS properties panel and click "Connect to MRC-enabled game". If you can see your game, everything is almost ready to go! Before you continue, please look at the next section on troubleshooting audio issues.

Help! OBS's audio is stuttering/not working

This is a very common issue with Oculus's MRC plugin.

Recent releases of OBS can run into issues recording MRC sound data, even if it shows up in the audio mixer. While it is unknown what causes this issue, I've included a workaround in this guide.