# revanced/revanced-manager architecture

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

- Interactive diagram: https://gitdiagram.com/revanced/revanced-manager
- Repository: https://github.com/revanced/revanced-manager

## Overview

ReVanced Manager is an Android app for downloading Android apps, selecting patch bundles and patches, applying patches, and managing installed results and settings. The main workflow is user navigation through the Manager UI, obtaining an app and patch bundle, configuring patch selection, running the patcher, then signing or installing and recording the result. The README confirms download, patch, and customization capabilities; sampled source supports several repository and runtime relationships, while unsampled screens and integrations are represented conservatively.

Main entry points: [`app/src/main/java/app/revanced/manager/patcher/worker/PatcherWorker.kt`](https://github.com/revanced/revanced-manager/blob/main/app/src/main/java/app/revanced/manager/patcher/worker/PatcherWorker.kt) (Patcher worker), [`app/src/main/java/app/revanced/manager/domain/manager/SourceManager.kt`](https://github.com/revanced/revanced-manager/blob/main/app/src/main/java/app/revanced/manager/domain/manager/SourceManager.kt) (Source manager), [`app/src/main/java/app/revanced/manager/MainActivity.kt`](https://github.com/revanced/revanced-manager/blob/main/app/src/main/java/app/revanced/manager/MainActivity.kt) (App navigation), [`app/src/main/java/app/revanced/manager/domain/repository/PatchBundleRepository.kt`](https://github.com/revanced/revanced-manager/blob/main/app/src/main/java/app/revanced/manager/domain/repository/PatchBundleRepository.kt) (Patch bundles)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Manager UI"]
  node_main["App navigation<br/>[MainActivity.kt]"]
  node_screens["Manager screens"]
end

subgraph group_sources["Sources and downloads"]
  node_source_mgr["Source manager<br/>[SourceManager.kt]"]
  node_bundle_repo["Patch bundles"]
  node_downloader_repo["Downloader registry"]
  node_downloader_api["Downloader API<br/>[Downloader.kt]"]
  node_downloaded_repo["App downloads"]
end

subgraph group_patching["Patching and install"]
  node_patch_bundle["Patcher bundle<br/>[PatchBundle.kt]"]
  node_patch_worker["Patcher worker<br/>[PatcherWorker.kt]"]
  node_keystore["APK signing<br/>[KeystoreManager.kt]"]
  node_installed_repo["Installed apps"]
  node_filesystem["Filesystem<br/>[Filesystem.kt]"]
end

subgraph group_state["Persistence and settings"]
  node_appdb[("App database<br/>[AppDatabase.kt]")]
  node_prefs["Preferences"]
  node_source_entity["Source records<br/>[Source.kt]"]
  node_patch_selection["Patch selection<br/>[PatchSelection.kt]"]
end

subgraph group_network["Network services"]
  node_http["HTTP service<br/>[HttpService.kt]"]
end

node_user(("User"))
node_remote{{"Remote services"}}

node_user -->|"uses"| node_main
node_main -->|"navigates"| node_screens
node_main -->|"reads theme"| node_prefs
node_source_mgr -->|"loads records"| node_source_entity
node_source_mgr -->|"reads sources"| node_appdb
node_bundle_repo -->|"loads bundle"| node_patch_bundle
node_bundle_repo -->|"extends"| node_source_mgr
node_downloader_repo -->|"loads downloader"| node_downloader_api
node_downloaded_repo -->|"invokes download"| node_downloader_api
node_downloaded_repo -->|"records downloads"| node_appdb
node_downloader_api -.->|"downloads apps"| node_remote
node_patch_worker -->|"gets app input"| node_downloaded_repo
node_patch_worker -.->|"uses patch bundles"| node_bundle_repo
node_patch_worker -.->|"runs patches"| node_patch_bundle
node_patch_worker -->|"signs output"| node_keystore
node_patch_worker -->|"records installed app"| node_installed_repo
node_patch_worker -->|"uses files"| node_filesystem
node_patch_worker -->|"reads settings"| node_prefs
node_appdb -->|"stores selection"| node_patch_selection
node_http -->|"sends requests"| node_remote
node_source_mgr -.->|"updates sources"| node_http

click node_main "https://github.com/revanced/revanced-manager/blob/main/app/src/main/java/app/revanced/manager/MainActivity.kt"
click node_screens "https://github.com/revanced/revanced-manager/tree/main/app/src/main/java/app/revanced/manager/ui/screen"
click node_appdb "https://github.com/revanced/revanced-manager/blob/main/app/src/main/java/app/revanced/manager/data/room/AppDatabase.kt"
click node_prefs "https://github.com/revanced/revanced-manager/blob/main/app/src/main/java/app/revanced/manager/domain/manager/PreferencesManager.kt"
click node_source_mgr "https://github.com/revanced/revanced-manager/blob/main/app/src/main/java/app/revanced/manager/domain/manager/SourceManager.kt"
click node_bundle_repo "https://github.com/revanced/revanced-manager/blob/main/app/src/main/java/app/revanced/manager/domain/repository/PatchBundleRepository.kt"
click node_downloader_repo "https://github.com/revanced/revanced-manager/blob/main/app/src/main/java/app/revanced/manager/domain/repository/DownloaderRepository.kt"
click node_downloader_api "https://github.com/revanced/revanced-manager/blob/main/api/src/main/kotlin/app/revanced/manager/downloader/Downloader.kt"
click node_downloaded_repo "https://github.com/revanced/revanced-manager/blob/main/app/src/main/java/app/revanced/manager/domain/repository/DownloadedAppRepository.kt"
click node_source_entity "https://github.com/revanced/revanced-manager/blob/main/app/src/main/java/app/revanced/manager/data/room/sources/Source.kt"
click node_patch_selection "https://github.com/revanced/revanced-manager/blob/main/app/src/main/java/app/revanced/manager/data/room/selection/PatchSelection.kt"
click node_patch_bundle "https://github.com/revanced/revanced-manager/blob/main/app/src/main/java/app/revanced/manager/patcher/patch/PatchBundle.kt"
click node_patch_worker "https://github.com/revanced/revanced-manager/blob/main/app/src/main/java/app/revanced/manager/patcher/worker/PatcherWorker.kt"
click node_keystore "https://github.com/revanced/revanced-manager/blob/main/app/src/main/java/app/revanced/manager/domain/manager/KeystoreManager.kt"
click node_installed_repo "https://github.com/revanced/revanced-manager/blob/main/app/src/main/java/app/revanced/manager/domain/repository/InstalledAppRepository.kt"
click node_filesystem "https://github.com/revanced/revanced-manager/blob/main/app/src/main/java/app/revanced/manager/data/platform/Filesystem.kt"
click node_http "https://github.com/revanced/revanced-manager/blob/main/app/src/main/java/app/revanced/manager/network/service/HttpService.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_main,node_screens,node_user toneBlue
class node_source_mgr,node_bundle_repo,node_downloader_repo,node_downloader_api,node_downloaded_repo toneAmber
class node_patch_bundle,node_patch_worker,node_keystore,node_installed_repo,node_filesystem toneMint
class node_appdb,node_prefs,node_source_entity,node_patch_selection toneRose
class node_http,node_remote toneIndigo
```

## Components

### Manager UI

- [App navigation](https://github.com/revanced/revanced-manager/blob/main/app/src/main/java/app/revanced/manager/MainActivity.kt): `app/src/main/java/app/revanced/manager/MainActivity.kt`
- [Manager screens](https://github.com/revanced/revanced-manager/tree/main/app/src/main/java/app/revanced/manager/ui/screen): `app/src/main/java/app/revanced/manager/ui/screen`

### Sources and downloads

- [Source manager](https://github.com/revanced/revanced-manager/blob/main/app/src/main/java/app/revanced/manager/domain/manager/SourceManager.kt): `app/src/main/java/app/revanced/manager/domain/manager/SourceManager.kt`
- [Patch bundles](https://github.com/revanced/revanced-manager/blob/main/app/src/main/java/app/revanced/manager/domain/repository/PatchBundleRepository.kt): `app/src/main/java/app/revanced/manager/domain/repository/PatchBundleRepository.kt`
- [Downloader registry](https://github.com/revanced/revanced-manager/blob/main/app/src/main/java/app/revanced/manager/domain/repository/DownloaderRepository.kt): `app/src/main/java/app/revanced/manager/domain/repository/DownloaderRepository.kt`
- [Downloader API](https://github.com/revanced/revanced-manager/blob/main/api/src/main/kotlin/app/revanced/manager/downloader/Downloader.kt): `api/src/main/kotlin/app/revanced/manager/downloader/Downloader.kt`
- [App downloads](https://github.com/revanced/revanced-manager/blob/main/app/src/main/java/app/revanced/manager/domain/repository/DownloadedAppRepository.kt): `app/src/main/java/app/revanced/manager/domain/repository/DownloadedAppRepository.kt`

### Patching and install

- [Patcher bundle](https://github.com/revanced/revanced-manager/blob/main/app/src/main/java/app/revanced/manager/patcher/patch/PatchBundle.kt): `app/src/main/java/app/revanced/manager/patcher/patch/PatchBundle.kt`
- [Patcher worker](https://github.com/revanced/revanced-manager/blob/main/app/src/main/java/app/revanced/manager/patcher/worker/PatcherWorker.kt): `app/src/main/java/app/revanced/manager/patcher/worker/PatcherWorker.kt`
- [APK signing](https://github.com/revanced/revanced-manager/blob/main/app/src/main/java/app/revanced/manager/domain/manager/KeystoreManager.kt): `app/src/main/java/app/revanced/manager/domain/manager/KeystoreManager.kt`
- [Installed apps](https://github.com/revanced/revanced-manager/blob/main/app/src/main/java/app/revanced/manager/domain/repository/InstalledAppRepository.kt): `app/src/main/java/app/revanced/manager/domain/repository/InstalledAppRepository.kt`
- [Filesystem](https://github.com/revanced/revanced-manager/blob/main/app/src/main/java/app/revanced/manager/data/platform/Filesystem.kt): `app/src/main/java/app/revanced/manager/data/platform/Filesystem.kt`

### Persistence and settings

- [App database](https://github.com/revanced/revanced-manager/blob/main/app/src/main/java/app/revanced/manager/data/room/AppDatabase.kt): `app/src/main/java/app/revanced/manager/data/room/AppDatabase.kt`
- [Preferences](https://github.com/revanced/revanced-manager/blob/main/app/src/main/java/app/revanced/manager/domain/manager/PreferencesManager.kt): `app/src/main/java/app/revanced/manager/domain/manager/PreferencesManager.kt`
- [Source records](https://github.com/revanced/revanced-manager/blob/main/app/src/main/java/app/revanced/manager/data/room/sources/Source.kt): `app/src/main/java/app/revanced/manager/data/room/sources/Source.kt`
- [Patch selection](https://github.com/revanced/revanced-manager/blob/main/app/src/main/java/app/revanced/manager/data/room/selection/PatchSelection.kt): `app/src/main/java/app/revanced/manager/data/room/selection/PatchSelection.kt`

### Network services

- [HTTP service](https://github.com/revanced/revanced-manager/blob/main/app/src/main/java/app/revanced/manager/network/service/HttpService.kt): `app/src/main/java/app/revanced/manager/network/service/HttpService.kt`

### Other components

- **User**
- **Remote services**

## Connections

- User → App navigation: uses (evidence: `README.md`)
- App navigation → Manager screens: navigates (evidence: `app/src/main/java/app/revanced/manager/MainActivity.kt`)
- App navigation → Preferences: reads theme (evidence: `app/src/main/java/app/revanced/manager/MainActivity.kt`)
- Source manager → Source records: loads records (evidence: `app/src/main/java/app/revanced/manager/domain/manager/SourceManager.kt`)
- Source manager → App database: reads sources (evidence: `app/src/main/java/app/revanced/manager/domain/manager/SourceManager.kt`)
- Patch bundles → Patcher bundle: loads bundle (evidence: `app/src/main/java/app/revanced/manager/domain/repository/PatchBundleRepository.kt`)
- Patch bundles → Source manager: extends (evidence: `app/src/main/java/app/revanced/manager/domain/repository/PatchBundleRepository.kt`)
- Downloader registry → Downloader API: loads downloader (evidence: `app/src/main/java/app/revanced/manager/domain/repository/DownloaderRepository.kt`)
- App downloads → Downloader API: invokes download (evidence: `app/src/main/java/app/revanced/manager/domain/repository/DownloadedAppRepository.kt`)
- App downloads → App database: records downloads (evidence: `app/src/main/java/app/revanced/manager/domain/repository/DownloadedAppRepository.kt`)
- Downloader API → Remote services: downloads apps (evidence: `README.md`)
- Patcher worker → App downloads: gets app input (evidence: `app/src/main/java/app/revanced/manager/patcher/worker/PatcherWorker.kt`)
- Patcher worker → Patch bundles: uses patch bundles
- Patcher worker → Patcher bundle: runs patches
- Patcher worker → APK signing: signs output (evidence: `app/src/main/java/app/revanced/manager/patcher/worker/PatcherWorker.kt`)
- Patcher worker → Installed apps: records installed app (evidence: `app/src/main/java/app/revanced/manager/patcher/worker/PatcherWorker.kt`)
- Patcher worker → Filesystem: uses files (evidence: `app/src/main/java/app/revanced/manager/patcher/worker/PatcherWorker.kt`)
- Patcher worker → Preferences: reads settings (evidence: `app/src/main/java/app/revanced/manager/patcher/worker/PatcherWorker.kt`)
- App database → Patch selection: stores selection (evidence: `app/src/main/java/app/revanced/manager/data/room/AppDatabase.kt`)
- HTTP service → Remote services: sends requests (evidence: `app/src/main/java/app/revanced/manager/network/service/HttpService.kt`)
- Source manager → HTTP service: updates sources
