Waydroid Gapps Image <PC Newest>

Waydroid GApps images redistribute Google’s proprietary software. While Google has not taken action against personal or community use, distributing these images for commercial purposes or in large public repositories may violate Google’s terms of service. Most community projects therefore provide scripts that download the GApps package from Google’s own servers during installation, which is legally safer.

waydroid show-full-ui

Android’s launcher appears as a normal window on your Wayland desktop.

sudo waydroid init -s GAPPS -c https://ota.waydro.id/system -v https://ota.waydro.id/vendor waydroid gapps image

Waydroid is a container-based approach to boot a full Android system on a standard GNU/Linux system. However, by default, Waydroid usually downloads an "Android TV" or "Vanilla" image that lacks the Google Play Store and essential Google Play Services.

To get the Play Store working, you need to flash a specific GApps image. This guide covers everything you need to know about finding, downloading, and installing the correct image. Android’s launcher appears as a normal window on

One of the most trusted names in the Waydroid community is Casper (GitHub: caspervk). Their waydroid_script Python tool allows you to download and inject a working Gapps image for multiple Android versions (11, 12L, 13).

To use it:

git clone https://github.com/casualsnek/waydroid_script
cd waydroid_script
python3 waydroid_script.py -c gapps

Download both the system.img and vendor.img from a trusted community source. For this example, we assume:

Place them in a directory, e.g., ~/waydroid-images/. Download both the system

sudo waydroid session stop
sudo waydroid container stop
sudo rm -rf /var/lib/waydroid /home/.waydroid

| Feature | Vanilla AOSP | GAPPS | |---------|--------------|-------| | Google Play Store | No | Yes | | Play Services APIs | No | Yes | | Cloud Messaging | No | Yes | | Location (network/gps) | Mock only | Google fused location | | Image size | ~500 MB | ~1.2 GB | | RAM usage at idle | ~400 MB | ~700 MB | | Privacy | No Google telemetry | Google services run by default |

If you don’t need Google services, use Vanilla for less overhead.