├── COMPATIBILITY.md
├── CONTRIBUTING.md
└── README.md
/COMPATIBILITY.md:
--------------------------------------------------------------------------------
1 | # A table of App Rating
2 |
3 | This table logs the user experience of using various apps on Waydroid. Many factors affect this like Waydroid, vulkan, libhoudini arm translation, the developer's intended input method and Google Play integration.
4 |
5 | Rating | Experience
6 | ---------|----------
7 | 1 | Does not launch
8 | 2 | Google Play services required.
9 | 3 | No mouse support.
10 | 4 | Subpar experience on mouse and keyboard.
11 | 5 | Good experience on mouse and keyboard.
12 |
13 | Note: All Games respect touch input. All games rated above 3 are playable.
14 |
15 | App | Test Date | Rating | Status
16 | ---------|----------|---------|---------
17 | Tachiyomi / Aniyomi | 16th December 2021 | 5 | arm64 version support. extensions to be installed separately.
18 | Clash Royale | 12th December 2021 | 1 | Brief flash
19 | Shadow Fight 2 | 12th December 2021 | 3 | Mouse support. No Keyboard support.
20 | Hill Climb Racing | 12th December 2021 | 5 | Keyboard support.
21 | Cut the rope | 12th December 2021 | 5 | Mouse support
22 | Subway Surfers | 12th December 2021 | 3 | No Mouse support. No Keyboard support
23 | Princess Connect RE | 12th December 2021 | 1 | Black screen
24 | Where's My Water! 2 | 13th December 2021 | 2 | Would not run without Google Play Services
25 | Talking Tom Gold Run | 13th December 2021 | 5 | Keyboard Support
26 | Crossy Road | 13th December 2021 | 5 | Keyboard Support
27 | Fruit Ninja 2 | 13th December 2021 | 3 | Game loads. No mouse support.
28 | Plants vs Zombies 2 | 14th December 2021 | 2 | Game does not load due to absence of Google Services
29 | C.A.T.S. | 14th December 2021 | 5 | Mouse support
30 | Explorers | 14th December 2021 | 4 | Mouse support. no Keyboard support
31 | My Talking Tom | 14th December 2021 | 4 | Mouse support. bad landscape scaling
32 | Steampunk Defense | 15th December 2021 | 5 | Mouse support.
33 | Among Us | 15th December 2021 | 1 | Black screen with audio.
34 | Brain It On! | 15th December 2021 | 5 | Mouse support.
35 | JetPack Joyride | 15th December 2021 | 5 | Mouse support.
36 | Mini Militia | 15th December 2021 | 4 | Mouse support. no Keyboard support.
37 | Real Racing 3 | 15th December 2021 | 1 | Does not launch.
38 | BombSquad | 15th December 2021 | 4 | mouse support.
39 | Botworld Adventure | 15th December 2021 | 5 | mouse support.
40 | Armajet | 15th December 2021 | 4 | mouse support.
41 | Alto's Adventure + Oddysee | 15th December 2021 | 4 | mouse support except at "tap to continue" prompts. ```adb shell input tap 400 400``` needed.
42 | Episode | 15th December 2021 | 4 | mouse support. bad landscape scaling.
43 | Magic Arena | 16th December 2021 | 1 | Assets not visible
44 | Super Auto Pets | 16th December 2021 | 5 | mouse support.
45 | Hocus | 16th December 2021 | 5 | Mouse support.
46 | Fiete World | 16th December 2021 | 3 | No mouse support.
47 | Angry Birds Friends | 17th December 2021 | 3 | No mouse input.
48 | Grow Castle | 17th December 2021 | 5 | mouse support.
49 | Yeah Bunny! | 19th December 2021 | 5 | mouse support
50 | Plague Inc. | 19th December 2021 | 5 | mouse support
51 | 8 Ball Pool | 21st December 2021 | 5 | mouse support
52 | Mekorama | 21st December 2021 | 5 | mouse support. crashed 1 time.
53 | Beach Buggy Racing 1 + 2 | 23rd December 2021 | 4 | mouse support, keymapping required for playability
54 | Coin Master | 23rd December 2021 | 1 | Stuck at startup.
55 | Smash Hit | 24th December 2021 | 5 | Mouse support.
56 | Candy Crush Saga | 25th December 2021 | 5 | Mouse support.
57 | Angry Birds 2 | 25th December 2021 | 1 | Stuck at Startup.
--------------------------------------------------------------------------------
/CONTRIBUTING.md:
--------------------------------------------------------------------------------
1 | # Contributing Guide
2 |
3 | We can improve this Project in these aspects:
4 |
5 | - How to use Waydroid after install? e.g. proper colors, clipboard syncing, how to setup keyboard mapping, etc
6 | - Create a script to automate the process of setting waydroid up.
7 | - More compatibility testing, and troubleshooting
8 | - How to get MicroG or Play Services set up on Waydroid.
--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
1 | # Archiving, as waydroid now defaults to Android 11. Just use https://github.com/casualsnek/waydroid_script to enable libhoudini.
2 |
3 | # Waydroid Guide
4 |
5 | This guide takes you through the process of installing waydroid, and getting arm translation on Linux.
6 |
7 | [COMPATIBILITY.md](COMPATIBILITY.md) is the table of app compatibility. You're encouraged to request for your favourite apps' compatibility status on the issues page.
8 |
9 |
10 |
11 | Tested System Details:
12 |
13 |
14 | ```
15 | OS: Zorin OS 16, Ubuntu 20.04, Arch
16 | Kernel: 5.11.0, 5.16.16
17 | CPU: Intel i3-7020U, Intel i7-1065G7
18 | ```
19 |
20 |
21 |
22 |
23 | Pre-requisites:
24 |
25 |
26 | 1. Follow the pre-requisites section: https://docs.waydro.id/usage/install-on-desktops#install-pre-requisites
27 |
28 | 2. Download lineageOS android 11 system images archive from SourceForge: https://sourceforge.net/projects/blissos-dev/files/waydroid/lineage/lineage-18.1/
29 |
30 | (Use a download manager like [fireDM](https://github.com/firedm/FireDM) in case of slow download speeds)
31 |
32 | 3. Create the system images directory:
33 | ```
34 | sudo mkdir -p /usr/share/waydroid-extra/images
35 | ```
36 |
37 | 4. Extract the contents of the archive to ```~/temp_folder``` (Where ~ denotes the user home directory)
38 |
39 | 5. Move the contents of the ```temp_folder``` to system images directory:
40 | ```
41 | sudo mv ~/temp_folder/* /usr/share/waydroid-extra/images
42 | rmdir ~/temp_folder
43 | ```
44 |
45 | 6. Debian based users must also:
46 |
47 | - follow the install waydroid section upto adding waydroid repo to sources.list : https://docs.waydro.id/usage/install-on-desktops#install-waydroid
48 |
49 | ```impish``` users may use ```hirsute``` in place of ```bullseye```
50 |
51 | - get the latest libgbinder updates:
52 | ```
53 | sudo apt install git libglib2.0-dev libglibutil-dev gcc
54 | git clone --depth=1 https://github.com/mer-hybris/libgbinder
55 | cd libgbinder
56 | make
57 | make install
58 | ```
59 | - copy the new ```libgbinder.so.1```, ```libgbinder.so.1.1``` and ```libgbinder.so.1.1.xx``` files added to /usr/lib to wherever your system has the current libgbinder installed. Use ```dpkg -L libgbinder``` to find out.
60 |
61 |
62 |
63 | Install Waydroid
64 |
65 | 1. Install waydroid
66 | - Arch users follow: https://wiki.archlinux.org/title/Waydroid
67 | - Debian users follow the rest of install waydroid section : https://docs.waydro.id/usage/install-on-desktops#install-waydroid
68 |
69 | 2. Edit ```sudo nano /etc/gbinder.d/anbox.conf``` to read like:
70 | ```
71 | [Protocol]
72 | /dev/anbox-binder = aidl3
73 | /dev/anbox-vndbinder = aidl3
74 | /dev/anbox-hwbinder = hidl
75 |
76 | [ServiceManager]
77 | /dev/anbox-binder = aidl3
78 | /dev/anbox-vndbinder = aidl3
79 | /dev/anbox-hwbinder = hidl
80 |
81 | [General]
82 | ApiLevel = 30
83 | ```
84 |
85 | 3. Restart waydroid:
86 | ```
87 | sudo systemctl restart waydroid-container.service
88 | waydroid show-full-ui
89 | ```
90 | You may need to sign ashmem_linux manually for secure boot. Unsigned ashmem_linux error:
```modprobe: ERROR: could not insert 'ashmem_linux': Operation not permitted```
91 | ```
92 | sudo update-secureboot-policy --new-key
93 | sudo /usr/src/linux-headers-$(uname -r)/scripts/sign-file sha256 /var/lib/shim-signed/mok/MOK.priv /var/lib/shim-signed/mok/MOK.der $(modinfo -n ashmem_linux)
94 | ```
95 |
98 |
99 |
100 | Arm Translation
101 |
102 |
103 | 1. Install lzip:
104 |
105 | - Debian: `sudo apt install lzip`
106 | - Arch: `sudo pacman -S lzip`
107 |
108 | 2. Install Waydroid Extras Script:
109 | ```
110 | git clone --depth=1 https://github.com/casualsnek/waydroid_script
111 | cd waydroid_script
112 | sudo python3 -m pip install -r requirements.txt
113 | sudo python3 waydroid_extras.py -h
114 | ```
115 |
116 | 3. Install Libhoudini ARM Translation:
117 | ```
118 | cd waydroid_script
119 | sudo python3 waydroid_extras.py -l
120 | ```
121 |
122 | You may need to ```umount -a``` and ```waydroid session stop``` for Libhoudini to install.
123 |
124 | 4. Restart Waydroid Container:
125 | ```
126 | sudo systemctl start waydroid-container.service
127 | ```
128 |
129 | 5. Launch Waydroid:
130 | ```
131 | waydroid show-full-ui
132 | ```
133 |
134 |
135 |
136 | I want to stay on X11 right now
137 |
138 |
139 | Most beginner friendly distros besides Linux Mint Cinnamon do have Wayland pre-installed. Weston can leverage this wayland backend and run Waydroid.
140 |
141 | 1. Install Weston Compositor:
142 | ```
143 | sudo apt install weston
144 | ```
145 |
146 | 2. Launch Weston:
147 | ```
148 | weston
149 | ```
150 |
151 | Click the terminal icon in the top left region inside the Weston window. This opens a terminal window.
152 |
153 | 3. Launch Waydroid inside Weston
154 | ```
155 | waydroid show-full-ui
156 | ```
157 |
158 | You may need to ```sudo waydroid container restart``` to restart the android image before launching inside weston.
159 |
160 |
161 |
162 | ## Bibliography
163 |
164 | This guide has been made possible thanks to these original sources and projects.
165 |
166 | 1. Jon West: https://t.me/WayDroid/55770 (Major Source)
167 | 2. Waydroid: https://waydro.id/
168 | 3. Waydroid Script: https://github.com/casualsnek/waydroid_script/
169 | 4. BlissOS: https://blissos.org/
170 |
171 | ## [Want to Contribute?](CONTRIBUTING.md)
172 |
173 | ## Need help?
174 |
175 | Odds are something slipped through at our end.
176 |
177 | Creating a bug report, and improving the guide helps the next person who follows the guide.
178 |
179 | The good folks at the Waydroid [matrix](https://matrix.to/#/#waydroid:connolly.tech) and [telegram](https://t.me/WayDroid) chatrooms are very helpful too, in case you need advanced troubleshooting.
180 |
--------------------------------------------------------------------------------