# iocd/tachiyomij2k architecture

> Architecture diagram of the GitHub repository iocd/tachiyomij2k, 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/iocd/tachiyomij2k
- Repository: https://github.com/iocd/tachiyomij2k

## Overview

This repository is an Android manga-reading app fork, and its README says it is a fork of TachiyomiJ2K without active development. The main user journey is to browse or search catalogue sources, open manga details, then read chapters; the tree also shows library maintenance, downloads, extension management, tracking, and backup capabilities. Sampled source supports several connections below, but many subsystems were not sampled, so their links are marked unverified rather than inferred as calls.

Main entry points: [`app/src/main/java/eu/kanade/tachiyomi/data/database/DatabaseHelper.kt`](https://github.com/iocd/tachiyomij2k/blob/manga-color/app/src/main/java/eu/kanade/tachiyomi/data/database/DatabaseHelper.kt) (App database), [`app/src/main/java/eu/kanade/tachiyomi/ui/manga/MangaDetailsController.kt`](https://github.com/iocd/tachiyomij2k/blob/manga-color/app/src/main/java/eu/kanade/tachiyomi/ui/manga/MangaDetailsController.kt) (Manga details), [`app/src/main/java/eu/kanade/tachiyomi/extension/ExtensionManager.kt`](https://github.com/iocd/tachiyomij2k/blob/manga-color/app/src/main/java/eu/kanade/tachiyomi/extension/ExtensionManager.kt) (Extension manager), [`app/src/main/java/eu/kanade/tachiyomi/source/SourceManager.kt`](https://github.com/iocd/tachiyomij2k/blob/manga-color/app/src/main/java/eu/kanade/tachiyomi/source/SourceManager.kt) (Source registry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_discovery["Discovery and reading"]
  node_main["App navigation<br/>[MainActivity.kt]"]
  node_browse["Browse sources"]
  node_browse_results["Browse results"]
  node_global_search["Global search"]
  node_details["Manga details"]
  node_reader["Chapter reader<br/>[ReaderActivity.kt]"]
end

subgraph group_library["Library and persistence"]
  node_library_ui["Library"]
  node_library_job["Library updates"]
  node_downloads["Downloads<br/>[DownloadManager.kt]"]
  node_database[("App database<br/>[DatabaseHelper.kt]")]
  node_manga_model["Manga records<br/>[Manga.kt]"]
  node_recents["Reading recents"]
  node_backup["Backup and restore<br/>[BackupCreator.kt]"]
end

subgraph group_sources["Sources and extensions"]
  node_catalogue["Source catalogue<br/>[CatalogueSource.kt]"]
  node_source_manager["Source registry<br/>[SourceManager.kt]"]
  node_http_source["Online sources<br/>[HttpSource.kt]"]
  node_local_source["Local source<br/>[LocalSource.kt]"]
  node_extensions["Extension manager"]
  node_installer["Extension installer"]
end

subgraph group_services["Supporting services"]
  node_tracking["Reading trackers<br/>[TrackService.kt]"]
  node_preferences[("Preferences")]
  node_network["Network services<br/>[NetworkHelper.kt]"]
end

node_user(("Reader"))

node_user -.->|"opens app"| node_main
node_main -.->|"navigates to"| node_browse
node_browse -.->|"lists sources"| node_source_manager
node_browse_results -.->|"searches catalogue"| node_catalogue
node_global_search -->|"opens manga"| node_details
node_details -->|"uses manga data"| node_database
node_details -->|"uses source registry"| node_source_manager
node_details -.->|"opens reader"| node_reader
node_library_ui -->|"requests updates"| node_library_job
node_library_ui -->|"queues downloads"| node_downloads
node_library_job -.->|"updates records"| node_database
node_recents -.->|"opens chapters"| node_reader
node_backup -.->|"backs up data"| node_database
node_database -->|"maps manga records"| node_manga_model
node_source_manager -->|"resolves sources"| node_extensions
node_extensions -->|"installs extensions"| node_installer
node_extensions -->|"reads preferences"| node_preferences
node_catalogue -->|"extends source API"| node_http_source
node_tracking -->|"stores tracking data"| node_database
node_tracking -->|"uses networking"| node_network

click node_main "https://github.com/iocd/tachiyomij2k/blob/manga-color/app/src/main/java/eu/kanade/tachiyomi/ui/main/MainActivity.kt"
click node_browse "https://github.com/iocd/tachiyomij2k/blob/manga-color/app/src/main/java/eu/kanade/tachiyomi/ui/source/BrowseController.kt"
click node_catalogue "https://github.com/iocd/tachiyomij2k/blob/manga-color/app/src/main/java/eu/kanade/tachiyomi/source/CatalogueSource.kt"
click node_browse_results "https://github.com/iocd/tachiyomij2k/blob/manga-color/app/src/main/java/eu/kanade/tachiyomi/ui/source/browse/BrowseSourceController.kt"
click node_global_search "https://github.com/iocd/tachiyomij2k/blob/manga-color/app/src/main/java/eu/kanade/tachiyomi/ui/source/globalsearch/GlobalSearchController.kt"
click node_details "https://github.com/iocd/tachiyomij2k/blob/manga-color/app/src/main/java/eu/kanade/tachiyomi/ui/manga/MangaDetailsController.kt"
click node_reader "https://github.com/iocd/tachiyomij2k/blob/manga-color/app/src/main/java/eu/kanade/tachiyomi/ui/reader/ReaderActivity.kt"
click node_library_ui "https://github.com/iocd/tachiyomij2k/blob/manga-color/app/src/main/java/eu/kanade/tachiyomi/ui/library/LibraryController.kt"
click node_library_job "https://github.com/iocd/tachiyomij2k/blob/manga-color/app/src/main/java/eu/kanade/tachiyomi/data/library/LibraryUpdateJob.kt"
click node_downloads "https://github.com/iocd/tachiyomij2k/blob/manga-color/app/src/main/java/eu/kanade/tachiyomi/data/download/DownloadManager.kt"
click node_database "https://github.com/iocd/tachiyomij2k/blob/manga-color/app/src/main/java/eu/kanade/tachiyomi/data/database/DatabaseHelper.kt"
click node_manga_model "https://github.com/iocd/tachiyomij2k/blob/manga-color/app/src/main/java/eu/kanade/tachiyomi/data/database/models/Manga.kt"
click node_recents "https://github.com/iocd/tachiyomij2k/blob/manga-color/app/src/main/java/eu/kanade/tachiyomi/ui/recents/RecentsController.kt"
click node_backup "https://github.com/iocd/tachiyomij2k/blob/manga-color/app/src/main/java/eu/kanade/tachiyomi/data/backup/BackupCreator.kt"
click node_source_manager "https://github.com/iocd/tachiyomij2k/blob/manga-color/app/src/main/java/eu/kanade/tachiyomi/source/SourceManager.kt"
click node_http_source "https://github.com/iocd/tachiyomij2k/blob/manga-color/app/src/main/java/eu/kanade/tachiyomi/source/online/HttpSource.kt"
click node_local_source "https://github.com/iocd/tachiyomij2k/blob/manga-color/app/src/main/java/eu/kanade/tachiyomi/source/LocalSource.kt"
click node_extensions "https://github.com/iocd/tachiyomij2k/blob/manga-color/app/src/main/java/eu/kanade/tachiyomi/extension/ExtensionManager.kt"
click node_installer "https://github.com/iocd/tachiyomij2k/blob/manga-color/app/src/main/java/eu/kanade/tachiyomi/extension/util/ExtensionInstaller.kt"
click node_tracking "https://github.com/iocd/tachiyomij2k/blob/manga-color/app/src/main/java/eu/kanade/tachiyomi/data/track/TrackService.kt"
click node_preferences "https://github.com/iocd/tachiyomij2k/blob/manga-color/app/src/main/java/eu/kanade/tachiyomi/data/preference/PreferencesHelper.kt"
click node_network "https://github.com/iocd/tachiyomij2k/blob/manga-color/app/src/main/java/eu/kanade/tachiyomi/network/NetworkHelper.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_browse,node_browse_results,node_global_search,node_details,node_reader toneBlue
class node_library_ui,node_library_job,node_downloads,node_database,node_manga_model,node_recents,node_backup toneAmber
class node_catalogue,node_source_manager,node_http_source,node_local_source,node_extensions,node_installer toneMint
class node_tracking,node_preferences,node_network toneRose
class node_user toneIndigo
```

## Components

### Discovery and reading

- [App navigation](https://github.com/iocd/tachiyomij2k/blob/manga-color/app/src/main/java/eu/kanade/tachiyomi/ui/main/MainActivity.kt): `app/src/main/java/eu/kanade/tachiyomi/ui/main/MainActivity.kt`
- [Browse sources](https://github.com/iocd/tachiyomij2k/blob/manga-color/app/src/main/java/eu/kanade/tachiyomi/ui/source/BrowseController.kt): `app/src/main/java/eu/kanade/tachiyomi/ui/source/BrowseController.kt`
- [Browse results](https://github.com/iocd/tachiyomij2k/blob/manga-color/app/src/main/java/eu/kanade/tachiyomi/ui/source/browse/BrowseSourceController.kt): `app/src/main/java/eu/kanade/tachiyomi/ui/source/browse/BrowseSourceController.kt`
- [Global search](https://github.com/iocd/tachiyomij2k/blob/manga-color/app/src/main/java/eu/kanade/tachiyomi/ui/source/globalsearch/GlobalSearchController.kt): `app/src/main/java/eu/kanade/tachiyomi/ui/source/globalsearch/GlobalSearchController.kt`
- [Manga details](https://github.com/iocd/tachiyomij2k/blob/manga-color/app/src/main/java/eu/kanade/tachiyomi/ui/manga/MangaDetailsController.kt): `app/src/main/java/eu/kanade/tachiyomi/ui/manga/MangaDetailsController.kt`
- [Chapter reader](https://github.com/iocd/tachiyomij2k/blob/manga-color/app/src/main/java/eu/kanade/tachiyomi/ui/reader/ReaderActivity.kt): `app/src/main/java/eu/kanade/tachiyomi/ui/reader/ReaderActivity.kt`

### Library and persistence

- [Library](https://github.com/iocd/tachiyomij2k/blob/manga-color/app/src/main/java/eu/kanade/tachiyomi/ui/library/LibraryController.kt): `app/src/main/java/eu/kanade/tachiyomi/ui/library/LibraryController.kt`
- [Library updates](https://github.com/iocd/tachiyomij2k/blob/manga-color/app/src/main/java/eu/kanade/tachiyomi/data/library/LibraryUpdateJob.kt): `app/src/main/java/eu/kanade/tachiyomi/data/library/LibraryUpdateJob.kt`
- [Downloads](https://github.com/iocd/tachiyomij2k/blob/manga-color/app/src/main/java/eu/kanade/tachiyomi/data/download/DownloadManager.kt): `app/src/main/java/eu/kanade/tachiyomi/data/download/DownloadManager.kt`
- [App database](https://github.com/iocd/tachiyomij2k/blob/manga-color/app/src/main/java/eu/kanade/tachiyomi/data/database/DatabaseHelper.kt): `app/src/main/java/eu/kanade/tachiyomi/data/database/DatabaseHelper.kt`
- [Manga records](https://github.com/iocd/tachiyomij2k/blob/manga-color/app/src/main/java/eu/kanade/tachiyomi/data/database/models/Manga.kt): `app/src/main/java/eu/kanade/tachiyomi/data/database/models/Manga.kt`
- [Reading recents](https://github.com/iocd/tachiyomij2k/blob/manga-color/app/src/main/java/eu/kanade/tachiyomi/ui/recents/RecentsController.kt): `app/src/main/java/eu/kanade/tachiyomi/ui/recents/RecentsController.kt`
- [Backup and restore](https://github.com/iocd/tachiyomij2k/blob/manga-color/app/src/main/java/eu/kanade/tachiyomi/data/backup/BackupCreator.kt): `app/src/main/java/eu/kanade/tachiyomi/data/backup/BackupCreator.kt`

### Sources and extensions

- [Source catalogue](https://github.com/iocd/tachiyomij2k/blob/manga-color/app/src/main/java/eu/kanade/tachiyomi/source/CatalogueSource.kt): `app/src/main/java/eu/kanade/tachiyomi/source/CatalogueSource.kt`
- [Source registry](https://github.com/iocd/tachiyomij2k/blob/manga-color/app/src/main/java/eu/kanade/tachiyomi/source/SourceManager.kt): `app/src/main/java/eu/kanade/tachiyomi/source/SourceManager.kt`
- [Online sources](https://github.com/iocd/tachiyomij2k/blob/manga-color/app/src/main/java/eu/kanade/tachiyomi/source/online/HttpSource.kt): `app/src/main/java/eu/kanade/tachiyomi/source/online/HttpSource.kt`
- [Local source](https://github.com/iocd/tachiyomij2k/blob/manga-color/app/src/main/java/eu/kanade/tachiyomi/source/LocalSource.kt): `app/src/main/java/eu/kanade/tachiyomi/source/LocalSource.kt`
- [Extension manager](https://github.com/iocd/tachiyomij2k/blob/manga-color/app/src/main/java/eu/kanade/tachiyomi/extension/ExtensionManager.kt): `app/src/main/java/eu/kanade/tachiyomi/extension/ExtensionManager.kt`
- [Extension installer](https://github.com/iocd/tachiyomij2k/blob/manga-color/app/src/main/java/eu/kanade/tachiyomi/extension/util/ExtensionInstaller.kt): `app/src/main/java/eu/kanade/tachiyomi/extension/util/ExtensionInstaller.kt`

### Supporting services

- [Reading trackers](https://github.com/iocd/tachiyomij2k/blob/manga-color/app/src/main/java/eu/kanade/tachiyomi/data/track/TrackService.kt): `app/src/main/java/eu/kanade/tachiyomi/data/track/TrackService.kt`
- [Preferences](https://github.com/iocd/tachiyomij2k/blob/manga-color/app/src/main/java/eu/kanade/tachiyomi/data/preference/PreferencesHelper.kt): `app/src/main/java/eu/kanade/tachiyomi/data/preference/PreferencesHelper.kt`
- [Network services](https://github.com/iocd/tachiyomij2k/blob/manga-color/app/src/main/java/eu/kanade/tachiyomi/network/NetworkHelper.kt): `app/src/main/java/eu/kanade/tachiyomi/network/NetworkHelper.kt`

### Other components

- **Reader**

## Connections

- Reader → App navigation: opens app
- App navigation → Browse sources: navigates to (evidence: `app/src/main/java/eu/kanade/tachiyomi/ui/main/MainActivity.kt`)
- Browse sources → Source registry: lists sources
- Browse results → Source catalogue: searches catalogue (evidence: `app/src/main/java/eu/kanade/tachiyomi/ui/source/browse/BrowseSourceController.kt`)
- Global search → Manga details: opens manga (evidence: `app/src/main/java/eu/kanade/tachiyomi/ui/source/globalsearch/GlobalSearchController.kt`)
- Manga details → App database: uses manga data (evidence: `app/src/main/java/eu/kanade/tachiyomi/ui/manga/MangaDetailsController.kt`)
- Manga details → Source registry: uses source registry (evidence: `app/src/main/java/eu/kanade/tachiyomi/ui/manga/MangaDetailsController.kt`)
- Manga details → Chapter reader: opens reader (evidence: `app/src/main/java/eu/kanade/tachiyomi/ui/manga/MangaDetailsController.kt`)
- Library → Library updates: requests updates (evidence: `app/src/main/java/eu/kanade/tachiyomi/ui/library/LibraryController.kt`)
- Library → Downloads: queues downloads (evidence: `app/src/main/java/eu/kanade/tachiyomi/ui/library/LibraryController.kt`)
- Library updates → App database: updates records
- Reading recents → Chapter reader: opens chapters (evidence: `app/src/main/java/eu/kanade/tachiyomi/ui/recents/RecentsController.kt`)
- Backup and restore → App database: backs up data
- App database → Manga records: maps manga records (evidence: `app/src/main/java/eu/kanade/tachiyomi/data/database/DatabaseHelper.kt`)
- Source registry → Extension manager: resolves sources (evidence: `app/src/main/java/eu/kanade/tachiyomi/source/SourceManager.kt`)
- Extension manager → Extension installer: installs extensions (evidence: `app/src/main/java/eu/kanade/tachiyomi/extension/ExtensionManager.kt`)
- Extension manager → Preferences: reads preferences (evidence: `app/src/main/java/eu/kanade/tachiyomi/extension/ExtensionManager.kt`)
- Source catalogue → Online sources: extends source API (evidence: `app/src/main/java/eu/kanade/tachiyomi/source/CatalogueSource.kt`)
- Reading trackers → App database: stores tracking data (evidence: `app/src/main/java/eu/kanade/tachiyomi/data/track/TrackService.kt`)
- Reading trackers → Network services: uses networking (evidence: `app/src/main/java/eu/kanade/tachiyomi/data/track/TrackService.kt`)
