A container-based approach to boot a full Android system on regular GNU/Linux systems running Wayland based desktop environments.

shape shape
Features

Main Features of Waydroid

Waydroid uses Linux namespaces (user, pid, uts, net, mount, ipc) to run a full Android system in a container and provide Android applications on any GNU/Linux-based platform (arm, arm64, x86, x86_64). The Android system inside the container has direct access to needed hardware through LXC and the binder interface.

Free and Open-Source

The Project is completely free and open-source, currently our repo is hosted on Github.

Full app integration

Waydroid integrated with Linux adding the Android apps to your linux applications folder.

Multi-window mode

Waydroid expands on Android freeform window definition, adding a number of features.

Full UI Mode

For gaming and full screen entertainment, Waydroid can also be run to show the full Android UI.

Near native performance

Get the best performance possible using wayland and AOSP mesa, taking things to the next level

Active community

Find out what all the buzz is about and explore all the possibilities Waydroid could bring

About Us

Get your favourite Android Apps on Linux.

Waydroid brings all the apps you love, right to your desktop, working side by side your Linux applications.
The Android inside the container has direct access to needed hardwares.
The Android runtime environment ships with a minimal customized Android system image based on LineageOS. The used image is currently based on Android 11

Install Instructions
about-image
Docs

Our Documentation

Our documentation site can be found at docs.waydro.id

Bugs & Reports

Bug Reports can be filed on our repo Github Repo

Project Development

Our development repositories are hosted on Github

How to Install ?

Please refer to our installation docs for complete installation guide.

Manual Image Download

You can also manually download our images from

sourceforge logo SourceForge
shape
Instructions

Quick install reference

For systemd distributions

Waydroid supports most common architectures (ARM, ARM64, x86 & x86_64 CPUs)

Waydroid uses Android's mesa integration for passthrough, and that enables support to most ARM/ARM64 SOCs on the mobile side, and Intel/AMD GPUs for the PC side. For Nvidia GPUs (except tegra) and VMs, we recommend using software-rendering

Follow the install instructions for your linux distribution. You can find a list in our docs.

After installing you should start the waydroid-container service, if it was not started automatically:

sudo systemctl enable --now waydroid-container

Then launch Waydroid from the applications menu and follow the first-launch wizard.

If prompted, use the following links for System OTA and Vendor OTA:

https://ota.waydro.id/system

https://ota.waydro.id/vendor

For further instructions, please visit the docs site here

Waydroid-Linux Beta

Waydroid-Linux

Latest Beta  01.30.2023

We have started creating a few fully-integrated distros in order to demonstrate some of the possibilities that Waydroid can help achieve.
Each of the distros we produce will also showcase some of the work from our growing community of contributors.
Our initial alpha releases of this integration started with Ubuntu 20.04 (focal) and is now on Ubuntu 22.04 (jammy) as well as Debian 12 (bookworm), and includes many added tools and scripts to help open up what is possible.

Waydroid-Linux currently only supports x86_64 CPUs (Intel/AMD)

Waydroid-Linux uses Android's mesa integration for passthrough, and that restricts support to Intel and AMD GPUs
For Nvidia GPUs and VMs, we recommend using software-rendering

We have been working with a number of devs on Waydroid-Linux, and have been creating or contributing to a number of projects for it.
Here are just a few of the projects we've been using:

  1. Waydroid-Linux Tools
    A few scripts, configs, and themes for the Waydroid-Linux builds
  2. Waydroid-Settings
    A GTK app written in Python to control Waydroid settings and expand with scripts (shell/py)
  3. Penguins-Eggs
    A tool used for packaging and installation of various Linux distros
Live Mode Info
Due to how Waydroid uses LXC and kernel modules for the binder, it will not work while running in live mode and must be installed before working properly. 
Make sure to check the readme for the .iso, as it contains the specifics needed for each build. 

Our Team

Meet The Team

Here are the members of our team

team
shape shape
Erfan Abdi
@erfanoabdi
Lead Developer
team
shape shape
Alessandro Astone
@aleasto
Developer
team
shape shape
Jon West
@electrikjesus
Developer
team
shape shape
Radek Błędowski
@RKBDI
Designer