Skip to content
krishna3163 edited this page Nov 11, 2026 · 3 revisions

πŸš€ Welcome to the OmniShizuku Wiki!

OmniShizuku Logo

The next-generation Android elevated execution, system virtualization, and autonomous diagnostic environment.

API Support Kotlin Version NDK Version Test Status Security Alerts


πŸ“– Table of Contents


🌟 Overview & Vision

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:

  1. Autonomous Diagnostics (AGY Shell / Comput Agent): Self-healing crash analysis, real-time log ingestion, command execution, and automated remediation.
  2. ADB Module Virtualization: Run modular system tweaks, hooks, and virtualized packages without flashing Magisk/KernelSU modules.
  3. Enterprise & Stealth Management: Device Owner provisions, root/hook detection evasion stubs, and hidden API reflection engines.
  4. Complete Media & System Utilities: Call recording engine, WallYou wallpaper integrations, and background keep-alive daemons (NightDog).

πŸ› System Architecture

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                |
+-------------------------------------------------------------------+

πŸ“Έ Visual Tour & App UI

Home Dashboard
Home Dashboard
Status overview, wireless debugging pairing, and root activation toggle.
Authorized Applications
Application Permissions
Granular per-application ADB binder access granting and revocation.
Comput Autonomous Agent
AGY Comput Agent
Real-time system diagnostics, logcat inspection, and automated bug reporting.
Module Manager
Virtualized ADB Modules
Install and control system scripts and user-space enhancements dynamically.
Labs & Diagnostic Tools
Labs & System Tools
Root checkers, hook detection diagnostics, and package disablers.
ShizuWall Engine
ShizuWall & Wallpaper Engine
System-level wallpaper modifications without OEM launcher restrictions.

πŸ”¬ Core Features Deep Dive

1. AGY Shell & Autonomous Comput Agent

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).

2. Virtualized ADB & System Modules

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.

3. Application Management & Permission Control

  • 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.

4. ShizuWall & Dynamic Wallpaper Engine

  • Directly interfaces with Android's IWallpaperManager via privileged binder.
  • Bypasses OEM restrictions on Xiaomi HyperOS, Samsung OneUI, and ColorOS.

5. Labs & Advanced Diagnostic Stubs

  • 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.

6. NightDog Background Keep-Alive

  • A persistent daemon preventing OEM background app killers (e.g. Samsung Phantom Process Killer) from terminating the active ADB pairing daemon.

πŸ—ΊοΈ Roadmap & Release Milestones

[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.

πŸ’» Developer & Build Guide

Prerequisites

  • JDK: OpenJDK 21
  • Android SDK: Build Tools 37.0.0, NDK 29.0.14206865, CMake 3.22.1

Build Command

# 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-daemon

OmniShizuku Project β€’ Maintained by @krishna3163