Nav Logo
Build with Meta
Social Technologies
Meta Horizon
AI
Horizon Worlds
About us
Careers
Research
Products
Virtual reality / Meta Horizon
Developer Blog
Download SDKs
Meta for Work
Programs
Start
Meta Horizon Creator Program
Discover
Why Meta Quest?
What is mixed reality?
Platforms and tools
2D apps for Meta Horizon OS
Devices
Meta Avatars
Success stories
Use cases
Support and legal
Developer policies
Legal
Privacy
Forums
Support
Build with Meta
Social Technologies
Meta Horizon
AI
Horizon Worlds
About us
Careers
Research
Products
Virtual reality / Meta Horizon
Developer Blog
Download SDKs
Meta for Work
Programs
Start
Meta Horizon Creator Program
Discover
Why Meta Quest?
What is mixed reality?
Platforms and tools
2D apps for Meta Horizon OS
Devices
Meta Avatars
Success stories
Use cases
Support and legal
Developer policies
Legal
Privacy
Forums
Support
Build with Meta
Social Technologies
Meta Horizon
AI
Horizon Worlds
About us
Careers
Research
Products
Virtual reality / Meta Horizon
Developer Blog
Download SDKs
Meta for Work
Programs
Start
Meta Horizon Creator Program
Discover
Why Meta Quest?
What is mixed reality?
Platforms and tools
2D apps for Meta Horizon OS
Devices
Meta Avatars
Success stories
Use cases
Support and legal
Developer policies
Legal
Privacy
Forums
Support
English (US)
© 2025 Meta
Develop
Develop
Select your platform
Overview
OpenXR Mobile SDK
Overview
Basic Environment and Project Setup
System and Hardware Requirements
Device Setup
Android Development Software Setup
Android Studio Basics
Android Manifest Settings
Add a Splash Screen
Native Android Mixed Reality Capture
Set Display Refresh Rates
OpenXR Support Overview for Meta Quest Headsets
OpenXR Support for Meta Quest Headsets
Build and Run hello_xr Sample App
Native OpenXR Samples
OpenXR Core Concepts
Core Concepts
Creating Instances and Sessions
Collecting System Information
Input API
Creating Actions, Action Sets, and Suggested Bindings
Creating and Using Swapchains
Synchronizing and Submitting Frames
Mixed Reality Experience and Use Cases
OpenXR Meta Extensions
Passthrough
Overview
Customize Passthrough
Loading Screen
Passthrough over Link
Best Practices
Depth
Overview
Movement
Overview
Body Tracking
Face Tracking
Eye Tracking
Blendshape Visual Reference
Body Joints Visual Reference
API Reference
Scene
Overview
Best Practices
API Reference
Spatial Anchors
Overview
Developer Environment Setup
Features and Lifecycle
API Reference
Sample Apps
Space Sharing
Overview
API Reference
Sample Apps
Colocation Discovery
Overview
API Reference
Sample Apps
Virtual Keyboard
Overview
glTF Requirements
Native Integration
Sample Project
Dynamic Object Tracking
Haptic Feedback
Microgestures
Bicubic Filtering with OpenXR
Composition Layer Filtering
Application SpaceWarp Developer Guide
Enable Hand Tracking
Use Capsense
Use Wide Motion Mode
Use Multimodal
Testing and Troubleshooting
Screenshots and Video Capture
Wired Monitoring with ADB
MSAA Analysis for Meta Quest
Android Debugging and Performance Analysis
SysTrace
Native Debugging
Native Debugging with Android Studio
Native Debugging with ndk-gdb
Developer Tools
Meta Quest Developer Hub
Overview
Getting Started
Set Up Headset with MQDH
Managing Your Headset
Debugging Tools
Create Custom Command
Performance Analyzer and Metrics
Overview
How to Take Perfetto Traces
Layer Visibility Control
Explore File Manager
Add, Remove, and Switch Between Multi-User Accounts
MQDH Downloads
Deploy Build on Headset
Troubleshooting MQDH
Submit and Track Bugs and Feature Requests
Android Tools
Collect VrApi Logs with Logcat
Overview
Logcat Stats Definitions
Configure Android System Properties on Meta Quest
Use ADB with Meta Quest
Performance Tools
RenderDoc Meta Fork
Overview
Taking and Loading a Capture
Performing a Render Stage Trace
Performing a Draw Call Trace
Accessing Vulkan Shader Stats
Recommended Settings
Draw Call Metrics
OVR Metrics Tool
Overview
OVR Metrics Tool Stats Definition Guide
Best Practices - OVR Metrics Tool for Non-Engineers
gpumeminfo
ovrgpuprofiler
Simpleperf
Testing and Automation Tools
Use Meta Quest Scriptable Testing Services to Enable E2E Testing
Using AutoDriver to Record Inputs
Using Oculus Debugger for VS Code
Vulkan Validation Layers
Performance and Optimization Guides
Overview
Operating system
CPU and GPU levels
OpenXR, VRAPI, and LibOVR
OpenGL ES and Vulkan
Compatibility mode
Graphics subsystems
Render Scale
Fixed Foveated Rendering (FFR)
App spacewarp
Compositor
Compositor layers
Graphics architecture
Mobile GPUs and tiled rendering
Mobile GPUs and improved algorithms
Mobile GPUs and impaired algorithms
Boosting CPU and GPU Levels
Accurately Measure an App's Per-Frame GPU Cost
Advanced GPU Pipelines and Loads, Stores, and Passes
Art Direction for All-in-One VR Performance
Basic Optimization Workflow for Meta Quest Apps
Using RenderDoc Meta Fork to Optimize Your App - Part 1
Using RenderDoc Meta Fork to Optimize Your App - Part 2
PC SDK
Overview
PC SDK Getting Started Guide
Getting Started with the SDK
Oculus Rift SDK Setup
Getting Started with the Demos
Launching Third-Party Applications
PC SDK Developer Guide
LibOVR Integration
Initialization and Sensor Enumeration
Rendering to the Oculus Rift
Advanced Rendering Configuration
Oculus Dash
VR Focus Management
Guardian System
Touch Plus Controllers
Rift Audio
Rift Touch Controllers
Controllers Overview
Controller Data
Controller Tracking
Button State
Button Touch State
Haptic Feedback
Oculus Avatars
Overview
Native C/C++ Mirror Sample Guide
Avatar SDK C/C++ Developer Reference
SDK Samples and Gamepad Usage
Oculus Debug Tool
Optimizing Your Application
VR Performance Optimization Guide
Overview
Guidelines for VR Performance Optimization
Workflows: The process flows you should follow
Performance Optimization Tools
Tutorial: Optimizing a Sample Application
Additional Resources
Lost Frame Capture Tool
SDK Performance Statistics
Performance Profiler
Performance Head-Up Display
Performance Indicator
Compositor Mirror
Pairing the Oculus Touch Controllers
Asynchronous SpaceWarp
Mixed Reality Capture
OpenXR Support for PC Development
Reference Content
Developer Reference
Troubleshooting
Platform Solutions
Overview
Get Started
Multiplayer Enablement
Getting Started Guide
Server-to-Server API Basics
Request and Messages
Set Up for Platform Development
Multiplayer Features
Multiplayer Overview
Multiplayer Enablement
Travel Features
Travel Overview
Destinations
Group Presence
Invite to App
Testing and Use Cases
Invite Link
Quick Invites
App to App Travel
Roster
Rejoin
Invokable Error Dialogs
SharedSpaces Multiplayer Showcase
Test Cases
User Engagement
User Engagement Overview
User Notifications
Overview
Create User Notifications
Event-Based Notifications
Analytics
Developer Posts
Leaderboards
Leaderboard Client APIs
Leaderboard Server APIs
Events
Achievements
Challenges
Challenges Client APIs
Challenges Server APIs
Share Content from Meta Apps
Monetization
Monetization Overview
Add-ons - Downloadable Content and In-App Purchases
Add-ons Integration
Add-ons Server APIs
Testing Add-ons
Subscriptions
Server APIs for Subscriptions
Social Features
Social Features Overview
Blocking
Parties and Party Chat
Parties and Party Chat
Mic Switcher
User Info, Friends and Relationships
Overview
Verify the User
Enable Friend Requests (Mobile)
Managed Accounts
Managed Account API Overview
User Management
User Management Overview
Entitlement Check
Account Linking
Language Packs
Security
Security Overview
Attestation API
Get Age Category API
Accessibility
Lying Down Mode
Quest Tools
Quest Tools
Asset Files to Manage Download Size
App Deep Linking
System Deep Linking
Cloud Storage
Cloud Backup
Save Game Best Practices
Cross-Device Development with App Groupings
Webhooks
Sample Apps
Platform Reference
Platform Release Notes Archive
Deprecated Features
Matchmaking (Deprecated)
Introduction to Matchmaking (Deprecated)
Matchmaking API (Deprecated)
Implement Matchmaking (Deprecated)
Refine Matchmaking (Deprecated)
Test and Tune Matches (Deprecated)
Peer-to-Peer Networking (Deprecated)
Rooms (Deprecated)
Rooms Client APIs (Deprecated)
Server APIs for Moderated Rooms (Deprecated)
Voice Chat (VoIP) (Deprecated)
Meta XR Simulator
Introduction
Getting Started
Interaction Simulation
Simulate User Input from Keyboard, Mouse, and Xbox Game Controllers
Simulate User Input from Meta Quest Controllers
Simulate a Mixed Reality Environment
Test Rooms
Overview
Built-in Rooms
Build your room in the Synthetic Environment Builder
Build your room in JSON
Overview
Exporting rooms from headset
Room JSON Syntax
Record and Replay
Multiplayer Testing
Automated Testing
Body Tracking
Hand Tracking
Logs
Experimental Features
Manage experimental features
Mobile experimental features
Haptics Native SDK
Overview
Get Started
Add Haptics
MediaProjection
Passthrough Camera
Overview
Android Native Camera2 API
Location-aware Apps
Spatial Data Permission
Archive
Overview
VrApi (Deprecated)
VrApi Native Developer Guide (Deprecated)
VrApi Native Development Overview (Deprecated)
VrApi Native Samples (Deprecated)
Reserved User Interactions (Deprecated)
Oculus Avatars (Deprecated)
Overview (Deprecated)
Native Mirror Sample Guide (Deprecated)
Avatar SDK Developer Reference (Deprecated)
VrApi Native Engine Integration (Deprecated)
VrApi Fundamentals (Deprecated)
VrApi Input API (Deprecated)
Enable Focus Awareness (Deprecated)
Keyboard Overlay Integration (Deprecated)
Enable Phase Sync (Deprecated)
Set Color Space (Deprecated)
Guardian System (Deprecated)
Asynchronous TimeWarp (ATW) (Deprecated)
Power Management (Deprecated)
Advanced Rendering (Deprecated)
Multi-View (Deprecated)
Fixed Foveated Rendering (Deprecated)
VrApi Developer Release Guide (Deprecated)
Overview (Deprecated)
Mobile Native SDK Migration Guide (Deprecated)
Oculus VST Spatializer for DAWs Integration Guide (Retired)
Overview (Retired)
Use the Oculus Plugin (Retired)
VST Options and Parameters (Retired)
3D Visualizer (Retired)
DAW-Specific Notes (Retired)
Legal Notifications (Retired)
Oculus AAX Spatializer for DAWs Integration Guide (Retired)
Overview (Retired)
Use the Plugin (Retired)
Track Parameters (Retired)
3D Visualizer (Retired)
Archived Platform Solutions
Matchmaking (Deprecated)
Introduction to Matchmaking (Deprecated)
Matchmaking API (Deprecated)
Implement Matchmaking (Deprecated)
Refine Matchmaking (Deprecated)
Test and Tune Matches (Deprecated)
Peer-to-Peer Networking (Deprecated)
Group Launch (Deprecated)
Rooms (Deprecated)
Rooms Client APIs (Deprecated)
Server APIs for Moderated Rooms (Deprecated)
Voice Chat (VoIP) (Deprecated)
Oculus Audio for Native Apps
Overview
Oculus Spatializer Features
Oculus Spatializer for Wwise
Set Up the Oculus Spatializer for Wwise
How to Use the Oculus Spatializer for Wwise
Integrate the Oculus Spatializer in Your App
Oculus Spatializer for FMOD Integration Guide
Set Up the Oculus Spatializer for FMOD
How to Use the Oculus Spatializer and Ambisonics in FMOD Studio
Oculus Spatial Reverb
Oculus Lipsync Development Guide
Overview
Viseme Reference
Native Development Using Oculus Lipsync
Explore Oculus Lipsync with the Sample Scene for Native
Oculus Lipsync Native Reference
Oculus Audio Profiler
Overview
Setup the Profiler
Profile Spatialized Audio
Oculus Audio Loudness Meter
Overview
Setup the Loudness Meter
Measure Loudness
Audio Developer Reference
Archived Developer Tools
GPU Systrace (Deprecated)
Cloud Saves API (Deprecated)
Cloud Saves Deprecation
Tracked Keyboard (Deprecated)
Physical Keyboard Tracking Integration (Deprecated)
Using Keyboard Tracking Sample (Deprecated)
Code samples
Downloads
Release notes
Supported platforms
Native and OpenXR
OpenXR Mobile SDK
​
Back to Native and OpenXR
Troubleshooting MQDH
This guide covers the most common errors and issues that you may encounter while setting up or using Meta Quest Developer Hub (MQDH).
  • I’ve multiple Meta accounts. Does it matter which one I use to log in MQDH?
    You must use the same Meta account to log in to MQDH as the one you used to log in to the Meta Quest headset.
  • Do I have to use ADB over WiFi to connect the headset to the computer?
    No, it’s optional. ADB over WiFi lets you connect your Meta Quest device to the computer wirelessly, which means it’s not tethered to your computer through a USB cable. It’s a matter of preference whether you like it connected wirelessly or via a USB cable.
  • MQDH doesn’t detect my headset even when it is connected to the computer over a USB-C cable.
    There can be two reasons why MQDH is unable to detect your headset:
    • After you connect your headset to the computer over a USB-C cable, wear your Meta Quest device and look for the prompt to let the computer access the headset over the USB-C cable.
    • You may not have turned on the developer mode from the Meta Horizon mobile app. Follow step 1 and 2 from the Connect headset to Meta Quest Developer Hub section.
  • I am unable to connect the headset to the computer using ADB over WiFi.
    MQDH uses ADB v1.0.41 and requires you to turn on the developer mode from the Meta Horizon mobile app. You may have connected the headset to the computer over USB-C cable, but may not have turned on the developer mode from the Meta Horizon mobile app. Follow steps 1 and 2 from the Connect headset to Meta Quest Developer Hub section.
    Check if you’re connected to any virtual private network (VPN). At times, VPN connectivity may interrupt with ADB connectivity. Disconnect from the VPN, restart MQDH, and enable ADB over WiFi.
  • I can’t view certain app content while casting my device.
    Casting can be restricted for licensed app content.
  • Casting is stuck in the waiting for connection state.
    Make sure there is no notification in your Meta Quest device that requires your action. At times, if there’s an unresponsive app that requires further action, casting may stay suspended.
  • OVR Metrics tool is installed, but it’s stuck in the refreshing state.
    After OVR Metrics is installed, you must restart the device before the tool is available for use.
  • I already have OVR Metrics installed on my Meta Quest device but MQDH is unable to detect it.
    MQDH works with the latest version of tools and SDKs. The reason MQDH is unable to detect the OVR Metrics tool is because you may not have the latest version of the tool available. Install the latest version from MQDH.
  • I’ve one of the Meta Quest tools already installed. However, MQDH doesn’t list the tool under the Installed tab.
    MQDH lists packages under the Installed tab only if you’ve installed it from MQDH. It doesn’t recognize packages downloaded directly from the Downloads page.
  • I’m a Meta Quest for Business developer and MQDH doesn’t seem to work with the headset.
    Currently, MQDH doesn’t support Meta Quest for Business firmware.
Did you find this page helpful?
Thumbs up icon
Thumbs down icon
Nav Logo
Why Meta Quest?
Design
Develop
API reference
Distribute
Blog
Support
Login