# r15hi/dsu-multi-sideloader architecture

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

- Interactive diagram: https://gitdiagram.com/r15hi/dsu-multi-sideloader
- Repository: https://github.com/r15hi/dsu-multi-sideloader

## Overview

DSU Multi-Sideloader is an Android app for preparing and installing GSIs through Android Dynamic System Updates, with ADB, Shizuku, root, and system operation modes. Users choose a GSI and installation settings, prepare its files, invoke an installer, then boot or manage the DSU. The app also provides a Multi-DSU manager for viewing, restoring, booting, and auto-stashing installations. Connections reflect README statements and source-index references; unsampled implementation details are not asserted.

Main entry points: [`app/src/main/java/vegabobo/dsusideloader/preparation/Preparation.kt`](https://github.com/r15hi/dsu-multi-sideloader/blob/master/app/src/main/java/vegabobo/dsusideloader/preparation/Preparation.kt) (Image preparation), [`app/src/main/java/vegabobo/dsusideloader/MainActivity.kt`](https://github.com/r15hi/dsu-multi-sideloader/blob/master/app/src/main/java/vegabobo/dsusideloader/MainActivity.kt) (App entry), [`app/src/main/java/vegabobo/dsusideloader/installer/adb/AdbInstallationHandler.kt`](https://github.com/r15hi/dsu-multi-sideloader/blob/master/app/src/main/java/vegabobo/dsusideloader/installer/adb/AdbInstallationHandler.kt) (ADB installer), [`app/src/main/java/vegabobo/dsusideloader/model/Session.kt`](https://github.com/r15hi/dsu-multi-sideloader/blob/master/app/src/main/java/vegabobo/dsusideloader/model/Session.kt) (Install session)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App and state"]
  node_activity["App entry<br/>[MainActivity.kt]"]
  node_navigation["Navigation<br/>[Navigation.kt]"]
  node_home["Install screen<br/>[HomeViewModel.kt]"]
  node_session["Install session<br/>[Session.kt]"]
  node_source["Image source"]
  node_prefs["App preferences<br/>[AppPrefs.kt]"]
end

subgraph group_prep["Image preparation"]
  node_storage["Workspace storage<br/>[StorageManager.kt]"]
  node_preparation["Image preparation<br/>[Preparation.kt]"]
  node_steps["Preparation steps"]
  node_unpacker["Archive unpacker<br/>[FileUnPacker.kt]"]
end

subgraph group_install["DSU installation"]
  node_adb["ADB installer"]
  node_script["ADB script"]
  node_privinstaller["Privileged installer"]
  node_rootinstaller["Root installer<br/>[DSUInstaller.kt]"]
  node_dynamicimpl["Dynamic System API"]
end

subgraph group_manage["DSU management"]
  node_multidsu["Multi-DSU manager<br/>[MultiDsuManager.kt]"]
  node_multiscreen["Multi-DSU screen<br/>[MultiDsuScreen.kt]"]
  node_tiles["DSU quick actions"]
end

subgraph group_priv["Privileged access"]
  node_provider["Privileged provider"]
  node_connection["Binder connection<br/>[Connection.kt]"]
  node_service["Privileged service"]
end

node_user(("App user"))
node_androiddsu{{"Android DSU services"}}

node_user -->|"opens"| node_activity
node_activity -->|"hosts"| node_navigation
node_activity -->|"creates"| node_session
node_activity -->|"loads"| node_prefs
node_navigation -->|"routes to"| node_multiscreen
node_user -.->|"selects image"| node_home
node_home -.->|"starts preparation"| node_preparation
node_preparation -->|"uses workspace"| node_storage
node_preparation -->|"reads source"| node_source
node_preparation -->|"reads settings"| node_session
node_preparation -->|"updates steps"| node_steps
node_preparation -->|"uses unpacker"| node_unpacker
node_adb -->|"reads session"| node_session
node_adb -->|"uses workspace"| node_storage
node_adb -->|"generates script"| node_script
node_user -.->|"runs command"| node_adb
node_privinstaller -->|"reads session"| node_session
node_privinstaller -->|"uses provider"| node_provider
node_rootinstaller -.->|"delegates"| node_dynamicimpl
node_dynamicimpl -.->|"uses API"| node_androiddsu
node_multiscreen -.->|"manages installations"| node_multidsu
node_multidsu -.->|"manages DSU state"| node_androiddsu
node_user -.->|"manages DSUs"| node_multiscreen
node_tiles -.->|"boots DSU"| node_androiddsu
node_provider -->|"uses connection"| node_connection
node_connection -.->|"binds service"| node_service
node_service -.->|"calls system APIs"| node_androiddsu

click node_activity "https://github.com/r15hi/dsu-multi-sideloader/blob/master/app/src/main/java/vegabobo/dsusideloader/MainActivity.kt"
click node_navigation "https://github.com/r15hi/dsu-multi-sideloader/blob/master/app/src/main/java/vegabobo/dsusideloader/ui/screen/Navigation.kt"
click node_home "https://github.com/r15hi/dsu-multi-sideloader/blob/master/app/src/main/java/vegabobo/dsusideloader/ui/screen/home/HomeViewModel.kt"
click node_session "https://github.com/r15hi/dsu-multi-sideloader/blob/master/app/src/main/java/vegabobo/dsusideloader/model/Session.kt"
click node_source "https://github.com/r15hi/dsu-multi-sideloader/blob/master/app/src/main/java/vegabobo/dsusideloader/model/DSUInstallationSource.kt"
click node_prefs "https://github.com/r15hi/dsu-multi-sideloader/blob/master/app/src/main/java/vegabobo/dsusideloader/preferences/AppPrefs.kt"
click node_storage "https://github.com/r15hi/dsu-multi-sideloader/blob/master/app/src/main/java/vegabobo/dsusideloader/core/StorageManager.kt"
click node_preparation "https://github.com/r15hi/dsu-multi-sideloader/blob/master/app/src/main/java/vegabobo/dsusideloader/preparation/Preparation.kt"
click node_steps "https://github.com/r15hi/dsu-multi-sideloader/blob/master/app/src/main/java/vegabobo/dsusideloader/preparation/InstallationStep.kt"
click node_unpacker "https://github.com/r15hi/dsu-multi-sideloader/blob/master/app/src/main/java/vegabobo/dsusideloader/preparation/FileUnPacker.kt"
click node_adb "https://github.com/r15hi/dsu-multi-sideloader/blob/master/app/src/main/java/vegabobo/dsusideloader/installer/adb/AdbInstallationHandler.kt"
click node_script "https://github.com/r15hi/dsu-multi-sideloader/blob/master/app/src/main/java/vegabobo/dsusideloader/installer/adb/GenerateInstallationScript.kt"
click node_privinstaller "https://github.com/r15hi/dsu-multi-sideloader/blob/master/app/src/main/java/vegabobo/dsusideloader/installer/privileged/DsuInstallationHandler.kt"
click node_rootinstaller "https://github.com/r15hi/dsu-multi-sideloader/blob/master/app/src/main/java/vegabobo/dsusideloader/installer/root/DSUInstaller.kt"
click node_dynamicimpl "https://github.com/r15hi/dsu-multi-sideloader/blob/master/app/src/main/java/vegabobo/dsusideloader/installer/root/DynamicSystemImpl.kt"
click node_multidsu "https://github.com/r15hi/dsu-multi-sideloader/blob/master/app/src/main/java/vegabobo/dsusideloader/installer/multidsu/MultiDsuManager.kt"
click node_multiscreen "https://github.com/r15hi/dsu-multi-sideloader/blob/master/app/src/main/java/vegabobo/dsusideloader/ui/screen/multidsu/MultiDsuScreen.kt"
click node_tiles "https://github.com/r15hi/dsu-multi-sideloader/blob/master/app/src/main/java/vegabobo/dsusideloader/service/RebootDsuTileService.kt"
click node_provider "https://github.com/r15hi/dsu-multi-sideloader/blob/master/app/src/main/java/vegabobo/dsusideloader/service/PrivilegedProvider.kt"
click node_connection "https://github.com/r15hi/dsu-multi-sideloader/blob/master/app/src/main/java/vegabobo/dsusideloader/service/Connection.kt"
click node_service "https://github.com/r15hi/dsu-multi-sideloader/blob/master/app/src/main/java/vegabobo/dsusideloader/service/PrivilegedService.kt"

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_activity,node_navigation,node_home,node_session,node_source,node_prefs,node_user toneBlue
class node_storage,node_preparation,node_steps,node_unpacker toneAmber
class node_adb,node_script,node_privinstaller,node_rootinstaller,node_dynamicimpl toneMint
class node_multidsu,node_multiscreen,node_tiles toneRose
class node_provider,node_connection,node_service,node_androiddsu toneIndigo
```

## Components

### App and state

- [App entry](https://github.com/r15hi/dsu-multi-sideloader/blob/master/app/src/main/java/vegabobo/dsusideloader/MainActivity.kt): `app/src/main/java/vegabobo/dsusideloader/MainActivity.kt`
- [Navigation](https://github.com/r15hi/dsu-multi-sideloader/blob/master/app/src/main/java/vegabobo/dsusideloader/ui/screen/Navigation.kt): `app/src/main/java/vegabobo/dsusideloader/ui/screen/Navigation.kt`
- [Install screen](https://github.com/r15hi/dsu-multi-sideloader/blob/master/app/src/main/java/vegabobo/dsusideloader/ui/screen/home/HomeViewModel.kt): `app/src/main/java/vegabobo/dsusideloader/ui/screen/home/HomeViewModel.kt`
- [Install session](https://github.com/r15hi/dsu-multi-sideloader/blob/master/app/src/main/java/vegabobo/dsusideloader/model/Session.kt): `app/src/main/java/vegabobo/dsusideloader/model/Session.kt`
- [Image source](https://github.com/r15hi/dsu-multi-sideloader/blob/master/app/src/main/java/vegabobo/dsusideloader/model/DSUInstallationSource.kt): `app/src/main/java/vegabobo/dsusideloader/model/DSUInstallationSource.kt`
- [App preferences](https://github.com/r15hi/dsu-multi-sideloader/blob/master/app/src/main/java/vegabobo/dsusideloader/preferences/AppPrefs.kt): `app/src/main/java/vegabobo/dsusideloader/preferences/AppPrefs.kt`

### Image preparation

- [Workspace storage](https://github.com/r15hi/dsu-multi-sideloader/blob/master/app/src/main/java/vegabobo/dsusideloader/core/StorageManager.kt): `app/src/main/java/vegabobo/dsusideloader/core/StorageManager.kt`
- [Image preparation](https://github.com/r15hi/dsu-multi-sideloader/blob/master/app/src/main/java/vegabobo/dsusideloader/preparation/Preparation.kt): `app/src/main/java/vegabobo/dsusideloader/preparation/Preparation.kt`
- [Preparation steps](https://github.com/r15hi/dsu-multi-sideloader/blob/master/app/src/main/java/vegabobo/dsusideloader/preparation/InstallationStep.kt): `app/src/main/java/vegabobo/dsusideloader/preparation/InstallationStep.kt`
- [Archive unpacker](https://github.com/r15hi/dsu-multi-sideloader/blob/master/app/src/main/java/vegabobo/dsusideloader/preparation/FileUnPacker.kt): `app/src/main/java/vegabobo/dsusideloader/preparation/FileUnPacker.kt`

### DSU installation

- [ADB installer](https://github.com/r15hi/dsu-multi-sideloader/blob/master/app/src/main/java/vegabobo/dsusideloader/installer/adb/AdbInstallationHandler.kt): `app/src/main/java/vegabobo/dsusideloader/installer/adb/AdbInstallationHandler.kt`
- [ADB script](https://github.com/r15hi/dsu-multi-sideloader/blob/master/app/src/main/java/vegabobo/dsusideloader/installer/adb/GenerateInstallationScript.kt): `app/src/main/java/vegabobo/dsusideloader/installer/adb/GenerateInstallationScript.kt`
- [Privileged installer](https://github.com/r15hi/dsu-multi-sideloader/blob/master/app/src/main/java/vegabobo/dsusideloader/installer/privileged/DsuInstallationHandler.kt): `app/src/main/java/vegabobo/dsusideloader/installer/privileged/DsuInstallationHandler.kt`
- [Root installer](https://github.com/r15hi/dsu-multi-sideloader/blob/master/app/src/main/java/vegabobo/dsusideloader/installer/root/DSUInstaller.kt): `app/src/main/java/vegabobo/dsusideloader/installer/root/DSUInstaller.kt`
- [Dynamic System API](https://github.com/r15hi/dsu-multi-sideloader/blob/master/app/src/main/java/vegabobo/dsusideloader/installer/root/DynamicSystemImpl.kt): `app/src/main/java/vegabobo/dsusideloader/installer/root/DynamicSystemImpl.kt`

### DSU management

- [Multi-DSU manager](https://github.com/r15hi/dsu-multi-sideloader/blob/master/app/src/main/java/vegabobo/dsusideloader/installer/multidsu/MultiDsuManager.kt): `app/src/main/java/vegabobo/dsusideloader/installer/multidsu/MultiDsuManager.kt`
- [Multi-DSU screen](https://github.com/r15hi/dsu-multi-sideloader/blob/master/app/src/main/java/vegabobo/dsusideloader/ui/screen/multidsu/MultiDsuScreen.kt): `app/src/main/java/vegabobo/dsusideloader/ui/screen/multidsu/MultiDsuScreen.kt`
- [DSU quick actions](https://github.com/r15hi/dsu-multi-sideloader/blob/master/app/src/main/java/vegabobo/dsusideloader/service/RebootDsuTileService.kt): `app/src/main/java/vegabobo/dsusideloader/service/RebootDsuTileService.kt`

### Privileged access

- [Privileged provider](https://github.com/r15hi/dsu-multi-sideloader/blob/master/app/src/main/java/vegabobo/dsusideloader/service/PrivilegedProvider.kt): `app/src/main/java/vegabobo/dsusideloader/service/PrivilegedProvider.kt`
- [Binder connection](https://github.com/r15hi/dsu-multi-sideloader/blob/master/app/src/main/java/vegabobo/dsusideloader/service/Connection.kt): `app/src/main/java/vegabobo/dsusideloader/service/Connection.kt`
- [Privileged service](https://github.com/r15hi/dsu-multi-sideloader/blob/master/app/src/main/java/vegabobo/dsusideloader/service/PrivilegedService.kt): `app/src/main/java/vegabobo/dsusideloader/service/PrivilegedService.kt`

### Other components

- **App user**
- **Android DSU services**

## Connections

- App user → App entry: opens (evidence: `app/src/main/java/vegabobo/dsusideloader/MainActivity.kt`)
- App entry → Navigation: hosts (evidence: `app/src/main/java/vegabobo/dsusideloader/MainActivity.kt`)
- App entry → Install session: creates (evidence: `app/src/main/java/vegabobo/dsusideloader/MainActivity.kt`)
- App entry → App preferences: loads (evidence: `app/src/main/java/vegabobo/dsusideloader/MainActivity.kt`)
- Navigation → Multi-DSU screen: routes to (evidence: `app/src/main/java/vegabobo/dsusideloader/ui/screen/Navigation.kt`)
- App user → Install screen: selects image (evidence: `README.md`)
- Install screen → Image preparation: starts preparation (evidence: `README.md`)
- Image preparation → Workspace storage: uses workspace (evidence: `app/src/main/java/vegabobo/dsusideloader/preparation/Preparation.kt`)
- Image preparation → Image source: reads source (evidence: `app/src/main/java/vegabobo/dsusideloader/preparation/Preparation.kt`)
- Image preparation → Install session: reads settings (evidence: `app/src/main/java/vegabobo/dsusideloader/preparation/Preparation.kt`)
- Image preparation → Preparation steps: updates steps (evidence: `app/src/main/java/vegabobo/dsusideloader/preparation/Preparation.kt`)
- Image preparation → Archive unpacker: uses unpacker (evidence: `app/src/main/java/vegabobo/dsusideloader/preparation/Preparation.kt`)
- ADB installer → Install session: reads session (evidence: `app/src/main/java/vegabobo/dsusideloader/installer/adb/AdbInstallationHandler.kt`)
- ADB installer → Workspace storage: uses workspace (evidence: `app/src/main/java/vegabobo/dsusideloader/installer/adb/AdbInstallationHandler.kt`)
- ADB installer → ADB script: generates script (evidence: `app/src/main/java/vegabobo/dsusideloader/installer/adb/AdbInstallationHandler.kt`)
- App user → ADB installer: runs command (evidence: `README.md`)
- Privileged installer → Install session: reads session (evidence: `app/src/main/java/vegabobo/dsusideloader/installer/privileged/DsuInstallationHandler.kt`)
- Privileged installer → Privileged provider: uses provider (evidence: `app/src/main/java/vegabobo/dsusideloader/installer/privileged/DsuInstallationHandler.kt`)
- Root installer → Dynamic System API: delegates (evidence: `app/src/main/java/vegabobo/dsusideloader/installer/root/DSUInstaller.kt`)
- Dynamic System API → Android DSU services: uses API
- Multi-DSU screen → Multi-DSU manager: manages installations (evidence: `README.md`)
- Multi-DSU manager → Android DSU services: manages DSU state (evidence: `README.md`)
- App user → Multi-DSU screen: manages DSUs (evidence: `README.md`)
- DSU quick actions → Android DSU services: boots DSU (evidence: `README.md`)
- Privileged provider → Binder connection: uses connection (evidence: `app/src/main/java/vegabobo/dsusideloader/service/PrivilegedProvider.kt`)
- Binder connection → Privileged service: binds service
- Privileged service → Android DSU services: calls system APIs
