/waydroid-magisk

Kitsune Mask (magisk) manager for Waydroid.

Primary LanguagePythonGNU General Public License v3.0GPL-3.0

Waydroid Magisk

Kitsune Mask manager for Waydroid.

Installing Magisk on Waydroid

Requirements

  • waydroid
  • make
  • git

Installation

From PPA

  1. curl -s --compressed "https://nitanmarcel.github.io/waydroid-magisk/waydroid_magisk.gpg" | gpg --dearmor | sudo tee /etc/apt/trusted.gpg.d/waydroid_magisk.gpg > /dev/null
  2. sudo curl -s --compressed -o /etc/apt/sources.list.d/waydroid_magisk.list https://nitanmarcel.github.io/waydroid-magisk/waydroid_magisk.list
  3. sudo apt update
  4. sudo apt install waydroid-magisk
  5. run sudo waydroid_magisk install to install Magisk
  • waydroid-magisk can also be used as a manager. If you want to use Kitsune Mask Manager instead use the install command with --manager argument.
  1. start waydroid and run sudo waydroid_magisk setup to trigger first time setup.
  2. To avoid any issues it's important to read FAQ before using Kitsune Mask on waydroid.

From GitHub

  1. git clone https://github.com/nitanmarcel/waydroid-magisk-installer/
  2. run sudo make install USE_SYSTEMD=1
  • If using upstart (e.g Ubuntu Touch 16.04)
  • run sudo make install USE_UPSTART=1
  1. run sudo waydroid_magisk install to install Magisk
  • waydroid-magisk can also be used as a manager. If you want to use Kitsune Mask Manager instead use the install command with --manager argument.
  • Ubuntu Touch requires setting an working directory in /home/phablet
  • sudo waydroid_magisk install --tmpdir /home/phablet/magisk_waydroid
  1. start waydroid and run sudo waydroid_magisk setup to trigger first time setup.
  2. enable ota survival service
  • For systemd sudo systemctl enable --now waydroid_magisk_ota.service
  • For upstart sudo start waydroid_magisk_ota.service
  1. To avoid any issues it's important to read FAQ before using Kitsune Mask on waydroid.

Usage

  • a detailed list of all the available commands can be found in API.md

FAQ

What does work?

  • root
  • zygisk
  • modules
  • updates
  • ota updates survival (Starting with waydroid 1.4.0)

Waydroid won't start

Note that Waydroid may take longer to boot due to Magisk being set up.

No internet connection

Try restarting Waydroid using either systemd or init (depending on your system).

Magisk modules not working or not showing as installed

Currently, modules only work with Kitsune Mask Canary. Download and install the apk in Waydroid, and update by following the instructions in the "Updating" section below.

Kitsune Mask fails to patch SELinux policy.

  • Use waydroid_magisk to update and setup Magisk.

Updating

  • Using Kitsune Mask to install Magisk directly into the system partition.
  • Using waydroid_magisk install --update.

Does Zygisk work?

Zygisk only works with Kitsune Mask Canary which gets installed by default.

I've enabled Zygisk in Kitsune Mask Stable!!

  • Run waydroid_magisk zygisk disable - to disable zygisk.

How is this different from other scripts?

magisk_waydroid is a Kitsune Mask manager, bringing all the features from Kitsune Mask manager in your command line.

What is Kitsune Mask?

Kitsune Mask is a fork of the official Magisk Manager with the old Magisk Hide feature re-added and other new features. You can find a list of differences between Kitsune Mask and official Magisk here.

Arch Linux

On arch based distributions, linux-xanmod-anbox with linux-xanmod-anbox-headers (needs psi=1 in cmdline) from ArchLinuxCN AUR is recommended, otherwise Kitsune Mask might not work properly.

Ubuntu Touch

waydroid-magisk is developed to be compatible with almost every Linux OS, including Ubuntu Touch. But a few issues can still occur such as (workarounds included).

  • Readonly filesystem/No space left
    • sudo waydroid_magisk install --tmpdir /home/phablet/magisk
  • Failed to re-execute lxc-attach via memory file descriptor
    • Use waydroid_magisk via adb
    • or enable ssh android-gadget-service enable ssh and ssh to localhost (ssh localhost)
  • CANNOT LINK EXECUTABLE "service": "/system/lib/libcutils.so" is 32-bit instead of 64-bit
    • sudo env LD_LIBRARY_PATH=/android/system/lib64/ waydroid_magisk {command failing here}

Credits