Oculus Quest Development

All Oculus Quest developers MUST PASS the concept review prior to gaining publishing access to the Quest Store and additional resources. Submit a concept document for review as early in your Quest application development cycle as possible. For additional information and context, please see Submitting Your App to the Oculus Quest Store.

Composite the Scene using OBS

This page describes the process of configuring OBS Studio using the Oculus plugin provided in the tools download to compose the scene.

Composition Setup

Before you start compositing your mixed reality scene, make sure you’ve completed the Camera Calibration process. The process described below may require additional configuration or customization based on your camera and computer. The OBS Wiki describes how to use the software in detail.

  1. Launch Open Broadcaster Software (OBS).
  2. At the top of OBS, click on Scene Collection menu and choose Import. Navigate to where you saved the JSON file generated during Camera Calibration, select it, and click Open. Go back to the Scene Collection menu and select Quest MRC from the dropdown.

You only need to do this once.

Begin Capture

Start the application in your Oculus Quest that you want to capture in mixed reality.

  1. Look near the bottom of OBS and you will see a pane called Sources. The Scene Collection you just imported should be there. Double-click on Video Capture Device and then select Ok. This start your camera in OBS.
  2. Double-click either of the Oculus MRC sources. In the properties window that opens, note the IP Address that you recorded in the Camera Calibration process. Click Connect to MRC-enabled game running on Quest, then select OK. You should see the capture streaming from your Quest.
  3. Record or stream your mixed reality experience.
  4. When finished, Disconnect in the Oculus MRC sources.

How to Look Great

You may need to adjust a few settings to make sure the video from the Quest and your camera are well synced.

If your Quest footage seems slower than the video, you’ll need to add a Render Delay. Right-click on the Video Capture Device in Sources, and select Filters. Click on Render Delay in the left side of the pop up, and add between 25-100ms of delay.

Troubleshooting

  • If you’re unable to connect your Oculus Quest to OBS. Verify that your PC and HMD are on the same network. Try restarting your Oculus Quest.

  • If you didn’t get a smooth video source in the OBS plugin, but the performance of the game looked fine under headset, that usually indicated the computer performance was the bottleneck. Please check Device and System Configuration for detailed information.
  • The mixed reality capture quality and latency is heavily depend on the quality of the wireless network connection. If you are seeing unstable performance or heavy video latency, please use a dedicated wireless router with 5G bands.