waydroid prop set persist.waydroid.multi_windows true
Run the script to fix permissions and install missing components (e.g., libhoudini for ARM translation):
For the registration to take effect, clear the local Play Services data and restart the container:
Installing this image transforms your Waydroid container from a generic open-source tablet into a certified Google-experience device. You gain access to: waydroid gapps image
If you already have a Vanilla Waydroid image installed and do not want to wipe your data, you can inject GApps using open-source wrapper scripts like or casualsnek's Waydroid script . Clone the helper repository: git clone https://github.com cd waydroid_script Use code with caution. Install the script dependencies:
: A clean, open-source Android base without any Google software.
A (Google Apps image) is a specific build of the Android container that includes Google’s proprietary applications and services. This includes: Google Play Store: To download apps. waydroid prop set persist
Waydroid requires a Wayland session (e.g., GNOME or KDE Plasma on Wayland). It will not run natively on X11 without a nested compositor like Weston.
This guide covers everything you need to know about finding, installing, and configuring a Waydroid image with GAPPS. What is a Waydroid GAPPS Image?
If you prefer to keep a minimal base image and manually inject OpenGApps or MindTheGApps without redownloading a full system image, you can use automated setup scripts like waydroid-extras . These scripts download the structural OpenGApps zip files and flash them directly into your existing vanilla rootfs structure. However, using the native waydroid init -s GAPPS method remains the most stable, officially supported path. Troubleshooting Common Waydroid GApps Issues Play Store Hangs on "Checking Info..." Install the script dependencies: : A clean, open-source
Then restart the Waydroid session for changes to take effect.
Before installing or switching to a GAPPS image, ensure your Linux system meets these requirements:
You can now launch the Waydroid user interface from your application menu or by running: waydroid show-full-ui Use code with caution. How to Switch from Vanilla to GAPPS
Your Linux kernel must have ashmem and binder modules enabled. Most modern distributions (like Fedora, Arch, and Ubuntu) support this out of the box or via DKMS packages ( linux-zen kernel on Arch is highly recommended).
Waydroid provides a high-performance, container-based Android runtime environment for Linux distributions. By default, standard Waydroid images are bare-bones, open-source Android (AOSP) builds that lack Google Play Services. To download apps from the Google Play Store, sync your Google account, or run applications dependent on Google APIs, you must install a Waydroid GApps image.