# rikkaapps/shizuku architecture

> Architecture diagram of the GitHub repository rikkaapps/shizuku, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/rikkaapps/shizuku
- Repository: https://github.com/rikkaapps/shizuku

## Overview

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: [`server/src/main/java/rikka/shizuku/server/ShizukuService.java`](https://github.com/rikkaapps/shizuku/blob/master/server/src/main/java/rikka/shizuku/server/ShizukuService.java) (Shizuku service), [`manager/src/main/java/moe/shizuku/manager/home/HomeActivity.kt`](https://github.com/rikkaapps/shizuku/blob/master/manager/src/main/java/moe/shizuku/manager/home/HomeActivity.kt) (Manager UI), [`manager/src/main/java/moe/shizuku/manager/adb/AdbPairingService.kt`](https://github.com/rikkaapps/shizuku/blob/master/manager/src/main/java/moe/shizuku/manager/adb/AdbPairingService.kt) (Wireless ADB pairing), [`manager/src/main/java/moe/shizuku/manager/settings/SettingsFragment.kt`](https://github.com/rikkaapps/shizuku/blob/master/manager/src/main/java/moe/shizuku/manager/settings/SettingsFragment.kt) (Settings screen)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_manager["Manager app"]
  node_manager_ui["Manager UI<br/>[HomeActivity.kt]"]
  node_settings[("Preferences")]
  node_adb_pair["Wireless ADB pairing"]
  node_pair_client["Pairing protocol"]
  node_authorization["Permission management"]
  node_app_management["App management"]
  node_manager_settings["Settings screen"]
end

subgraph group_startup["Server startup"]
  node_starter_activity["Startup flow<br/>[StarterActivity.kt]"]
  node_starter["Process launcher"]
end

subgraph group_server["Privileged server"]
  node_server["Shizuku service"]
  node_config[("Permission config")]
  node_clients["Client tracking"]
  node_user_services["User services"]
  node_apk_observers["APK change observers"]
end

subgraph group_integration["App integration"]
  node_client_api["Shizuku client API"]
  node_shell_loader["Shell loader"]
end

node_user(("Device user"))
node_system_server["Android system server"]
node_client_app(("Client app"))

node_user -->|"uses"| node_manager_ui
node_manager_ui -.->|"starts pairing"| node_adb_pair
node_adb_pair -->|"runs protocol"| node_pair_client
node_manager_ui -.->|"starts server"| node_starter_activity
node_starter_activity -->|"launches process"| node_starter
node_starter -->|"starts user service"| node_server
node_server -->|"sends Binder"| node_client_app
node_client_app -->|"uses API"| node_client_api
node_client_api -->|"transacts requests"| node_server
node_server -->|"forwards IPC"| node_system_server
node_system_server -->|"returns results"| node_server
node_server -->|"manages permissions"| node_config
node_server -->|"tracks clients"| node_clients
node_server -->|"manages services"| node_user_services
node_user_services -->|"monitors packages"| node_apk_observers
node_manager_ui -.->|"requests access"| node_authorization
node_user -.->|"manages apps"| node_app_management
node_user -.->|"configures"| node_manager_settings
node_manager_settings -->|"reads preferences"| node_settings
node_client_app -.->|"loads shell"| node_shell_loader

click node_manager_ui "https://github.com/rikkaapps/shizuku/blob/master/manager/src/main/java/moe/shizuku/manager/home/HomeActivity.kt"
click node_settings "https://github.com/rikkaapps/shizuku/blob/master/manager/src/main/java/moe/shizuku/manager/ShizukuSettings.java"
click node_adb_pair "https://github.com/rikkaapps/shizuku/blob/master/manager/src/main/java/moe/shizuku/manager/adb/AdbPairingService.kt"
click node_pair_client "https://github.com/rikkaapps/shizuku/blob/master/manager/src/main/java/moe/shizuku/manager/adb/AdbPairingClient.kt"
click node_authorization "https://github.com/rikkaapps/shizuku/blob/master/manager/src/main/java/moe/shizuku/manager/authorization/AuthorizationManager.kt"
click node_app_management "https://github.com/rikkaapps/shizuku/blob/master/manager/src/main/java/moe/shizuku/manager/management/ApplicationManagementActivity.kt"
click node_manager_settings "https://github.com/rikkaapps/shizuku/blob/master/manager/src/main/java/moe/shizuku/manager/settings/SettingsFragment.kt"
click node_starter_activity "https://github.com/rikkaapps/shizuku/blob/master/manager/src/main/java/moe/shizuku/manager/starter/StarterActivity.kt"
click node_starter "https://github.com/rikkaapps/shizuku/blob/master/starter/src/main/java/moe/shizuku/starter/ServiceStarter.java"
click node_server "https://github.com/rikkaapps/shizuku/blob/master/server/src/main/java/rikka/shizuku/server/ShizukuService.java"
click node_config "https://github.com/rikkaapps/shizuku/blob/master/server/src/main/java/rikka/shizuku/server/ShizukuConfigManager.java"
click node_clients "https://github.com/rikkaapps/shizuku/blob/master/server/src/main/java/rikka/shizuku/server/ShizukuClientManager.java"
click node_user_services "https://github.com/rikkaapps/shizuku/blob/master/server/src/main/java/rikka/shizuku/server/ShizukuUserServiceManager.java"
click node_apk_observers "https://github.com/rikkaapps/shizuku/blob/master/server/src/main/java/rikka/shizuku/server/ApkChangedObservers.kt"
click node_shell_loader "https://github.com/rikkaapps/shizuku/blob/master/shell/src/main/java/rikka/shizuku/shell/ShizukuShellLoader.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_manager_ui,node_settings,node_adb_pair,node_pair_client,node_authorization,node_app_management,node_manager_settings,node_user,node_client_app toneBlue
class node_starter_activity,node_starter toneAmber
class node_server,node_config,node_clients,node_user_services,node_apk_observers,node_system_server toneMint
class node_client_api,node_shell_loader toneRose
```

## Components

### Manager app

- [Manager UI](https://github.com/rikkaapps/shizuku/blob/master/manager/src/main/java/moe/shizuku/manager/home/HomeActivity.kt): `manager/src/main/java/moe/shizuku/manager/home/HomeActivity.kt`
- [Preferences](https://github.com/rikkaapps/shizuku/blob/master/manager/src/main/java/moe/shizuku/manager/ShizukuSettings.java): `manager/src/main/java/moe/shizuku/manager/ShizukuSettings.java`
- [Wireless ADB pairing](https://github.com/rikkaapps/shizuku/blob/master/manager/src/main/java/moe/shizuku/manager/adb/AdbPairingService.kt): `manager/src/main/java/moe/shizuku/manager/adb/AdbPairingService.kt`
- [Pairing protocol](https://github.com/rikkaapps/shizuku/blob/master/manager/src/main/java/moe/shizuku/manager/adb/AdbPairingClient.kt): `manager/src/main/java/moe/shizuku/manager/adb/AdbPairingClient.kt`
- [Permission management](https://github.com/rikkaapps/shizuku/blob/master/manager/src/main/java/moe/shizuku/manager/authorization/AuthorizationManager.kt): `manager/src/main/java/moe/shizuku/manager/authorization/AuthorizationManager.kt`
- [App management](https://github.com/rikkaapps/shizuku/blob/master/manager/src/main/java/moe/shizuku/manager/management/ApplicationManagementActivity.kt): `manager/src/main/java/moe/shizuku/manager/management/ApplicationManagementActivity.kt`
- [Settings screen](https://github.com/rikkaapps/shizuku/blob/master/manager/src/main/java/moe/shizuku/manager/settings/SettingsFragment.kt): `manager/src/main/java/moe/shizuku/manager/settings/SettingsFragment.kt`

### Server startup

- [Startup flow](https://github.com/rikkaapps/shizuku/blob/master/manager/src/main/java/moe/shizuku/manager/starter/StarterActivity.kt): `manager/src/main/java/moe/shizuku/manager/starter/StarterActivity.kt`
- [Process launcher](https://github.com/rikkaapps/shizuku/blob/master/starter/src/main/java/moe/shizuku/starter/ServiceStarter.java): `starter/src/main/java/moe/shizuku/starter/ServiceStarter.java`

### Privileged server

- [Shizuku service](https://github.com/rikkaapps/shizuku/blob/master/server/src/main/java/rikka/shizuku/server/ShizukuService.java): `server/src/main/java/rikka/shizuku/server/ShizukuService.java`
- [Permission config](https://github.com/rikkaapps/shizuku/blob/master/server/src/main/java/rikka/shizuku/server/ShizukuConfigManager.java): `server/src/main/java/rikka/shizuku/server/ShizukuConfigManager.java`
- [Client tracking](https://github.com/rikkaapps/shizuku/blob/master/server/src/main/java/rikka/shizuku/server/ShizukuClientManager.java): `server/src/main/java/rikka/shizuku/server/ShizukuClientManager.java`
- [User services](https://github.com/rikkaapps/shizuku/blob/master/server/src/main/java/rikka/shizuku/server/ShizukuUserServiceManager.java): `server/src/main/java/rikka/shizuku/server/ShizukuUserServiceManager.java`
- [APK change observers](https://github.com/rikkaapps/shizuku/blob/master/server/src/main/java/rikka/shizuku/server/ApkChangedObservers.kt): `server/src/main/java/rikka/shizuku/server/ApkChangedObservers.kt`

### App integration

- **Shizuku client API**
- [Shell loader](https://github.com/rikkaapps/shizuku/blob/master/shell/src/main/java/rikka/shizuku/shell/ShizukuShellLoader.java): `shell/src/main/java/rikka/shizuku/shell/ShizukuShellLoader.java`

### Other components

- **Device user**
- **Android system server**
- **Client app**

## Connections

- Device user → Manager UI: uses
- Manager UI → Wireless ADB pairing: starts pairing
- Wireless ADB pairing → Pairing protocol: runs protocol (evidence: `manager/src/main/java/moe/shizuku/manager/adb/AdbPairingService.kt`)
- Manager UI → Startup flow: starts server
- Startup flow → Process launcher: launches process (evidence: `manager/src/main/java/moe/shizuku/manager/starter/StarterActivity.kt`)
- Process launcher → Shizuku service: starts user service (evidence: `server/src/main/java/rikka/shizuku/server/ShizukuUserServiceManager.java`)
- Shizuku service → Client app: sends Binder (evidence: `README.md`)
- Client app → Shizuku client API: uses API (evidence: `README.md`)
- Shizuku client API → Shizuku service: transacts requests (evidence: `README.md`)
- Shizuku service → Android system server: forwards IPC (evidence: `README.md`)
- Android system server → Shizuku service: returns results (evidence: `README.md`)
- Shizuku service → Permission config: manages permissions (evidence: `server/src/main/java/rikka/shizuku/server/ShizukuService.java`)
- Shizuku service → Client tracking: tracks clients (evidence: `server/src/main/java/rikka/shizuku/server/ShizukuService.java`)
- Shizuku service → User services: manages services (evidence: `server/src/main/java/rikka/shizuku/server/ShizukuService.java`)
- User services → APK change observers: monitors packages (evidence: `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 (evidence: `manager/src/main/java/moe/shizuku/manager/settings/SettingsFragment.kt`)
- Client app → Shell loader: loads shell
