A shell script to easily install / uninstall Android (via Waydroid) on the Steam Deck running on SteamOS.

NOTE
If you are going to use this script for a video tutorial, PLEASE reference on your video where you got the script! This will make the support process easier! And don't forget to give a shoutout to @10MinuteSteamDeckGamer / ryanrudolf from the Philippines!

If you like my work please show support by subscribing to my YouTube channel @10MinuteSteamDeckGamer.
I'm just passionate about Linux, Windows, how stuff works, and playing retro and modern video games on my Steam Deck!

Monetary donations are also encouraged if you find this project helpful. Your donation inspires me to continue research on the Steam Deck! Clover script, 70Hz mod, SteamOS microSD, Secure Boot, etc.

Scan the QR code or click the image below to visit my donation page.

1. Do this at your own risk!
2. This is for educational and research purposes only!

Click the image below for a video tutorial and to see the functionalities of the script!

1. Added support for latest SteamOS Preview 3.5.15 - kernel 6.1.52-valve16-1-neptune-61

1. lower audio latency
2. added more sanity checks

1. removed weston. been testing cage for several weeks now and this is way better than weston.
2. added custom hosts file to block ads

Read the sections below carefuly!

1. sudo password should already be set by the end user. If sudo password is not yet set, the script will ask to set it up.

1. Uninstall first if you are using an older version.

1. Go into Desktop Mode and open a konsole terminal.
2. Clone the github repo.
   cd ~/
   git clone https://github.com/ryanrudolfoba/steamos-waydroid-installer
3. Execute the script!
   cd ~/steamos-waydroid-installer
   chmod +x steamos-waydroid-installer.sh
   ./steamos-waydroid-installer.sh
4. Script will automatically install Waydroid together with the custom config. Install will roughly take around 5mins depending on the internet connection speed.
5. Once done exit the script and go back to Game Mode.

1. Go to Game Mode.
2. Run the Android_Waydroid_Cage launcher.

1. Go to Desktop Mode.
2. Open konsole terminal and type the commands -
   cd ~/Android_Waydroid
   ./uninstall.sh
3. Enter the sudo password when prompted.
4. Waydroid and the custom configs will be uninstalled.
5. Delete the Android_Waydroid_Cage and Android_Waydroid_Weston shortuct in Game Mode.
6. OPTIONAL - Delete the steamos-nested-desktop shortcut in Game Mode.

1. If you encounter an issue with the script, try to uninstall, clone the repo again and perform an install.
   Reason for that - you might be using an older version of my script and a new version might have already fixed your issue.
2. If uninstall / reinstall didn't help, open an issue and please be descriptive as possible.
   At the minimum include this when filing an issue -
   SteamOS version -
   Error message encountered -
   Screenshot of error -
   Do you have any scripts / tweaks that might be causing issues?
3. Downloads are slow when acquiring the waydroid image. This is similar to this issue.
   Answer - You might have connected to a slow sourceforge mirror. Press CTRL-C to cancel the download and re-run the script again.
4. No shortcuts in Game Mode after running the script / Unsupported File Type when adding shortcuts. This is similar to this issue.
   Answer - This issue happens if Steam client cant be run because the script was called from an ssh or virtual tty session. Make sure to run the script on Desktop Mode via konsole.

When there is a SteamOS update the waydroid will be wiped. This is normal behavior due to how SteamOS applies updates.
Re-run the script again but if the SteamOS update contains a new kernel version the script will exit immediately.
Please file an issue report when this happens so I can compile a binder kernel module to match the SteamOS update.

Geekbench Result - Feb 11 2024

This is a Work in Progress - list will be updated accordingly.
If you wish to contribute, please check the google sheets and include the game name, how it runs etc etc.

Plants vs Zombies - Feb 04 2024
Honkai Star Rail - Feb 06 2024
Asphalt 8 Airborne - Feb 08 2024
Honkai Impact 3rd - Feb 10 2024
Mobile Legends - Feb 13 2024
T3 Arena - Feb 16 2024
Warcraft Rumble - Feb 19 2024
Diablo Immortal - Feb 21 2024
Oceanhorn - Feb 23 2024

Please check this google sheets for games tested by other users.
Please feel free to add your game testing in there too! Thank you!

This mini guides are tailor-fitted for the Steam Deck that uses the script provided in this repo.
How to Sideload APKs
How to Upgrade the Android Image
How to Configure Fake Wi-Fi