Oculus Developer Hub

Oculus Developer Hub (ODH) is a standalone companion development tool that positions Oculus Quest and Oculus Quest 2 headsets in the development workflow. It streamlines app development experience by surfacing a collection of frequently used solutions in different forms and sizes. Some common solutions include:

  • No need for wired connection as you can now connect your headset to the computer over WiFi
  • Disable the proximity sensor and guardian for an uninterrupted testing workflow
  • Capture screenshots and record videos of what you see in the headset for debugging purposes
  • Share your VR experience by casting the headset display to the computer
  • Download the latest Oculus tools and SDKs you need to build apps
  • Check device logs for debugging purposes

Set up

Setting up ODH with the Oculus headset is quick and easy. It’s a cross-platform desktop tool, which runs on the macOS and Windows operating systems. Before you begin the setup process, get your Oculus Quest or Quest 2 headset and a USB-C cable.

Install ODH

  1. Download the macOS or Windows installer.
  2. Install the application.
  3. Open the application and log in using your Oculus credentials, which must be the same as you’ve used for logging in the headset.

Connect headset to ODH

To use ODH features, you must connect an Oculus device to the computer.

  1. Turn on the headset you want to use for the app development.
  2. Open the Oculus app on your phone and go to Settings.
  3. From the list of devices, tap the device you want to connect with ODH, and go to More Settings > Developer Mode.
  4. Slide the Developer Mode toggle.
  5. Connect your headset to the computer using a USB-C cable and wear the headset.
  6. Accept Allow USB Debugging and Always allow from this computer when prompted on the headset.
  7. Open ODH, go to My Device, and check the device status.

    It shows the device ID and status as connected and active.

    ODH Connected Device Status

If you’ve multiple headsets, repeat the steps to connect other headsets.

Enable ADB over WiFi

ODH offers an option to connect the headset wirelessly to the computer using ADB over WiFi.

  1. After you’ve connected the headset to ODH over a USB-C cable, on My Device, under Actions, turn on ADB over Wi-Fi.

    The status under ADB over WiFi changes to enabled.

    ODH ADB Status

  2. Disconnect the USB cable from the headset to continue using your headset wirelessly.

Note: ODH comes bundled with ADB, which means that you don’t need to install ADB version on your own. In case you already have a different ADB version running on your computer, there are chances you may encounter conflict between ADB instances. In such case, use the existing ADB version from your computer by changing the ADB path. Go to Settings and modify the ADB path to let ODH use the ADB instance located on your computer.

Disable proximity sensor and guardian

By default, the proximity sensor is enabled to ensure that the headset goes to sleep when not in use. Guardian creates a virtual boundary to ensure your safety when you’re immersed in the VR experience. During the development phase, it’s safe to disable these features to have an interrupted development experience without wearing the headset and calibrating it to capture screenshots or record videos.

  • On My Device, under Actions, turn off Proximity Sensor and Guardian to keep the headset in the active state.

    Note: Disabling the proximity sensor means your device will not go to sleep and can result in unexpected battery drainage. We highly recommend that you either leave the device charging or enable the proximity sensor when you’vw finished capturing media.

Change Device Name

Give your devices nicknames to make them easier to identify, especially when you have multiple devices connected to ODH.

  1. On My Device, under Actions, click Change.
  2. In the Device Nickname dialog, enter a new nickname for the device that’s currently connected with ODH.
  3. Click Save.

Updates

ODH maintains a regular update cadence to ship new features and important bug fixes. It supports auto-update and you will be prompted to install the new release when it becomes available.

Next Steps

Once you’ve configured ODH and the headset, these topics will help you learn more about ODH features:

  • Media Tools: Learn how to use media tools cast headset display on computer, record videos, and capture screenshots.
  • Custom Commands: Customize commands that are a combination of multiple ADB commands or unique shortcuts for repetitive tasks.
  • Logs and Metrics: Capture real-time performance graph and information.
  • Package Manager: One-stop-shop to download all the necessary Oculus SDKs and tools.
  • Deploy Apps to Device: Drag and drop .APK file from computer to ODH to install it on your headset.