Configure Android system properties on Meta Quest

Updated: Jan 7, 2025

Android system properties can be used to adjust various configuration options on Meta Quest headsets. Configuration changes can be made while an app is running, which makes system properties useful for debugging and testing potential changes. Other system properties provide more options when capturing video. Changes to system properties do not persist over reboots.

Get and Set Android System Properties on Meta Quest

The following sections describe how to get and set Android system properties on Meta Quest.

Preparation

To access Android system properties, the Meta Quest must be connected to your computer via Android Debug Bridge (ADB). See the ADB topic to learn about using ADB with Meta Quest headsets.

Set an Android System Property Value

To access Android system properties, launch an OS shell and establish an ADB connection with the Meta Quest headset via USB or Wi-Fi. To set the value of a system property, the command format is as follows:

adb shell setprop <name> <value>

In this command, <name> represents an Android system property and <value> is what it should be set to. For example, to change the GPU level to 4, the command would be as follows:

adb shell setprop debug.oculus.gpuLevel 4

Get an Android System Property Value

To see the values of Android system properties that have previously been configured with setprop, use the getprop command. For example, to retrieve the GPU level, the command would be:

adb shell getprop debug.oculus.gpuLevel

If debug.oculus.gpuLevel had previously been set, its value will be returned.

Android System Properties on Meta Quest

Property	Values	Description
`debug.oculus.refreshRate`	60, 72 (default)	Used to set the refresh rate of the screen. Most apps must render at 72 hz, but changing this setting may be useful during development and testing. See the Refresh Rate topic for more information on this subject.
`debug.oculus.textureWidth`	1216 (default)	Used to override the default texture width.
`debug.oculus.textureHeight`	1344 (default)	Used to override the default texture height.
`debug.oculus.cpuLevel`	Set by app	Used to override an app’s set CPU level. See the Power Management topic for more information on CPU level.
`debug.oculus.gpuLevel`	Set by app	Used to override an app’s set GPU level. See the Power Management topic for more information on GPU level.
`debug.oculus.foveation.dynamic`	0, 1 (default in apps with dynamic FFR)	In apps using dynamic FFR, setting 0 can be used to disable dynamic FFR so that developers can see what their app looks like with the with highest foveation level configured. This can be useful so developers can get a good look at what their app looks like with max foveation, and they can gauge whether their highest level is set too high. See [Fixed Foveated Rendering](/documentation/native/android/mobile-ffr/) for more information.

Video Capture

The properties in this section are related to video capture.

`debug.oculus.fullRateCapture`	0 (default), 1	Used to enable/disable video capture at full refresh rate. By default, video capture is at half refresh rate.
`debug.oculus.enableVideoCapture`	0 (default), 1	Used to start and end video capture.
`debug.oculus.capture.width`	1024 (default)	Sets the width of captured video.
`debug.oculus.capture.height`	1024 (default)	Sets the height of captured video.
`debug.oculus.capture.bitrate`	5000000 (default)	Sets the bitrate of captured video.