Note: Waydroid does not work on Nvidia’s proprietary drivers, and requires an AMD or Intel GPU for the best results.
What is Waydroid?
Waydroid is an Android container that runs on Linux. Bazzite users can run Android applications using this method.
First Time Setup
Open a host terminal and enter this command to setup Waydroid:
ujust setup-waydroid
Initialize Waydroid
Waydroid requires users to initialize it for the first time which can be done by selecting:
Initialize Waydroid
Make sure this worked by entering this command:
/usr/bin/waydroid-launcher
This will launch Waydroid for the first time.
Configure Waydroid
Part 1: Stop Waydroid Session
Waydroid needs to stop running to configure properly.
Open a host terminal and enter this command:
waydroid session stop
Part 2: Configuration
Open a host terminal and enter this command:
ujust setup-waydroid
Selecting Configure Waydroid will allow users to install additional Android tweaks with the Waydroid Extras Scripts.
- Select Android Version (Android 11 recommended)
- Select items to install
a) GApps (Default Android applications including the Google Play Store) or microG (Free alternatives to Google applications)
b) ARM Translation (libndk for AMD CPUs only & libhoudini for Intel CPUs only)
c) Magisk (Android power user suite)
d) Logitech Smartdock Support (Currently broken)
e) F-Droid Privileged Extension (Proper F-Droid support)
f) widevine (Support for video streaming DRM)
Get Google Device ID to Get Certified
-
Launch Waydroid
(Waydroid must be running) -
After selecting your current Android version, select
Get Google Device ID to Get Certifiedespecially if you plan to use the Google Play Store (GApps). -
Follow the instructions in the terminal output.
After verification has happened, it will usually take a while before your device is verified.
Add as a Non-Steam Shortcut
This is useful for Bazzite images that use Steam Gaming Mode.
Make sure to add the shortcut in /usr/bin/waydroid-launcher for Waydroid to work properly in Steam Gaming Mode.
Disable Inputs to Waydroid When Unfocused
Waydroid has an issue where it will register inputs from controllers, keyboards, and other input devices even when the window is not focused.
Disable this functionality:
Note: Waydroid must be running!
In a host terminal, run this command:
waydroid prop set persist.waydroid.uevent false
If you ever want to undo this change, run the same steps but set true instead of false with the same command.
Resolution & Density Options
Note: This is intended for users who have issues with Waydroid’s resolution, scaling, or running Waydroid nested. This is optional.
Open a host terminal and enter the following commands:
sudoedit /etc/default/waydroid-launcher
sudoedit /etc/default/steamos-nested-desktop
Save the text files when done.
Waydroid Hybrid Graphics Fix
Note: This is only intended for users who have multiple GPUs in their hardware who experience graphical corruptions in Waydroid.
Enter in a host terminal:
ujust setup-waydroid
Then Select GPU for Waydroid which will give the option on what GPU to utilize for Waydroid to fix graphical corruptions.
Reset Waydroid
Warning: You will lose all of your Waydroid data.
If you experience issues or want a fresh Waydroid container, then select Reset Waydroid after entering:
ujust setup-waydroid
Documentation Contributors: Kyle Gospo, Gecked-Deck, Nathaniel Warburton, and Jorge Castro
See also: Upstream documentation
