Waydroid Extras Script
Script to add gapps and other stuff to waydroid!
Installation/Usage
Interactive terminal interface
git clone https://github.com/casualsnek/waydroid_script
cd waydroid_script
sudo python3 -m pip install -r requirements.txt
sudo python3 main.py
Command Line
git clone https://github.com/casualsnek/waydroid_script
cd waydroid_script
sudo python3 -m pip install -r requirements.txt
# install something
sudo python3 main.py install {gapps, magisk, libndk, libhoudini, nodataperm, smartdock, microg}
# uninstall something
sudo python3 main.py uninstall {gapps, magisk, libndk, libhoudini, nodataperm, smartdock, microg}
# get Android device ID
sudo python3 main.py certified
# some hacks
sudo python3 main.py hack {nodataperm, hidestatusbar}
Dependencies
"lzip" is required for this script to work, install it using your distribution's package manager:
Arch, Manjaro and EndeavourOS based distributions:
sudo pacman -S lzip
Debian and Ubuntu based distributions:
sudo apt install lzip
RHEL, Fedora and Rocky based distributions:
sudo dnf install lzip
openSUSE based distributions:
sudo zypper install lzip
Install OpenGapps
Open terminal and switch to directory where "main.py" is located then run:
sudo python3 main.py install gapps
Then launch waydroid with:
waydroid show-full-ui
After waydroid has finished booting open terminal and switch to directory where "main.py" is located then run:
sudo python3 main.py google
Copy the returned numeric ID open "https://google.com/android/uncertified/?pli=1" enter the id and register it, you may need to wait upto 10-20 minutes for device to get registered, then clear Google Play Service's cache and try logging in !
Install Magisk
Open terminal and switch to directory where "main.py" is located then run:
sudo python3 main.py install magisk
Magisk will be installed on next boot !
Zygisk and modules like LSPosed should work now.
If you want to update Magisk, Please use Direct Install into system partition
or run this sript again.
This script only focuses on Magisk installation, if you need more management, please check https://github.com/nitanmarcel/waydroid-magisk
Install libndk arm translation
libndk_translation from guybrush firmware.
libndk seems to have better performance than libhoudini on AMD.
Open terminal and switch to directory where "main.py" is located then run:
sudo python3 main.py install libndk
Install libhoudini arm translation
Intel's libhoudini for intel/AMD x86 CPU, pulled from Microsoft's WSA 11 image
houdini version: 11.0.1b_y.38765.m
houdini64 version: 11.0.1b_z.38765.m
Open terminal and switch to directory where "main.py" is located then run:
sudo python3 main.py install libhoudini
Integrate Widevine DRM (L3)
Open terminal and switch to directory where "main.py" is located then run:
sudo python3 main.py install widevine
Install Smart Dock
Open terminal and switch to directory where "main.py" is located then run:
sudo python3 main.py install smartdock
Granting full permission for apps data (HACK)
This is a temporary hack to combat against the apps permission issue on Android 11. Whenever an app is open it will always enable a property (persist.sys.nodataperm) to make it execute a script to grant the data full permissions (777). The correct way is to use sdcardfs
or esdfs
, both need to recompile the kernel or WayDroid image.
Arknights, PUNISHING: GRAY RAVEN and other games won't freeze on the black screen.
Open terminal and switch to directory where "main.py" is located then run:
sudo python3 main.py hack nodataperm
WARNING: Tested on lineage-18.1-20230128-VANILLA-waydroid_x86_64.img
. This script will replace /system/framework/service.jar
, which may prevent WayDroid from booting. If so, run sudo python3 main.py uninstall nodataperm
to remove it.
Or you can run the following commands directly in sudo waydroid shell
. In this way, every time a new game is installed, you need to run it again, but it's much less risky.
chmod 777 -R /sdcard/Android
chmod 777 -R /data/media/0/Android
chmod 777 -R /sdcard/Android/data
chmod 777 -R /data/media/0/Android/obb
chmod 777 -R /mnt/*/*/*/*/Android/data
chmod 777 -R /mnt/*/*/*/*/Android/obb
- https://github.com/supremegamers/device_generic_common/commit/2d47891376c96011b2ee3c1ccef61cb48e15aed6
- https://github.com/supremegamers/android_frameworks_base/commit/24a08bf800b2e461356a9d67d04572bb10b0e819
Install microG, Aurora Store and Aurora Droid
sudo python main.py install microg
Hide Status Bar
sudo python3 main.py hack hidestatusbar
Get Android ID for device registration
You need to register you device with its it before being able to use gapps, this will print out your Android ID which you can use for device registration required for google apps: Open terminal and switch to directory where "main.py" is located then run:
sudo python3 main.py certified
Star this repository if you find this useful, if you encounter problem create a issue on github !
Error handling
- Magisk installed: N/A
Check waydroid-magisk