Waydroid Installation and Usage Guide for X11

Table of Contents

1. Introduction
2. System Requirements
3. Installation
   • Auto
   • Manual
     • 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

Auto Install

You can use the following one-liner to install and set up Waydroid directly.

curl -sSL https://raw.githubusercontent.com/1999AZZAR/use-waydroid-on-x11/master/install.sh | sudo bash

Manual Install

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.

Fixing Play Store Uncertified Device Issue

If you are using the GApps version of Waydroid and see a "Device is not certified by Google" error in the Play Store, here is a potential fix.

1. Enter the Waydroid Shell

   Open a terminal on your computer and run:

   sudo waydroid shell

   You will now be inside the Android container's shell.

2. Get Your GSF Android ID

   Inside the waydroid shell, run this command to get your Google Services Framework ID:

   sqlite3 /data/data/com.google.android.gsf/databases/gservices.db "SELECT * FROM main WHERE name = 'android_id';"

   This will output a long number, which is your android_id. Copy this number.

3. Register Your ID

   Go to the Google Device Registration page: https://www.google.com/android/uncertified/

   Paste the android_id you copied into the input box and click "Register".

4. Verify and Restart

   Go back to the waydroid shell. The user suggests running the following command to verify the ID.

   ANDROID_RUNTIME_ROOT=/apex/com.android.runtime ANDROID_DATA=/data ANDROID_TZDATA_ROOT=/apex/com.android.tzdata ANDROID_I18N_ROOT=/apex/com.android.i18n sqlite3 /data/data/com.google.android.gsf/databases/gservices.db "select * from main where name = "android_id";"

   After this, fully stop and restart Waydroid for the changes to take effect.

   # On your main linux terminal, not the waydroid shell
   waydroid session stop
   # Then restart it using your preferred method

Good luck!

---

References

• Waydroid Documentation
• Weston Documentation

---