Set up your device
Updated: Nov 20, 2024
This topic provides instructions on setting up your
Meta Quest headset for development, debugging, and testing.
In this topic, you will do the following:
- Pair your headset with the Meta Horizon mobile app
- Install Android Debug Bridge
- Install Link
- Install Meta Quest Developer Hub
To fully set up your device for development and testing, you need the following:
Open the Meta Horizon mobile app.
- Sign in with your Meta developer account credentials through the app.
- Pair your headset with the app.
- Put on your headset and follow the instructions in the headset to finish the setup.
Set your device to “Developer Mode”
- Open the Meta Horizon mobile app.
- Navigate to Menu > Devices and then select your device.
- Go to Headset Settings > Developer Mode and then enable Developer Mode.
- Use a USB-C cable to connect the headset to your computer, and then put on the headset.
- Go to Settings > Advanced > Developer, and then enable Enable custom settings and MTP Notification.
- When asked to allow USB debugging, select Always allow from this computer.
To verify the connection:
Open an existing Unity project.
- Navigate to File > Build Settings.
- In the Platform list, select Android, and then select Switch Platform. If the target platform is already set to Android, skip to the next step.
- In the Run Device list, select the Meta headset. If you don’t see the Meta headset in the list, select Refresh.
- Select Build And Run, specify a name and location for the
.apk
(Android executable) file to output, and select Save to build the app and run it on your headset.
If the app runs successfully on the headset, you have properly connected your device.
After verifying that your device is connected, set up the following tools to assist with connecting, testing, and debugging your device:
Link is a development tool that enables you to stream applications from your development machine to a Meta Quest headset. With Link, you can significantly decrease XR application development time by launching your app on your headset directly from the Scene view of the Unity Editor, without the need to build and deploy the app for an Android platform.
Note: Link is currently only supported on Windows. If you are developing on macOS, or developing without access to a headset, use
Meta XR Simulator.
Enable Android Debug Bridge
Android Debug Bridge (ADB) is a command-line utility that enables you to perform a number of useful actions during XR development, including:
- Installing apps to your headset
- Debugging apps on your headset
- Copying files to your headset
ADB is included with Unity’s Android SDK tools installation and located inside the /Android/SDK/platform-tools/
folder.
To enable ADB:
- Ensure that you have connected the device via USB.
Install the Oculus USB driver.
Windows: Download the
OEM USB driver, extract the
oculus-adb-driver-2.0
ZIP file, go to the
/oculus-go-adb-driver-2.0/usb_driver/
folder, right-click the
android_winusb.inf
file, and select
Install.
macOS: Skip to step 3, as you don’t need any additional USB drivers.
Add the installation directory to your system path.
Windows: If you are using the Android SDK installed with Unity, the installation path should look similar to the following:
C:\Program Files\Unity\Hub\Editor\<version>\Editor\Data\PlaybackEngines\AndroidPlayer\SDK\platform-tools
macOS: If you are using the Android SDK installed with Unity, the installation path should look similar to the following:
/Applications/Unity/Hub/Editor/<version>/PlaybackEngines/AndroidPlayer/SDK/platform-tools
Open the command line on your development machine and run the following command to check the connected device:
You should see output similar to the following:
List of devices attached
1PASH9BB939351 device
For additional documentation on using ADB with Meta Quest devices, including manual app installation, additional commands, and troubleshooting, see
Android Debug Bridge for Meta Quest.
For more detailed information about using ADB, see
Android Debug Bridge in the official Android documentation.
Note: Link is currently only supported on Windows. If you are developing on macOS, or developing without access to a headset, use
Meta XR Simulator.
To set up Link on your development machine:
- Download Link and install the app on your machine.
- Put on your headset.
- Open the Quick Settings window by selecting the clock on the left side of the menu bar.
- Open Settings, select System > Quest Link, and toggle Quest Link on.
- Select Launch Quest Link to start Link on your development machine and on your headset.
Download and install MQDH
Meta Quest Developer Hub (MQDH) is an application for Windows and MacOS that allows developers to manage their devices, debug their apps, and submit their apps to the Store.
- Download and install the Meta Quest Developer Hub application for macOS or Windows.
- Open the application and log in using your Meta Developer credentials.
- In the left navigation pane, choose Device Manager. All the devices you have set up are displayed in the main pane. Each device is shown with its status, which includes the device ID and connection status. The active device shows a green Active designator.
To learn more about Meta Quest device setup and connection, see the following resources: