# waydroid/waydroid

Waydroid uses a container-based approach to boot a full Android system on a regular GNU/Linux system like Ubuntu.

Repository: https://github.com/waydroid/waydroid
Canonical: https://ross.abutalabs.com/products/waydroid
Homepage: https://waydro.id
Language: Python
License: GPL-3.0
License Family: copyleft
Topics: android, linux
Last push: 2026-08-01T20:26:52+00:00

## Health v2 (maintenance only)
Score: 89/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 95, release rhythm 74, longevity 100
- inputs: {"age_days": 1966, "days_push": 32, "days_rel": 97, "gap_med": 45.5, "n_releases_24m": 9}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 12045, forks 524 (observed 2026-08-28T04:10:51.471039+00:00)

## What it is
Waydroid is a container-based tool that boots a full Android system inside Linux namespaces (LXC) on GNU/Linux systems running Wayland. It ships a minimal LineageOS-based Android 13 image and integrates Android apps directly into the Linux desktop with near-native performance.

## Use cases
- run android apps on linux desktop
- play android games on ubuntu
- test android apps without an emulator
- run android apps on a linux phone like postmarketOS
- integrate android apps into my linux application menu
- run android in a container with wayland

## When to choose
- you run a Wayland-based GNU/Linux desktop or mobile OS and want Android apps alongside native apps
- you want near-native performance instead of a slow full emulator
- you need a full Android system with direct hardware access on arm, arm64, x86, or x86_64

## When to avoid
- you are on X11 without Wayland support
- you need Google Play certified services out of the box without extra setup
- you need to run Android on Windows or macOS
- your GPU is unsupported and you cannot accept software rendering fallbacks

## Facets
- artifact type: application
- maturity: active
- function: container-runtime, gui, cli
- domain: operating-systems, mobile-development, cross-platform, developer-tools
- platform: cli
- tags: android-emulation, lxc, wayland, lineageos, app-compatibility, linux, android, desktop

## Member repositories
- waydroid/waydroid (main) score 89

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:10:51.471039+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:14:58.957484+00:00, confidence not recorded.
  - readme: https://github.com/waydroid/waydroid (fetched 2026-08-28T04:10:51.471039+00:00, sha 816a062c1594)
  - homepage: https://waydro.id (fetched 2026-08-29T08:12:35.550667+00:00, sha fd95bafe688c)
  - site_page: https://docs.waydro.id/ (fetched 2026-08-29T08:12:35.560510+00:00, sha 563b37e63bc2)
  - site_page: https://docs.waydro.id/usage/install-on-desktops (fetched 2026-08-29T08:12:35.562582+00:00, sha 20f13370ff3e)
  - site_page: https://docs.waydro.id/faq/get-waydroid-to-work-through-a-vm (fetched 2026-08-29T08:12:35.564421+00:00, sha 1fd0beed5d20)
  - site_page: https://docs.waydro.id (fetched 2026-08-29T08:12:35.566093+00:00, sha 563b37e63bc2)
- Data as of 2026-08-30T08:39:29.467469+00:00.