roro2239/Stellar
A deeply customized fork of Shizuku that lets Android apps use system-level APIs via ADB or root, with finer-grained permissions and a Shizuku compatibility layer.
- Stars
- 1,777
- Forks
- 66
- Open issues
- 27
- Last commit
- 20 days ago
What is it?
Stellar is a fork of Shizuku, the Android framework that lets apps call APIs requiring system-level privileges without holding root themselves. Once the Stellar service is started through ADB wireless debugging or root, authorized apps can make privileged calls through it.
Compared with upstream Shizuku, Stellar splits permissions into finer categories such as a core service permission and a follow-startup permission that ties an app's lifecycle to the service. It adds boot-time startup options, a daemon mode in which the service and a guardian process restart each other, and a mode that drops root privileges to the shell user (uid 2000). It also includes a compatibility layer so apps written against the Shizuku API can run on Stellar without code changes.
The project is written in Kotlin and includes a redesigned manager UI in Material Design 3. Developers integrate it through the Stellar-API library distributed via JitPack, and the repository provides an integration guide for migrating from Shizuku.
Key features
- 01Starts a privileged service via ADB wireless debugging or root.
- 02Fine-grained permission model with separate core and follow-startup permissions.
- 03Shizuku API compatibility layer so existing Shizuku apps can run without code changes.
- 04Optional root-to-shell privilege dropping (uid 2000) for safer operation.
- 05Daemon mode where the service and a guardian process restart each other after unexpected exits.
- 06Re-enables deprecated Shizuku features such as newProcess() and runtime permission grant/revoke.
Use cases
- Building Android utilities that need system APIs without requiring the user to root the device.
- Migrating an existing Shizuku-based app to a fork that offers extra permission controls.
- Running automation or system-tuning tools that start at boot through Stellar's startup options.
Quick start
- 1
Add the JitPack dependency com.github.roro2239:Stellar-API:latest.release
- 2
Configure StellarProvider in AndroidManifest
- 3
Initialize Stellar and request permission
- 4
Call Stellar APIs to perform privileged operations
Things to know
- The service must be started through ADB wireless debugging or root access.
- Some Shizuku features such as rish and Sui support were removed, so it is not a full drop-in replacement.
In collections
Topics
FAQ
- What is Stellar?
- A deeply customized fork of Shizuku that lets Android apps use system-level APIs via ADB or root, with finer-grained permissions and a Shizuku compatibility layer. Stellar is a fork of Shizuku, the Android framework that lets apps call APIs requiring system-level privileges without holding root themselves. Once the Stellar service is started through ADB wireless debugging or root, authorized apps can make privileged calls through it.
- Is Stellar free to use? What license does it have?
- Stellar is open source under the MPL-2.0 license. Check the license terms before using it in commercial products.
- Is Stellar still maintained?
- Actively maintained. The last commit to Stellar was on Oct 18, 2026.
- What can I use Stellar for?
- Building Android utilities that need system APIs without requiring the user to root the device. Migrating an existing Shizuku-based app to a fork that offers extra permission controls. Running automation or system-tuning tools that start at boot through Stellar's startup options.
- How do I install Stellar?
- Add the JitPack dependency com.github.roro2239:Stellar-API:latest.release Configure StellarProvider in AndroidManifest Initialize Stellar and request permission Call Stellar APIs to perform privileged operations
- Where can I get Stellar?
- The source code and installation instructions are on GitHub: https://github.com/roro2239/Stellar
Summary generated by AI from the project's README. GitHub stats refresh daily.
Related projects
Android app that freezes apps by disabling, hiding, suspending or uninstalling them, without root for most modes.
An open source, Material Design file manager for Android 5.0+ with root, archive, and network share (FTP, SFTP, SMB, WebDAV) support.
Free, open-source Android app for backing up and restoring app data, with root access required.
An Android app of essential tools, mods and workarounds for Pixel and other Android phones, built with Kotlin and Jetpack Compose.
An open-source Android firewall and package manager that blocks per-app network access and disables or uninstalls apps, using iptables, Shizuku, or a local VPN.