# keiyoushi/extensions-source architecture

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

## Overview

Keiyoushi Extensions is a repository of manga and comic-source integrations for compatible reader apps, plus shared source and networking utilities. The principal workflow is a reader app requesting a source’s catalog or search results, then manga details, chapters, and page/image data from an external provider. Shared source abstractions and parsing helpers support these integrations. The graph shows representative implementations rather than every source; arrows are limited to relationships documented in the README or visible in the supplied source index and excerpts.

Main entry points: [`core/src/main/kotlin/keiyoushi/source/KeiSource.kt`](https://github.com/keiyoushi/extensions-source/blob/main/core/src/main/kotlin/keiyoushi/source/KeiSource.kt) (Source contract), [`core/src/main/kotlin/keiyoushi/utils/JsonElement.kt`](https://github.com/keiyoushi/extensions-source/blob/main/core/src/main/kotlin/keiyoushi/utils/JsonElement.kt) (JSON helpers), [`src/en/allanime/src/eu/kanade/tachiyomi/extension/en/allanime/AllManga.kt`](https://github.com/keiyoushi/extensions-source/blob/main/src/en/allanime/src/eu/kanade/tachiyomi/extension/en/allanime/AllManga.kt) (AllAnime source), [`lib-multisrc/mangathemesia/src/eu/kanade/tachiyomi/multisrc/mangathemesia/MangaThemesia.kt`](https://github.com/keiyoushi/extensions-source/blob/main/lib-multisrc/mangathemesia/src/eu/kanade/tachiyomi/multisrc/mangathemesia/MangaThemesia.kt) (Themesia sources)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Reader integration"]
  node_reader(("Reader app"))
end

subgraph group_shared["Shared runtime"]
  node_sourceapi["Source contract<br/>[KeiSource.kt]"]
  node_sourceannotation["Source annotation<br/>[Source.kt]"]
  node_json["JSON helpers<br/>[JsonElement.kt]"]
  node_webview["WebView runtime<br/>[WebView.kt]"]
  node_cache["Cache interceptor"]
  node_clienthints["Client-hints interceptor"]
end

subgraph group_multi["Reusable sources"]
  node_gigaviewer["GigaViewer sources<br/>[GigaViewer.kt]"]
  node_initmanga["InitManga sources<br/>[InitManga.kt]"]
  node_madara["Madara sources<br/>[Madara.kt]"]
  node_themesia["Themesia sources<br/>[MangaThemesia.kt]"]
end

subgraph group_individual["Individual sources"]
  node_allanime["AllAnime source<br/>[AllManga.kt]"]
  node_dragontea["DragonTea source<br/>[DragonTea.kt]"]
  node_raijin["Raijin reader script"]
  node_rfdragon["RFDragonScan source<br/>[RFDragonScan.kt]"]
  node_zazhimi["Zazhimi models<br/>[Response.kt]"]
end

node_provider(("Content provider"))

node_reader -.->|"requests source data"| node_sourceapi
node_sourceapi -.->|"fetches content"| node_provider
node_gigaviewer -->|"extends"| node_sourceapi
node_gigaviewer -->|"uses"| node_json
node_initmanga -->|"extends"| node_sourceapi
node_initmanga -->|"uses"| node_json
node_madara -->|"uses"| node_json
node_themesia -->|"extends"| node_sourceapi
node_themesia -->|"uses"| node_json
node_themesia -.->|"configures"| node_clienthints
node_allanime -->|"extends"| node_sourceapi
node_allanime -->|"uses"| node_json
node_allanime -->|"uses"| node_webview
node_allanime -.->|"requests catalog and pages"| node_provider
node_dragontea -->|"extends"| node_madara
node_raijin -->|"runs script in"| node_webview
node_raijin -->|"fetches reader data"| node_provider
node_rfdragon -->|"uses"| node_json
node_rfdragon -.->|"requests source data"| node_provider
node_zazhimi -.->|"maps response data"| node_reader
node_sourceapi -->|"uses"| node_cache
node_sourceannotation -->|"marks source"| node_allanime

click node_sourceapi "https://github.com/keiyoushi/extensions-source/blob/main/core/src/main/kotlin/keiyoushi/source/KeiSource.kt"
click node_sourceannotation "https://github.com/keiyoushi/extensions-source/blob/main/core/src/main/kotlin/keiyoushi/annotation/Source.kt"
click node_json "https://github.com/keiyoushi/extensions-source/blob/main/core/src/main/kotlin/keiyoushi/utils/JsonElement.kt"
click node_webview "https://github.com/keiyoushi/extensions-source/blob/main/core/src/main/kotlin/keiyoushi/utils/WebView.kt"
click node_cache "https://github.com/keiyoushi/extensions-source/blob/main/core/src/main/kotlin/keiyoushi/network/CacheControlInterceptor.kt"
click node_gigaviewer "https://github.com/keiyoushi/extensions-source/blob/main/lib-multisrc/gigaviewer/src/eu/kanade/tachiyomi/multisrc/gigaviewer/GigaViewer.kt"
click node_initmanga "https://github.com/keiyoushi/extensions-source/blob/main/lib-multisrc/initmanga/src/eu/kanade/tachiyomi/multisrc/initmanga/InitManga.kt"
click node_madara "https://github.com/keiyoushi/extensions-source/blob/main/lib-multisrc/madara/src/eu/kanade/tachiyomi/multisrc/madara/Madara.kt"
click node_themesia "https://github.com/keiyoushi/extensions-source/blob/main/lib-multisrc/mangathemesia/src/eu/kanade/tachiyomi/multisrc/mangathemesia/MangaThemesia.kt"
click node_allanime "https://github.com/keiyoushi/extensions-source/blob/main/src/en/allanime/src/eu/kanade/tachiyomi/extension/en/allanime/AllManga.kt"
click node_dragontea "https://github.com/keiyoushi/extensions-source/blob/main/src/en/dragontea/src/eu/kanade/tachiyomi/extension/en/dragontea/DragonTea.kt"
click node_raijin "https://github.com/keiyoushi/extensions-source/blob/main/src/fr/raijinscans/src/eu/kanade/tachiyomi/extension/fr/raijinscans/ReaderScriptManager.kt"
click node_rfdragon "https://github.com/keiyoushi/extensions-source/blob/main/src/pt/rfdragonscan/src/eu/kanade/tachiyomi/extension/pt/rfdragonscan/RFDragonScan.kt"
click node_zazhimi "https://github.com/keiyoushi/extensions-source/blob/main/src/zh/zazhimi/src/eu/kanade/tachiyomi/extension/zh/zazhimi/Response.kt"
click node_clienthints "https://github.com/keiyoushi/extensions-source/blob/main/lib-multisrc/mangathemesia/src/eu/kanade/tachiyomi/multisrc/mangathemesia/ClientHintsInterceptor.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_reader toneBlue
class node_sourceapi,node_sourceannotation,node_json,node_webview,node_cache,node_clienthints toneAmber
class node_gigaviewer,node_initmanga,node_madara,node_themesia toneMint
class node_allanime,node_dragontea,node_raijin,node_rfdragon,node_zazhimi toneRose
class node_provider toneIndigo
```

## Components

### Reader integration

- **Reader app**

### Shared runtime

- [Source contract](https://github.com/keiyoushi/extensions-source/blob/main/core/src/main/kotlin/keiyoushi/source/KeiSource.kt): `core/src/main/kotlin/keiyoushi/source/KeiSource.kt`
- [Source annotation](https://github.com/keiyoushi/extensions-source/blob/main/core/src/main/kotlin/keiyoushi/annotation/Source.kt): `core/src/main/kotlin/keiyoushi/annotation/Source.kt`
- [JSON helpers](https://github.com/keiyoushi/extensions-source/blob/main/core/src/main/kotlin/keiyoushi/utils/JsonElement.kt): `core/src/main/kotlin/keiyoushi/utils/JsonElement.kt`
- [WebView runtime](https://github.com/keiyoushi/extensions-source/blob/main/core/src/main/kotlin/keiyoushi/utils/WebView.kt): `core/src/main/kotlin/keiyoushi/utils/WebView.kt`
- [Cache interceptor](https://github.com/keiyoushi/extensions-source/blob/main/core/src/main/kotlin/keiyoushi/network/CacheControlInterceptor.kt): `core/src/main/kotlin/keiyoushi/network/CacheControlInterceptor.kt`
- [Client-hints interceptor](https://github.com/keiyoushi/extensions-source/blob/main/lib-multisrc/mangathemesia/src/eu/kanade/tachiyomi/multisrc/mangathemesia/ClientHintsInterceptor.kt): `lib-multisrc/mangathemesia/src/eu/kanade/tachiyomi/multisrc/mangathemesia/ClientHintsInterceptor.kt`

### Reusable sources

- [GigaViewer sources](https://github.com/keiyoushi/extensions-source/blob/main/lib-multisrc/gigaviewer/src/eu/kanade/tachiyomi/multisrc/gigaviewer/GigaViewer.kt): `lib-multisrc/gigaviewer/src/eu/kanade/tachiyomi/multisrc/gigaviewer/GigaViewer.kt`
- [InitManga sources](https://github.com/keiyoushi/extensions-source/blob/main/lib-multisrc/initmanga/src/eu/kanade/tachiyomi/multisrc/initmanga/InitManga.kt): `lib-multisrc/initmanga/src/eu/kanade/tachiyomi/multisrc/initmanga/InitManga.kt`
- [Madara sources](https://github.com/keiyoushi/extensions-source/blob/main/lib-multisrc/madara/src/eu/kanade/tachiyomi/multisrc/madara/Madara.kt): `lib-multisrc/madara/src/eu/kanade/tachiyomi/multisrc/madara/Madara.kt`
- [Themesia sources](https://github.com/keiyoushi/extensions-source/blob/main/lib-multisrc/mangathemesia/src/eu/kanade/tachiyomi/multisrc/mangathemesia/MangaThemesia.kt): `lib-multisrc/mangathemesia/src/eu/kanade/tachiyomi/multisrc/mangathemesia/MangaThemesia.kt`

### Individual sources

- [AllAnime source](https://github.com/keiyoushi/extensions-source/blob/main/src/en/allanime/src/eu/kanade/tachiyomi/extension/en/allanime/AllManga.kt): `src/en/allanime/src/eu/kanade/tachiyomi/extension/en/allanime/AllManga.kt`
- [DragonTea source](https://github.com/keiyoushi/extensions-source/blob/main/src/en/dragontea/src/eu/kanade/tachiyomi/extension/en/dragontea/DragonTea.kt): `src/en/dragontea/src/eu/kanade/tachiyomi/extension/en/dragontea/DragonTea.kt`
- [Raijin reader script](https://github.com/keiyoushi/extensions-source/blob/main/src/fr/raijinscans/src/eu/kanade/tachiyomi/extension/fr/raijinscans/ReaderScriptManager.kt): `src/fr/raijinscans/src/eu/kanade/tachiyomi/extension/fr/raijinscans/ReaderScriptManager.kt`
- [RFDragonScan source](https://github.com/keiyoushi/extensions-source/blob/main/src/pt/rfdragonscan/src/eu/kanade/tachiyomi/extension/pt/rfdragonscan/RFDragonScan.kt): `src/pt/rfdragonscan/src/eu/kanade/tachiyomi/extension/pt/rfdragonscan/RFDragonScan.kt`
- [Zazhimi models](https://github.com/keiyoushi/extensions-source/blob/main/src/zh/zazhimi/src/eu/kanade/tachiyomi/extension/zh/zazhimi/Response.kt): `src/zh/zazhimi/src/eu/kanade/tachiyomi/extension/zh/zazhimi/Response.kt`

### Other components

- **Content provider**

## Connections

- Reader app → Source contract: requests source data (evidence: `README.md`)
- Source contract → Content provider: fetches content
- GigaViewer sources → Source contract: extends (evidence: `lib-multisrc/gigaviewer/src/eu/kanade/tachiyomi/multisrc/gigaviewer/GigaViewer.kt`)
- GigaViewer sources → JSON helpers: uses (evidence: `lib-multisrc/gigaviewer/src/eu/kanade/tachiyomi/multisrc/gigaviewer/GigaViewer.kt`)
- InitManga sources → Source contract: extends (evidence: `lib-multisrc/initmanga/src/eu/kanade/tachiyomi/multisrc/initmanga/InitManga.kt`)
- InitManga sources → JSON helpers: uses (evidence: `lib-multisrc/initmanga/src/eu/kanade/tachiyomi/multisrc/initmanga/InitManga.kt`)
- Madara sources → JSON helpers: uses (evidence: `lib-multisrc/madara/src/eu/kanade/tachiyomi/multisrc/madara/Madara.kt`)
- Themesia sources → Source contract: extends (evidence: `lib-multisrc/mangathemesia/src/eu/kanade/tachiyomi/multisrc/mangathemesia/MangaThemesia.kt`)
- Themesia sources → JSON helpers: uses (evidence: `lib-multisrc/mangathemesia/src/eu/kanade/tachiyomi/multisrc/mangathemesia/MangaThemesia.kt`)
- Themesia sources → Client-hints interceptor: configures
- AllAnime source → Source contract: extends (evidence: `src/en/allanime/src/eu/kanade/tachiyomi/extension/en/allanime/AllManga.kt`)
- AllAnime source → JSON helpers: uses (evidence: `src/en/allanime/src/eu/kanade/tachiyomi/extension/en/allanime/AllManga.kt`)
- AllAnime source → WebView runtime: uses (evidence: `src/en/allanime/src/eu/kanade/tachiyomi/extension/en/allanime/AllManga.kt`)
- AllAnime source → Content provider: requests catalog and pages
- DragonTea source → Madara sources: extends (evidence: `src/en/dragontea/src/eu/kanade/tachiyomi/extension/en/dragontea/DragonTea.kt`)
- Raijin reader script → WebView runtime: runs script in (evidence: `src/fr/raijinscans/src/eu/kanade/tachiyomi/extension/fr/raijinscans/ReaderScriptManager.kt`)
- Raijin reader script → Content provider: fetches reader data (evidence: `src/fr/raijinscans/src/eu/kanade/tachiyomi/extension/fr/raijinscans/ReaderScriptManager.kt`)
- RFDragonScan source → JSON helpers: uses (evidence: `src/pt/rfdragonscan/src/eu/kanade/tachiyomi/extension/pt/rfdragonscan/RFDragonScan.kt`)
- RFDragonScan source → Content provider: requests source data
- Zazhimi models → Reader app: maps response data
- Source contract → Cache interceptor: uses (evidence: `core/src/main/kotlin/keiyoushi/source/KeiSource.kt`)
- Source annotation → AllAnime source: marks source (evidence: `src/en/allanime/src/eu/kanade/tachiyomi/extension/en/allanime/AllManga.kt`)
