Repository navigation
Home
The next-generation Android elevated execution, system virtualization, and autonomous diagnostic environment.
- Overview & Vision
- System Architecture
- Visual Tour & App UI
- Core Features Deep Dive
- Roadmap & Release Milestones
- Developer & Build Guide
OmniShizuku expands the proven foundation of Shizuku into a comprehensive, hardened Android system toolkit. While traditional Shizuku allows third-party applications to run with ADB or root permissions via standard binder transactions, OmniShizuku adds:
-
Autonomous Diagnostics (
AGY Shell/Comput Agent): Self-healing crash analysis, real-time log ingestion, command execution, and automated remediation. - ADB Module Virtualization: Run modular system tweaks, hooks, and virtualized packages without flashing Magisk/KernelSU modules.
- Enterprise & Stealth Management: Device Owner provisions, root/hook detection evasion stubs, and hidden API reflection engines.
-
Complete Media & System Utilities: Call recording engine, WallYou wallpaper integrations, and background keep-alive daemons (
NightDog).
OmniShizuku coordinates seamlessly between user-space applications, manager controls, privileged native daemons, and system server interfaces:
+-------------------------------------------------------------------+
| Client Apps & Tasker Plugins |
| - Shizuku Client Apps - Tasker Automation - WallYou |
+---------------------------------+---------------------------------+
| (AIDL Binder IPC / Broadcasts)
v
+-------------------------------------------------------------------+
| OmniShizuku Manager (moe.shizuku.manager) |
| - Jetpack Compose UI - AGY Terminal Engine |
| - Comput Autonomous Agent - Virtualized Module Loader |
+---------------------------------+---------------------------------+
| (PTY Pipes & Server IPC)
v
+-------------------------------------------------------------------+
| OmniShizuku Server (UID 2000 / UID 0) |
| - Shizuku Service Binder - rish PTY Client |
| - NightDog Keep-Alive Daemon - DFRoot Sandbox |
+---------------------------------+---------------------------------+
| (Privileged System Trampoline)
v
+-------------------------------------------------------------------+
| Android OS Platform (API 26 - 37) |
| - ActivityManager / PackageManager Services |
| - Binder IPC Driver & SELinux Domain Transition |
+-------------------------------------------------------------------+
![]() Home Dashboard Status overview, wireless debugging pairing, and root activation toggle. |
![]() Application Permissions Granular per-application ADB binder access granting and revocation. |
![]() AGY Comput Agent Real-time system diagnostics, logcat inspection, and automated bug reporting. |
![]() Virtualized ADB Modules Install and control system scripts and user-space enhancements dynamically. |
![]() Labs & System Tools Root checkers, hook detection diagnostics, and package disablers. |
![]() ShizuWall & Wallpaper Engine System-level wallpaper modifications without OEM launcher restrictions. |
OmniShizuku includes an embedded intelligent terminal agent (AgyCliEngine) and UI screen (ComputScreen):
- Autonomous Remediation: Analyzes log outputs, catches binder disconnects, and automatically generates reproducible diagnostic packages.
- Safety Guards: Detects inactive binder states to prevent spurious crash reports and protects user privacy by redacting device identifiers.
-
PTY Native Execution: Full interactive terminal session using native pseudo-terminals (
rish).
Enables non-root and rooted devices to run modular enhancements:
- Dynamic mounting and environment path injection for scripts.
- Sandboxed isolation preventing conflicts with device OEM security layers.
- Real-time notification of client apps requesting elevated binder tokens.
- Automatic revocation for uninstalled or tampered client APKs.
- Device Owner provisioning and Knox/SELinux compatibility profiles.
- Directly interfaces with Android's
IWallpaperManagervia privileged binder. - Bypasses OEM restrictions on Xiaomi HyperOS, Samsung OneUI, and ColorOS.
- Anti-Detection Testbeds: Tests root evasion against SafetyNet, Play Integrity, and enterprise MDM scanners.
- Local Shell: Embedded local terminal with search, copy, and syntax highlighting.
- A persistent daemon preventing OEM background app killers (e.g. Samsung Phantom Process Killer) from terminating the active ADB pairing daemon.
[v1.0.0 Alpha] [v1.0.0 RC (Current)] [v1.1.0 (Upcoming)]
| | |
Core Shizuku Refactor AGY Comput Terminal Android 17 Validation
Gradle 9.5 & JDK 21 0 Security Alerts Multi-Device Mesh ADB
Multi-Module Structure 63/63 Automated Unit Tests Extended Tasker Plugins
| Milestone | Status | Key Highlights |
|---|---|---|
| v1.0.0-alpha | Completed | Clean architectural separation (:server, :starter, :manager, :database, :wallpaper-apis, :nightdog). |
| v1.0.0-rc | Active | 63 automated tests with 100% pass rate, CodeQL SAST integration, zero vulnerabilities. |
| v1.1.0 | Planned | Enhanced Android 17 readiness, automated cross-device ADB pairing via QR code mesh, expanded Tasker actions. |
- JDK: OpenJDK 21
-
Android SDK: Build Tools
37.0.0, NDK29.0.14206865, CMake3.22.1
# Clone the repository
git clone https://github.com/krishna3163/OmniShizuku.git
cd OmniShizuku
# Compile Manager APK
./gradlew :manager:assembleDebug --no-daemon
# Execute Full Automated Unit Test Suite
./gradlew testDebugUnitTest --no-daemonOmniShizuku Project β’ Maintained by @krishna3163





