# Waydroid Prop Options

Waydroid uses various properties in order to tell the underlying Android system how to behave in a few places. To do this, we use the `waydroid prop set <property> <value>` command. To unset a prop, `waydroid prop set <property> ""`. Most settings require restarting the waydroid session to apply.

### Waydroid behaviour

* **waydroid prop set persist.waydroid.multi\_windows** true/false (bool) Enables/Disables window integration with the desktop
* **waydroid prop set persist.waydroid.height\_padding** 0-9999 (int) Adjust height padding
* **waydroid prop set persist.waydroid.width\_padding** 0-9999 (int) Adjust width padding
* **waydroid prop set persist.waydroid.width** 0-9999 (int) Used for user to override desired resolution
* **waydroid prop set persist.waydroid.height** 0-9999 (int) Used for user to override desired resolution
* **waydroid prop set persist.waydroid.suspend** true/false (bool, default: true on kernel 4.9 and later) Let the Waydroid container sleep (after the display timeout) when no apps are active
* **waydroid prop set persist.waydroid.uevent** true/false (bool, default: false) Allow android direct access to hotplugged devices
* **waydroid prop set persist.waydroid.reverse\_scrolling** true/false (\bool default: false) Invert the direction of scrolling

#### App behaviour

* **waydroid prop set persist.waydroid.fake\_touch** (string, 91 character limit) Comma separated list of package names for which mouse inputs should be interpreted as touch inputs instead. Supports wildcards with `*`. For example, set this to `"com.rovio.*"` to match all games by Rovio.
* **waydroid prop set persist.waydroid.fake\_wifi** (string, 91 character limit) Comma separated list of package names for which the system will always appear as if connected to wifi. Supports wildcards with `*`. For example, set this to `"com.gameloft.*"` to match all games by Gameloft.

### Debug

* **waydroid prop set persist.waydroid.no\_presentation** true/false (bool) Disables the wp\_presentation protocol
* **waydroid prop set persist.waydroid.invert\_colors** true/false (bool) Swaps the color space from RGBA to BGRA
* **waydroid prop set persist.waydroid.cursor\_on\_subsurface** true/false (bool) Draw the cursor on a subsurface, rather than on the cursor surface
* **waydroid prop set persist.waydroid.cursor\_force\_shm** true/false (bool) Always submit wl\_shm buffers for the cursor surface
* **waydroid prop set persist.waydroid.no\_background\_subsurface** true/false (bool) Do not submit a black background subsurface
* **waydroid prop set persist.waydroid.use\_subsurface** true/false (\bool) Submit overlayed subsurfaces rather than letting Android compose the stack


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.waydro.id/usage/waydroid-prop-options.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.