# Setting up Waydroid only Sessions

This document will review changes required for setting up wayland sessions for a full-screen Waydroid experience.

## Setting Up

In order to set this up, you will need to create a few files, depending on your default wayland session manager.

Please create the files detailed by their contents using the contents below

### Cage

`/usr/share/wayland-sessions/waydroid.desktop` contents:

```
[Desktop Entry]
Name=WayDroid
Comment=Android OS in a container
Exec=/usr/bin/cage waydroid show-full-ui
Type=Application
```

### Mutter

`/usr/bin/mutter-session.sh` contents (make sure to mark the file as executable):

```
#!/bin/sh
mutter --wayland &
sleep 5
export DISPLAY=:1
waydroid show-full-ui
```

`/usr/share/wayland-sessions/mutter.desktop` contents:

```
[Desktop Entry]
Name=WayDroid on Mutter
Comment=Android OS in a container
Exec=/usr/bin/mutter-session.sh
Type=Application
```

### Weston

`~/.config/weston.ini` contents:

```
[libinput]
enable-tap=true

[shell]
panel-position=none
```

`/usr/bin/waydroid-session.sh` contents:

```
#!/bin/sh
weston &
sleep 3
konsole -e waydroid show-full-ui
```

`/usr/share/wayland-sessions/waydroid.desktop` contents:

```
[Desktop Entry]
Name=WayDroid on Weston
Comment=Android OS in a container
Exec=/usr/bin/waydroid-session.sh
Type=Application
```

### Wayfire

`/usr/bin/wayfire-session.sh` contents:

```
#!/bin/sh
wayfire &
export DISPLAY=:1
sleep 5
waydroid show-full-ui
```

`/usr/share/wayland-sessions/wayfire.desktop` contents:

```
[Desktop Entry] 
Name=waydroid on Wayfire 
Comment=Android OS in a container 
Exec=/usr/bin/wayfire-session.sh
Type=Application
```


---

# 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/faq/setting-up-waydroid-only-sessions.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.
