Skip to main content

Configure Meta Quest Headsets

Configure your Meta Quest headset for use with the SIMPLE web platform.

Why Configure IP Addresses?​

The web platform uses headset IP addresses to:

  • Assign colors to each headset
  • Display the correct icons in the simulation control page
  • Draw colored borders around video streams

Therefore, you must set a static IP address for each headset.

Configure Network Settings​

On your headset:

  1. Go to Settings → Wi-Fi → Arrow next to your network → Edit → Advanced
  2. Set the following:
  • IP Assignment: Static
  • IP Address: 192.168.68.x (choose x based on headset color constants)
  • Gateway: 192.168.68.1
  • Network Prefix Length: 24
  • DNS 1: 1.1.1.1
  • DNS 2: 1.0.0.1
  • Private MAC: No
  • Proxy: No
  • Hidden Network: No
info

Headsets with IPs not in the configured list will display a gray border.

Enable Wireless ADB​

Wireless ADB allows the web platform to communicate with the headset over WiFi.

Install Oculus Wireless ADB​

  1. Download the .apk file from Oculus Wireless ADB releases
  2. Connect your headset to your computer via USB
  3. Install the app:
adb install tdg.oculuswirelessADB-1.3.apk
adb shell pm grant tdg.oculuswirelessadb android.permission.WRITE_SECURE_SETTINGS

(Optional) Speed up connections:

adb tcpip 5555

Connect Wirelessly​

  1. Ensure only one headset is connected to your computer:
adb devices
  1. If multiple devices appear, disconnect them:
adb disconnect
  1. On your headset, open Library → Unknown Sources → Oculus Wireless ADB
  2. Enable TCPIP Mode
  3. Toggle Wireless ADB on

Your headset can now connect remotely to the web platform.

tip

Add headset IPs to HEADSETS_IP in your .env file for faster automatic connections. See the .env reference.

Troubleshooting​

Having issues? See the troubleshooting guide for help with common problems.