Debug Your Browser Content

You can use the Chrome Developer Tools to debug and inspect your site in Oculus Browser. You can debug remotely either over USB or Wi-Fi.

Enabling USB Debugging on Oculus Go and Quest

To configure your device for USB debugging:

  1. Open the Oculus companion app on your phone.
  2. Select your Oculus device in Settings.
  3. Tap on More Settings
  4. Tap on Developer Mode
  5. Turn on Developer Mode

Enabling USB Debugging on Samsung Gear VR:

To configure your device for USB debugging:

  1. Open the Settings menu on your device.
  2. Select About device.
  3. Locate Build Number.
  4. Tap Build Number seven times. The developer options notification appears.
  5. Return to the top level of device settings, and then select Developer Options.

Enabling Gear VR Developer Mode

Gear VR Developer mode speeds up your development workflow by letting you run VR applications without inserting your device into the Gear VR headset.

To enable Gear VR Developer mode:

  1. Build an apk signed with your osig file and install it to your device. For more information, see https://dashboard.oculus.com/tools/osig-generator/.
  2. Open the Settings menu on your device.
  3. Select Applications > Application Manager.
  4. Select Gear VR Service.
  5. Select Manage Storage.
  6. Tap VR Service Version several times until the Developer Mode switch appears.
  7. Turn on Developer Mode.

Enabling Wi-Fi Debugging

You may prefer to debug over Wi-Fi. This is required if debugging a Gear VR device while the phone is in the headset.

To set up Wi-Fi debugging:

  1. Complete the Enabling USB Debugging procedure above and then connect your device to your computer with a USB cable.
  2. Install Android Platform Tools.
  3. Open a terminal or Windows command prompt window.
  4. Locate the adb tool if it is not already in your path. On Windows, it is typically located in C:\Users\{user}\AppData\Local\Android\sdk\platform-tools.
  5. In the terminal window, enter adb tcpip 5555
  6. Open the Settings menu on your device.
  7. Select About device > Status and obtain the IP address of your device.
  8. In the terminal window, enter adb connect *x.x.x.x*:5555 where *x.x.x.x *is the IP address.

Starting a Remote Debugging Session with Chrome Developer Tools

After browsing to your web site in Oculus Browser, you can debug it remotely using the Chrome Developer tools.

To start a remote debugging session:

  1. Browse to your site in Oculus Browser.
  2. Launch Google Chrome and then open the developer tools.
  3. From the menu in the upper-right corner of the dev tools, Select More tools > Remote devices to open the Remote devices tab.
  1. Select your device from the list on the left.
  2. Click the Inspect button next to the Oculus Browser tab you wish to debug.

For more information about remote debugging with Chrome Developer Tools, see: Chrome DevTools - Remote Debugging.

For more information about setting up your devices and debugging VR apps, see the following topics.

Device Setup - Gear VR

Device Setup - Oculus Go

Android Debugging