Meta XR Simulator Overview

Meta XR Simulator is a lightweight XR runtime built for developers that enables the simulation of Meta Quest headsets and features at the API level. It makes day-to-day development easier by letting you test and debug apps without putting on and taking off a headset. It also helps scale automation by simplifying the setup of your testing environment.

To download the latest version or see the release notes, go to

For guidance on the setup and installation of Meta XR Simulator with your development environment, see Get Started with Meta XR Simulator.

This section describes the user interface and functionality of a Meta MR Simulator.

The Device Setup window lets you configure the simulated device, including the model, IPD, and refresh rate. Note that some changes will only take effect after restarting the simulator.

The Graphics Details window lets you inspect the composition layers and swapchains sent from your application.

The Input Simulation window lets you inspect the state of the controllers and the headset, including their poses and button press states. It also shows which device is actively controlled by your keyboard and mouse or Xbox controllers.

The Input Instruction window gives you the information you need to control the simulated headset using a keyboard and mouse or Xbox controller. Some common operations, like grabbing and continuous head rotation, have shortcuts for your convenience.

Record and Replay lets you record a series of actions, save it locally, and play it back at a later time. For more information, refer to Capture a Meta XR Simulator Session.

The Eye Selector controls which eye’s view is displayed. It is useful for making sure that both eyes render correctly.

Note: Click the Collapse button on the bottom left corner to collapse the left-side navigation bar and minimize the UI.

The About window shows your simulator version and status information including FPS, graphics API, and whether it is connected to the Synthetic Environment Server.

The Settings window lets you enable or disable features including hand tracking. You can also load a new scene JSON.