Find your next open-source project

Search by name, purpose, or keyword — or paste a GitHub repository URL

Android root module that gives root apps Shizuku-style Java APIs and remote binder services.

4,365
488
Java
GPL-3.0
5 years old

What it does

Sui is a Magisk module that gives rooted apps direct access to Android framework APIs and lets them start their own AIDL-style Java services under root, through the Shizuku API. Instead of shelling out to su and parsing text, apps call Java APIs as the root identity; the root process exposes its binder to the system server so apps can retrieve it. Sui deliberately adds no binaries to PATH and installs no manager app, which avoids apps that detect those artifacts. It is not a complete root solution and requires Magisk.

Install

Sui is installed as a Magisk module. Download and install it from Magisk itself, or download the zip from the release page and use Install from storage in Magisk. Existing apps that only support su are unaffected.

Open the management UI

On Android 8.0+ with Sui 12.1+, long-press system settings in the home app to find the Sui shortcut; with Sui 12+, entering Developer options prompts to add the shortcut. Alternatively, dial *#*#784784#*#* in the default dialer. The shortcut options depend on the home app supporting Android 7.0/8.0 shortcut APIs.

Interactive shell

Sui does not put files on PATH, so a shell binary must be copied manually; /data/adb/sui/post-install.example.sh shows how to automate this. Once copied, use rish in place of sh.

Development and builds

App developers should use the Shizuku API. To build, clone with submodules (git clone --recurse-submodules) and run :module:assemble<Flavor><BuildType> with Flavor as Riru or Zygisk and BuildType as Debug or Release; the Magisk zip is written to out. Companion tasks push, flash and flashAndReboot push to /data/local/tmp, install via magisk --install-module, or install and reboot.

Constraints

Requires Magisk; non-Zygisk builds also need Riru. It runs on Android and targets rooted devices — it will not provide root on its own. The project is GPL-3.0 licensed. Compatibility depends on Magisk and on the home app for shortcut-based UI access.

HotRepo's take

Sui's only recorded HotRepo snapshot is a 2026-11-10 Java daily list entry with 2 new stars, at best position 7 on that language list. That is a single-day observation, not a sustained trend, and the project has no all-language daily rank recorded. The lasting value of this repo is the API layer it exposes for root apps rather than star velocity: it is infrastructure that apps such as Shizuku-based tools depend on.

Written by AI from the project's README, updated . The project's own docs are the source of truth.

You might also like

  1. RikkaApps/Shizuku-APIRun Android app code with ADB shell or root identity through Shizuku or Sui, for developers building privileged apps.Java2,724
  2. coldMEW/HushSkips Spotify ad breaks on Android without root or a patched app; needs Shizuku for restarts, otherwise mutes.Java18
  3. LSPosed/LSPatchPatch Android APKs to load Xposed modules without root, for Android users and reverse engineers.Java9,453