Nightzuku
Nightzuku (kerneldroid.nightzuku) is an Android privileged Binder proxy and module execution runtime forked from Shizuku. It exposes Android system APIs directly to authorized client applications over Binder IPC under ADB (uid=2000) or root (uid=0) privileges, avoiding su shell spawning overhead.
[!NOTE] Development is consolidated in this repository (
Nightzuku-privateis archived). Nightzuku stripsmoe.shizuku.manager.permission.API_V23from its merged manifest (tools:node="remove") and can coexist with the official Shizuku manager without permission or authority conflicts.
Architecture & Modules
| Module | Language | Responsibility |
|---|---|---|
:manager |
Kotlin / Jetpack Compose | Material 3 Expressive UI (Phone, Android TV, Wear OS), ADB pairing, Security & Access settings, ADB Modules manager, Smart Logs viewer |
:server |
Kotlin | Privileged app_process Binder server (shizuku_server), dual-wire IPC, signature pinning, user/profile isolation (UserAccessPolicy), Android17Compat |
:common |
Kotlin | Shared hidden-API introspector (HiddenApiIntrospector), package signature verifier, label sanitizer, SmartLogEngine |
:nightdog |
Kotlin | Server heartbeat watchdog (NightDog) and system service death/rebind supervisor |
rust/starter |
Rust | Native server supervisor (libshizuku.so), process respawn, and crash spooling |
rust/adb-pairing |
Rust | Native TLS / SPAKE2 / HKDF / AES-GCM wireless ADB pairing library (libadb.so) |
rust/rish |
Rust | Interactive remote shell client over Shizuku/Nightzuku Binder |
Dual-Wire IPC Protocol
Nightzuku operates two concurrent Binder wires and routes each client package via ClientRouting:
| Wire | Interface / Permission | Characteristics |
|---|---|---|
| Native | kerneldroid.nightzuku.INightService (kerneldroid.nightzuku.permission.API) |
Flat Parcel transactions, per-UID capability bitmasks, guarded transactRemote, one-shot execFast; zero server-side moe.shizuku.api stubs |
| Legacy | moe.shizuku.server.IShizukuService (moe.shizuku.manager.permission.API_V23) |
Backward-compatible Shizuku Binder wire; can be disabled globally in Settings -> Security & Access |
TransactGuard validates target Binders and enforces per-UID capability masks before forwarding any transactRemote call.
Security & Isolation Model
| Control | Mechanism | Default State |
|---|---|---|
| Certificate pinning | SHA-256 signing certificate verification with Android 9+ signingCertificateHistory rotation lineage across manager, clients, and UserService hosts |
Always enforced |
| Isolated profile protection | UserAccessPolicy classifies and blocks Samsung Knox, Secure Folder (100–199), Dual Messenger (95–96), Android 15+ Private Space, and OEM Clone profiles (128, 999) from enumeration, temp-whitelisting, and Binder dispatch |
Enabled (blocked) |
| Multi-user scope | Configurable per-profile (Work Profile, Secondary Users) and per-user ID access via Settings -> Security & Access (BINDER_TRANSACTION_getSecurityPolicy / setSecurityPolicy / getDeviceUsers) |
Primary user (0) only |
| Binder delivery scope | Selectable between all declared API clients and pre-authorized apps only (binderDeliveryMode) |
All declared API apps |
| Global access pause | accessPaused immediately rejects non-manager Binder, shell, and UserService transactions |
Off |
| Permission dialog hardening | setHideOverlayWindows, tap-grace delay, Unicode/Bidi label sanitization, shared-UID sibling disclosure, 5-minute prompt nonce window |
Always enforced |
| Smart Logs filtering | Cross-layer crash/QPR/starter snapshot engine with strict OS/HWUI/OEM logcat noise filtering (SmartLogEngine.filterProcessLogcat) |
Active |
Extended app_process cmdline |
LargeCommandTransport + ArgvTrampoline transparently lifts the 128 KiB Linux MAX_ARG_STRLEN limit up to 4 MiB for app_process and sh -c; advertised via getServerDiagnostics (maxAppProcessCmdlineBytes, supportsExtendedAppProcessCmdline) |
Active |
Platform Support
| Platform | UI Stack | ADB Modules & Catalog | Security & Access |
|---|---|---|---|
| Phone / Tablet | Jetpack Compose Material 3 Expressive | Supported (local ZIP + GitHub Catalog + Virtual HTTPS WebUI) | Full UI in Settings |
| Android TV | androidx.tv.material3 |
Excluded | Server-enforced |
| Wear OS | androidx.wear.compose:compose-material3 |
Excluded | Server-enforced |
Documentation
| Document | Scope |
|---|---|
| ADB Modules API | ZIP format, module.prop schema, runtime env, nightzuku-guard, virtual HTTPS WebUI bridge |
| ADB Modules Guide | Authoring workflow, minimal module template, Action vs Service policy, safety limits |
| GitHub Catalog | Decentralized topic:adb-modules discovery, PAT encryption, install modes, API quotas |
| NightDog Architecture | Server watchdog state machine, NightDogClient supervision, JobScheduler update checks |
| Nightzuku Connectors | Local ContentProvider (content://kerneldroid.nightzuku.connector) for third-party activators |
| Android 17 Compatibility | Verified hidden API signatures (IPermissionManager, IPackageManager, IUserManager) and Android17Compat |
| Android TV Support | TV Compose architecture, D-pad focus model, and theming |
| Wear OS Compatibility | Runtime watch detection, Wear Material 3 components, and SDK compatibility |
| Wear OS Pairing Guide | Wireless ADB pairing procedure and troubleshooting matrix for Wear OS 5+ |
| ADB Loopback Restriction Memo | Why plain adb tcpip loopback startup is unreliable on Android 17+ |
Developer & Build Reference
Client Integration
- Upstream Shizuku API and samples: https://github.com/RikkaApps/Shizuku-API
- ADB shell capabilities vary by Android release; inspect AOSP
packages/Shell/AndroidManifest.xmland queryShizukuService#getUid/checkPermissionat runtime. - Android 9+ restricts hidden API reflection; use AndroidHiddenApiBypass in client processes where required.
- Direct
transactRemotecallers must verify transaction codes and parameter layouts against the target platform's AIDL definitions.
Building from Source
git clone --recurse-submodules https://github.com/kerneldroid/Nightzuku.git
cd Nightzuku
./gradlew :manager:assembleDebug
Run unit tests:
./gradlew :common:testDebugUnitTest :server:testDebugUnitTest
:manager:assembleDebug packages a debuggable server. Enable Always install with package manager in Android Studio to ensure updated server binaries are deployed.
Screenshots
Screenshot Gallery (automated emulator captures)
[!NOTE] Captures are generated by
.github/workflows/screenshots.ymlon Android 17, Wear OS 7, and Android TV 16 emulators and may lag behindHEAD.
Phone
![]() Main |
![]() Authorized Apps |
![]() ADB Modules |
![]() Module WebUI |
![]() Settings |
|
Wear OS
![]() Main |
![]() Settings |
Android TV
![]() Main |
|
![]() Settings |
License & Identity Constraints
Licensed under Apache License 2.0 (LICENSE).
- Launcher assets:
manager/src/main/res/mipmap*/ic_launcher*.pngmay only be used to represent Nightzuku. - Package identity: The main app uses
kerneldroid.nightzuku. Official releases also publish a compatibility stub undermoe.shizuku.privileged.apiand optional stealth-ID builds (com.*). Derived/unofficial works must not use the nameShizukuor that stub application ID.
Credits
- RikkaApps/Shizuku — upstream architecture and protocol.
- Razgame — app list fix.
- Porter (d4rken-org) — security hardening concepts (package signing verification, config ownership handoff, anti-spoofing permission prompts, wireless ADB/mDNS edge-case analysis), re-implemented natively for Nightzuku.









