Hi all,
In order to help people to install WayDroid on their device, (enabling the use of Android apps in Ubuntu Touch), I've wrote a simple step by step installation guide & tips.
WayDroid is an LXC container implementing currently LineageOS 17.1 (Android 10) within desktop or mobile Linux distributions.
!!! Caution!! WayDroid is still in an early alpha development stage and runs only on some Halium 9 and up devices
Run WayDroid at your own risk!!!
At the moment, according to some users feedback, the compatible phones are the following: (Please feed and correct this list by sending your experience)
EDIT April 14 - 2024: The list below may be outdated. Please check: https://devices.ubuntu-touch.io/ and click on "filters" then "waydroid"
Full functionality:
. Fairephone 3/3+
. Fairphone 4
. JingPad A1/C1
. MI A2 (No WiFi if used with Google Apps)
. OnePlus 5/5T
. OnePlus Nord N10 5G
. OnePlus Nord N100
. Pixel 2 XL
. Pixel 3a
. Poco F1
. Redmi Note 7
. Redmi Note 7 Pro
. Redmi Note 9 Pro
. Redmi Note 9 Pro Max
. Samsung Galaxy S10
. SHIFT6mq
. Vollaphone
. VollaX
. Volla 22
. Xiaomi Poco M2 Pro
Partial functionality:
. Pinephone (Unstable due to the immature porting of the device).
. Pixel 3a XL (Video playback doesn't work on WayDroid)
. Redmi 9 (No external storage)
. Redmi Note 9 S (Some UT apps are broken, see post https://forums.ubports.com/topic/7201/segmentation-fault-after-apt-upgrade-on-rw-system/10)
Working with manual steps:
. Redmi Note 8 Pro:
See details in https://t.me/waydroidonut (search Redmi Note 8 Pro, 24/12/2021 21h30 UTC)
Upcoming / Work in progress:
. You tell me
Not working:
. All Halium <9 devices
. Cosmo Communicator
. Lenovo Tab M10 X605F
. OnePlus6 T
. Pixel 2
. Redmi 7 (Onclite)
. Samsung S9+
. You tell me
WayDroid installation may cancel your Notch fix (if you have installed any). You will need to reinstall it afterward. But it should resist to most UBports OTA updates (No guarantee though)
As Google Play Store is currently unstable and buggy, we recommend to use Micro-G opensource Google's library implementation instead. (see below). Moreover, it offers a much better privacy than the standard Google frame services.
By now, around 80% of the Android apps should work correctly in WayDroid on UT. (see limitations and constraints below).
First, check that your device porting is built under Halium 9 or higher and has the appropriate kernel patches. The best choice for running WayDroid now is certainly the Vollaphone.
!!This method has been successfully tested on the Vollaphone!!
You can install WayDroid as follow: (Choose A or B variant)
Important notice: Since Ubuntu Touch based on Focal, WayDroid is already preinstalled on all Halium 9 and < devices. To install WayDroid, just open the terminal with an ADB or shell connexion and type:
- Without Google Play services:
waydroid init
Then go to "WayDroid Micro-G variant" below to configure WayDroid, app stores, etc...
- With Google Play Store:
waydroid init -s GAPPS
Then reboot the device.
If, for whatever reason, your device does not get WayDroid image preinstalled, go to the below section.
A ) Easy installation:
Go in the OpenStore and install "WayDroid Helper" app:
https://open-store.io/app/waydroidhelper.aaronhafer
From this app, find "WayDroid install" and run the automatic installation.
You can choose either a classic installation, or with Google Apps.
Note that Google Apps method has not be fully tested yet and may have some issues. (Please send your feedback)
Once done, enter in the terminal and type:
sudo mount -o remount,rw /
sudo sed -i '/aidl/s/2/3/' /etc/gbinder.d/anbox.conf
Then restart the device.
If you have a Vollaphone, you will need to add the following command in the terminal app when the installation process is complete:
waydroid prop set persist.waydroid.height_padding 70
Then restart the device.
B ) Manual installation
#Open Ubuntu Touch terminal (or a shell session on your host computer) and run:
sudo -s
sudo mount -o remount,rw /
apt update
apt install waydroid -y
waydroid init
sudo sed -i '/aidl/s/2/3/' /etc/gbinder.d/anbox.conf
alternatively, to install Google Apps, replace the line
waydroid init
with:
waydroid init -s GAPPS
#For Vollaphone, add:
waydroid prop set persist.waydroid.height_padding 70
Then restart device.
WayDroid is now installed on your device.
If you didn't choose the Google Apps installation variant, follow carefully the following instructions:
WayDroid Micro-G variant:
Click on the "WayDroid" icon and open the web browser. Now, from the WayDroid browser, navigate to F-Droid website: https://f-droid.org/ and install F-Droid app.
In F-Droid settings, enable all repositories.
Add Micro-G repo: https://microg.org/fdroid/repo
and, still from F-Droid store, search and install:
- microG Service Core
- FakeStore
- Microg Services Framework Proxy
- MozillaNlpBackend
Open Micro-G app, go in Micro-G settings, check that the device is well registered, (self check-on), and enable and check everything you can. (all boxes should be activated).
Allow Google cloud services and notifications.
In the location module services, activate MozillaNlpBackend
Still in F-droid store, search and install "Aurora Store".
Now you will have 3 stores:
- OpenStore: Ubuntu Touch default store
- F-Droid: Android store giving access to thousands opensource apps (only opensource apps are available)
- Aurora Store: All Android Apps (similar to Google play store, but without Google frame services that are now replaced with Micro-G)
Then, open "WayDroid helper" app (https://open-store.io/app/waydroidhelper.aaronhafer) and hide all duplicate apps you don't need (calculator, contacts, calendar, camera, files, settings, gallery, etc...). Swipe right the app you want to hide and click on the "trash". To show it again, do the same but swipe left and click on "+".
If this method doesn't work, you can manually do it as follow:
Open the terminal and type: (decide before if you want to keep one of those listed in the below command)
sudo -s
for i in ~/.local/share/applications/waydroid.com.android.calculator2.desktop; do echo 'NoDisplay=true' >> $i; done
for i in ~/.local/share/applications/waydroid.com.android.camera2.desktop; do echo 'NoDisplay=true' >> $i; done
for i in ~/.local/share/applications/waydroid.com.android.contacts.desktop; do echo 'NoDisplay=true' >> $i; done
for i in ~/.local/share/applications/waydroid.com.android.email.desktop; do echo 'NoDisplay=true' >> $i; done
for i in ~/.local/share/applications/waydroid.com.android.deskclock.desktop; do echo 'NoDisplay=true' >> $i; done
for i in ~/.local/share/applications/waydroid.com.google.android.dialer.desktop; do echo 'NoDisplay=true' >> $i; done
for i in ~/.local/share/applications/waydroid.com.android.documentsui.desktop; do echo 'NoDisplay=true' >> $i; done
for i in ~/.local/share/applications/waydroid.com.android.gallery3d.desktop; do echo 'NoDisplay=true' >> $i; done
for i in ~/.local/share/applications/waydroid.org.lineageos.eleven.desktop; do echo 'NoDisplay=true' >> $i; done
for i in ~/.local/share/applications/waydroid.org.lineageos.jelly.desktop; do echo 'NoDisplay=true' >> $i; done
for i in ~/.local/share/applications/waydroid.org.lineageos.recorder.desktop; do echo 'NoDisplay=true' >> $i; done
Now you should be able to use both Ubuntu Touch and Android apps on your device.
To uninstall an application, use the store that has installed the app, but note that an issue avoid the icon to be erase from the app launcher. (Please comment if it still occurs)
So you might use the following workaround:
#Open terminal
cd /home/phablet/.local/share/applications
rm 'APPLICATION NAME'
To check if WayDroid is running well, run:
waydroid status
To upgrade WayDroid to a newer version run:
sudo waydroid upgrade
Other WayDroid commands are available in WayDroid helper app.
To activate the automatic rotation of Android applications, you can get the "Rotation Control" application. (Available in Aurora Store / Google Play Store):
https://github.com/sudhirkk/rotation-control
Warnings:
Note that WayDroid and it's integration in Ubuntu Touch is still in an early beta development stage and may be unstable.
Currently Direct WiFi and Bluetooth do not work in WayDroid, so you can't use applications to control IoT devices (ex: Irobot Home, Garmin JR connect, Smart watches, etc...), nor wireless printing services.
WayDroid does not yet support fingerprints reader, so you can not login to a bank account (or any secured app) using your fingerprints, but still able to connect using a standard password.
WayDroid seems to not support NFC yet.
WayDroid does NOT have access to Ubuntu Touch files and medias content. It's currently not possible to send medias stored in Ubuntu Touch using an Android app.
There's NO easy way to backup anything on WayDroid now. It's recommended to keep a copy of all files that you may store in WayDroid.
Sometimes, apps that have just been installed do not displayed on the app launcher, just wait a few minutes (sometimes few hours), or open it through Aurora Store.
(Reboot doesn't seem to fix the issue)
Apps are NOT automatically updated, please check regularly your stores to update them manually.
If WayDroid icon appears twice, just refresh the launcher by pulling it down et release it.
Open WayDroid app gives you access to the full LineageOS GUI. (including all notifications, Trebuchet app launcher, Lineage settings, etc...).
Note that you must open WayDroid app to access to your Android notifications, as they won't appear in Ubuntu Touch.
When you close an Android app, you will see a point at the bottom of the dock, don't mind, it disappears as soon as you open a standard UT app.
Possible issue in the default Ubuntu Touch music app:
If you select the "Titles" music category, when you scroll down the list, it goes back to the top by itself.
Impossible to reach the music titles at the bottom of the list.
Workaround: Stop the WayDroid container and try again.
(Defect found on Vollaphone, OTA-20 stable).
Known issue: When WayDroid is started, GPS does not work in Ubuntu Touch, even if WayDroid is stopped. Only way to use GPS in Ubuntu Touch is to reboot the device.
Follow the latest developments here:
https://forums.ubports.com/topic/7248/waydroid-does-not-release-gps
Apart from that WayDroid works remarkably well. No critical bug has occurred.
To uninstall WayDroid, use the "uninstall WayDroid" option in WayDroid app.
Documentation & Support:
Official documentation is available at www.waydro.id
Telegram main WayDroid user group support: https://t.me/WayDroid
Telegram WayDroid on Ubuntu Touch user group: https://t.me/waydroidonut
To report a bug: https://github.com/waydroid/waydroid/issues
Last update: December 04 / 2024
Credit and thanks to Rudi Timmermans for his support.
