Waydroid Installation and Usage Guide for X11

Table of Contents

1. Introduction
2. System Requirements
3. Installation
   • Installing Weston
   • Installing Waydroid
   • Initializing Waydroid
4. Usage
   • Launching Waydroid
   • Stopping Waydroid
5. Additional Configuration
   • Hiding Waydroid Apps
   • Clipboard Integration
6. Automation
   • Startup Scripts
7. Uninstallation
8. Troubleshooting
9. References

---

Introduction

This comprehensive guide walks you through setting up and optimizing Waydroid on an X11-based Linux system. Waydroid offers a seamless Android container experience, tightly integrated into your Linux desktop. We cover everything from installation to advanced configuration to ensure a smooth experience.

---

System Requirements

Ensure your system meets these prerequisites:

• Running an X11 desktop environment.
• Administrative privileges (sudo).
• Essential packages: curl and ca-certificates.

Install the prerequisites:

sudo apt install curl ca-certificates -y

---

Installation

Installing Weston

Install Weston, the required Wayland compositor:

sudo apt install weston -y

Installing Waydroid

Step 1: Add the Waydroid Repository

Add the repository:

curl https://repo.waydro.id | sudo bash

Step 2: Install Waydroid

Install Waydroid:

sudo apt install waydroid -y

---

Initializing Waydroid

Follow these steps within a Weston session:

1. Start Weston:

   weston --socket=mysocket

2. Initialize Waydroid:

   • Without Google Apps:

     sudo waydroid init

   • With Google Apps:

     sudo waydroid init -f -s GAPPS

Troubleshooting Binder Module Errors

For issues like:

[21:15:53] Failed to load binder driver
[21:15:53] ERROR: Binder node "binder" for waydroid not found

Follow this guide.

---

Usage

Launching Waydroid

1. Start Weston:

   weston --socket=mysocket

2. Launch Waydroid:

   waydroid show-full-ui

Stopping Waydroid

Stop Waydroid gracefully:

waydroid session stop

---

Additional Configuration

Hiding Waydroid Apps

Run this script to hide Waydroid apps from the system launcher:

for app in ~/.local/share/applications/waydroid.*.desktop; do
    grep -q NoDisplay $app || sed '/^Icon=/a NoDisplay=true' -i $app
done

Clipboard Integration

Enable clipboard sharing:

1. Install pyclip:

   sudo pip install pyclip

2. Install wl-clipboard:

   sudo apt install wl-clipboard

---

Automation

Startup Scripts

1. Configure Weston

Create ~/.config/weston.ini:

[libinput]
enable-tap=true

[shell]
panel-position=none

2. Create a Startup Script

Save this script as /usr/bin/waydroid-session.sh:

#!/bin/bash

weston --xwayland &
WESTON_PID=$!
export WAYLAND_DISPLAY=wayland-1
sleep 2

waydroid show-full-ui &
WAYDROID_PID=$!

trap "waydroid session stop; kill $WESTON_PID; kill $WAYDROID_PID" EXIT

wait $WESTON_PID

Make it executable:

chmod +x /usr/bin/waydroid-session.sh

3. Add a Desktop Entry

Create /usr/share/applications/waydroid-session.desktop:

[Desktop Entry]
Version=1.0
Type=Application
Name=Waydroid Session
Comment=Start Waydroid in a Weston session
Exec=/usr/bin/waydroid-session.sh
Icon=waydroid
Terminal=false
Categories=System;Emulator;

Make it executable:

chmod +x /usr/share/applications/waydroid-session.desktop

---

Uninstallation

Full Removal

Run the clean-removal.sh script:

1. Make it executable:

   chmod +x clean-removal.sh

2. Execute:

   sudo ./clean-removal.sh

---

Troubleshooting

• Weston startup issues: Verify Weston and X11 configurations.
• Waydroid launch failures: Ensure a running Weston session.
• Performance problems: Allocate more system resources.

---

References

• Waydroid Documentation
• Weston Documentation

---