Skip to content
Authors:

Waydroid Setup Guide

Google Play Store|650x500

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

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ΒΆ

Customize your Waydroid container

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.

  1. Select Android Version (Android 11 recommended)
  2. Select items to install
Available Waydroid Extras:ΒΆ
  • GApps (Default Android applications including the Google Play Store) or microG (Free alternatives to Google applications)
  • ARM Translation (libndk for AMD CPUs only & libhoudini for Intel CPUs only)
  • Magisk (Android power user suite)
  • widevine (Support for video streaming DRM)

Get Google Device ID to Get Certified (GApps)ΒΆ

Waydroid_DeviceID|690x182

  1. Launch Waydroid
    (Waydroid must be running)

  2. After selecting your current Android version, select Get Google Device ID to Get Certified especially if you plan to use the Google Play Store (GApps).

  3. 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 /usr/bin/waydroid-launcher to Steam as a non-Steam game 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

Project WebsiteΒΆ

https://waydro.id/


See also: Upstream documentation

← View all Bazzite documentation