Setting up Waydroid only Sessions

For some projects, you might want to have Linux only for backend or maintenance related tasks, while using the Waydroid full-screen UI as the main interface.

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