How rikkaapps/shizuku works
Shizuku is an Android privilege-bridging system: the Manager guides a user to start a privileged server through root or ADB, and client apps use the server’s Binder to invoke system APIs with the server’s permissions. The graph preserves startup, wireless ADB pairing, authorization, server IPC and user services, plus app management and settings. Source excerpts establish only some links; documented runtime relationships are attributed to the README, and uncertain wiring is omitted.
Main entry points: ShizukuService.java Shizuku service · HomeActivity.kt Manager UI · AdbPairingService.kt Wireless ADB pairing · SettingsFragment.kt Settings screen
Components 19
Manager app
- Manager UI
manager/src/main/java/moe/shizuku/manager/home/HomeActivity.kt - Preferences
manager/src/main/java/moe/shizuku/manager/ShizukuSettings.java - Wireless ADB pairing
manager/src/main/java/moe/shizuku/manager/adb/AdbPairingService.kt - Pairing protocol
manager/src/main/java/moe/shizuku/manager/adb/AdbPairingClient.kt - Permission management
manager/src/main/java/moe/shizuku/manager/authorization/AuthorizationManager.kt - App management
manager/src/main/java/moe/shizuku/manager/management/ApplicationManagementActivity.kt - Settings screen
manager/src/main/java/moe/shizuku/manager/settings/SettingsFragment.kt
Server startup
- Startup flow
manager/src/main/java/moe/shizuku/manager/starter/StarterActivity.kt - Process launcher
starter/src/main/java/moe/shizuku/starter/ServiceStarter.java
Privileged server
- Shizuku service
server/src/main/java/rikka/shizuku/server/ShizukuService.java - Permission config
server/src/main/java/rikka/shizuku/server/ShizukuConfigManager.java - Client tracking
server/src/main/java/rikka/shizuku/server/ShizukuClientManager.java - User services
server/src/main/java/rikka/shizuku/server/ShizukuUserServiceManager.java - APK change observers
server/src/main/java/rikka/shizuku/server/ApkChangedObservers.kt
App integration
- Shizuku client API
- Shell loader
shell/src/main/java/rikka/shizuku/shell/ShizukuShellLoader.java
Other components
- Device user
- Android system server
- Client app
Connections 20
- Device user → Manager UI: uses
- Manager UI → Wireless ADB pairing: starts pairing
- Wireless ADB pairing → Pairing protocol: runs protocol
manager/src/main/java/moe/shizuku/manager/adb/AdbPairingService.kt - Manager UI → Startup flow: starts server
- Startup flow → Process launcher: launches process
manager/src/main/java/moe/shizuku/manager/starter/StarterActivity.kt - Process launcher → Shizuku service: starts user service
server/src/main/java/rikka/shizuku/server/ShizukuUserServiceManager.java - Shizuku service → Client app: sends Binder
README.md - Client app → Shizuku client API: uses API
README.md - Shizuku client API → Shizuku service: transacts requests
README.md - Shizuku service → Android system server: forwards IPC
README.md - Android system server → Shizuku service: returns results
README.md - Shizuku service → Permission config: manages permissions
server/src/main/java/rikka/shizuku/server/ShizukuService.java - Shizuku service → Client tracking: tracks clients
server/src/main/java/rikka/shizuku/server/ShizukuService.java - Shizuku service → User services: manages services
server/src/main/java/rikka/shizuku/server/ShizukuService.java - User services → APK change observers: monitors packages
server/src/main/java/rikka/shizuku/server/ShizukuUserServiceManager.java - Manager UI → Permission management: requests access
- Device user → App management: manages apps
- Device user → Settings screen: configures
- Settings screen → Preferences: reads preferences
manager/src/main/java/moe/shizuku/manager/settings/SettingsFragment.kt - Client app → Shell loader: loads shell