# aidoku-community/sources architecture

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

- Interactive diagram: https://gitdiagram.com/aidoku-community/sources
- Repository: https://github.com/aidoku-community/sources

## Overview

Aidoku Community Sources is a repository of community-maintained, installable manga and comic source connectors. The principal workflow is Aidoku invoking a connector, which requests and parses a provider’s listings, details, chapters, or pages into Aidoku result types. The repository also includes authentication, local history and remote-storage behavior, plus reusable source templates. The tree and excerpts show varied implementations; unsampled connectors are represented only as source modules, and their internal call paths are not inferred.

Main entry points: [`sources/multi.cubari/src/remotestorage.rs`](https://github.com/aidoku-community/sources/blob/main/sources/multi.cubari/src/remotestorage.rs) (Cubari remote history), [`sources/ko.naverwebtoon/src/parser.rs`](https://github.com/aidoku-community/sources/blob/main/sources/ko.naverwebtoon/src/parser.rs) (Naver parser), [`sources/multi.webtoon/src/parser.rs`](https://github.com/aidoku-community/sources/blob/main/sources/multi.webtoon/src/parser.rs) (Webtoon parser), [`sources/multi.ehentai/src/parser.rs`](https://github.com/aidoku-community/sources/blob/main/sources/multi.ehentai/src/parser.rs) (E-Hentai parser)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_connectors["Source connectors"]
  node_asura_models["Asura models<br/>[models.rs]"]
  node_rawdevart_models["Rawdevart models<br/>[models.rs]"]
  node_soraraw_models["Soraraw models<br/>[models.rs]"]
  node_naver_parser["Naver parser<br/>[parser.rs]"]
  node_ehentai_parser["E-Hentai parser<br/>[parser.rs]"]
  node_mangadex_models["MangaDex models<br/>[models.rs]"]
  node_mangadotnet_models["Manga.net models<br/>[models.rs]"]
  node_webtoon_parser["Webtoon parser<br/>[parser.rs]"]
  node_copymanga_favorites["CopyManga favorites<br/>[favorites.rs]"]
  node_komiic_home["Komiic home<br/>[home.rs]"]
  node_noyacg_models["Noyacg models<br/>[models.rs]"]
end

subgraph group_shared["Connector internals"]
  node_naver_auth["Naver auth<br/>[auth.rs]"]
end

subgraph group_state["Auth and state"]
  node_cubari_remote["Cubari remote history<br/>[remotestorage.rs]"]
  node_cubari_db[("Cubari local history<br/>[database.rs]")]
  node_cubari_settings["Cubari settings<br/>[settings.rs]"]
  node_mangadex_auth["MangaDex auth<br/>[auth.rs]"]
  node_mangadex_settings["MangaDex settings<br/>[settings.rs]"]
  node_desu_settings["Desu settings<br/>[settings.rs]"]
  node_remanga_settings["Remanga settings<br/>[settings.rs]"]
  node_copymanga_auth["CopyManga auth<br/>[auth.rs]"]
  node_noyacg_auth["Noyacg auth<br/>[auth.rs]"]
end

subgraph group_templates["Source templates"]
  node_reader_parser["Reader parser template<br/>[parser.rs]"]
  node_gigaviewer_parser["Gigaviewer parser<br/>[parser.rs]"]
end

node_aidoku(("Aidoku app"))
node_content_sites(("Comic provider sites"))
node_remote_storage(("Cubari storage service"))

node_aidoku -.->|"invokes source"| node_naver_parser
node_aidoku -.->|"invokes source"| node_webtoon_parser
node_webtoon_parser -->|"requests pages"| node_content_sites
node_naver_parser -->|"requests pages"| node_content_sites
node_naver_parser -->|"uses authentication"| node_naver_auth
node_ehentai_parser -.->|"parses provider pages"| node_content_sites
node_cubari_remote -->|"reads and updates"| node_cubari_settings
node_cubari_remote -->|"reads and writes"| node_cubari_db
node_cubari_remote -->|"fetches history"| node_remote_storage
node_mangadex_auth -->|"reads and updates"| node_mangadex_settings
node_copymanga_auth -->|"clears cached state"| node_copymanga_favorites
node_noyacg_auth -->|"posts login"| node_content_sites
node_reader_parser -.->|"parses provider pages"| node_content_sites

click node_asura_models "https://github.com/aidoku-community/sources/blob/main/sources/en.asurascans/src/models.rs"
click node_rawdevart_models "https://github.com/aidoku-community/sources/blob/main/sources/ja.rawdevart/src/models.rs"
click node_soraraw_models "https://github.com/aidoku-community/sources/blob/main/sources/ja.soraraw/src/models.rs"
click node_naver_parser "https://github.com/aidoku-community/sources/blob/main/sources/ko.naverwebtoon/src/parser.rs"
click node_ehentai_parser "https://github.com/aidoku-community/sources/blob/main/sources/multi.ehentai/src/parser.rs"
click node_mangadex_models "https://github.com/aidoku-community/sources/blob/main/sources/multi.mangadex/src/models.rs"
click node_mangadotnet_models "https://github.com/aidoku-community/sources/blob/main/sources/multi.mangadotnet/src/models.rs"
click node_webtoon_parser "https://github.com/aidoku-community/sources/blob/main/sources/multi.webtoon/src/parser.rs"
click node_copymanga_favorites "https://github.com/aidoku-community/sources/blob/main/sources/zh.copymanga/src/favorites.rs"
click node_komiic_home "https://github.com/aidoku-community/sources/blob/main/sources/zh.komiic/src/home.rs"
click node_noyacg_models "https://github.com/aidoku-community/sources/blob/main/sources/zh.noyacg/src/models.rs"
click node_naver_auth "https://github.com/aidoku-community/sources/blob/main/sources/ko.naverwebtoon/src/auth.rs"
click node_cubari_remote "https://github.com/aidoku-community/sources/blob/main/sources/multi.cubari/src/remotestorage.rs"
click node_cubari_db "https://github.com/aidoku-community/sources/blob/main/sources/multi.cubari/src/database.rs"
click node_cubari_settings "https://github.com/aidoku-community/sources/blob/main/sources/multi.cubari/src/settings.rs"
click node_mangadex_auth "https://github.com/aidoku-community/sources/blob/main/sources/multi.mangadex/src/auth.rs"
click node_mangadex_settings "https://github.com/aidoku-community/sources/blob/main/sources/multi.mangadex/src/settings.rs"
click node_desu_settings "https://github.com/aidoku-community/sources/blob/main/sources/ru.desu/src/settings.rs"
click node_remanga_settings "https://github.com/aidoku-community/sources/blob/main/sources/ru.remanga/src/settings.rs"
click node_copymanga_auth "https://github.com/aidoku-community/sources/blob/main/sources/zh.copymanga/src/auth.rs"
click node_noyacg_auth "https://github.com/aidoku-community/sources/blob/main/sources/zh.noyacg/src/auth.rs"
click node_reader_parser "https://github.com/aidoku-community/sources/blob/main/templates/mangareader/src/parser.rs"
click node_gigaviewer_parser "https://github.com/aidoku-community/sources/blob/main/templates/gigaviewer/src/parser.rs"

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_asura_models,node_rawdevart_models,node_soraraw_models,node_naver_parser,node_ehentai_parser,node_mangadex_models,node_mangadotnet_models,node_webtoon_parser,node_copymanga_favorites,node_komiic_home,node_noyacg_models toneBlue
class node_naver_auth,node_remote_storage toneAmber
class node_cubari_remote,node_cubari_db,node_cubari_settings,node_mangadex_auth,node_mangadex_settings,node_desu_settings,node_remanga_settings,node_copymanga_auth,node_noyacg_auth toneMint
class node_reader_parser,node_gigaviewer_parser toneRose
class node_aidoku,node_content_sites toneIndigo
```

## Components

### Source connectors

- [Asura models](https://github.com/aidoku-community/sources/blob/main/sources/en.asurascans/src/models.rs): `sources/en.asurascans/src/models.rs`
- [Rawdevart models](https://github.com/aidoku-community/sources/blob/main/sources/ja.rawdevart/src/models.rs): `sources/ja.rawdevart/src/models.rs`
- [Soraraw models](https://github.com/aidoku-community/sources/blob/main/sources/ja.soraraw/src/models.rs): `sources/ja.soraraw/src/models.rs`
- [Naver parser](https://github.com/aidoku-community/sources/blob/main/sources/ko.naverwebtoon/src/parser.rs): `sources/ko.naverwebtoon/src/parser.rs`
- [E-Hentai parser](https://github.com/aidoku-community/sources/blob/main/sources/multi.ehentai/src/parser.rs): `sources/multi.ehentai/src/parser.rs`
- [MangaDex models](https://github.com/aidoku-community/sources/blob/main/sources/multi.mangadex/src/models.rs): `sources/multi.mangadex/src/models.rs`
- [Manga.net models](https://github.com/aidoku-community/sources/blob/main/sources/multi.mangadotnet/src/models.rs): `sources/multi.mangadotnet/src/models.rs`
- [Webtoon parser](https://github.com/aidoku-community/sources/blob/main/sources/multi.webtoon/src/parser.rs): `sources/multi.webtoon/src/parser.rs`
- [CopyManga favorites](https://github.com/aidoku-community/sources/blob/main/sources/zh.copymanga/src/favorites.rs): `sources/zh.copymanga/src/favorites.rs`
- [Komiic home](https://github.com/aidoku-community/sources/blob/main/sources/zh.komiic/src/home.rs): `sources/zh.komiic/src/home.rs`
- [Noyacg models](https://github.com/aidoku-community/sources/blob/main/sources/zh.noyacg/src/models.rs): `sources/zh.noyacg/src/models.rs`

### Connector internals

- [Naver auth](https://github.com/aidoku-community/sources/blob/main/sources/ko.naverwebtoon/src/auth.rs): `sources/ko.naverwebtoon/src/auth.rs`

### Auth and state

- [Cubari remote history](https://github.com/aidoku-community/sources/blob/main/sources/multi.cubari/src/remotestorage.rs): `sources/multi.cubari/src/remotestorage.rs`
- [Cubari local history](https://github.com/aidoku-community/sources/blob/main/sources/multi.cubari/src/database.rs): `sources/multi.cubari/src/database.rs`
- [Cubari settings](https://github.com/aidoku-community/sources/blob/main/sources/multi.cubari/src/settings.rs): `sources/multi.cubari/src/settings.rs`
- [MangaDex auth](https://github.com/aidoku-community/sources/blob/main/sources/multi.mangadex/src/auth.rs): `sources/multi.mangadex/src/auth.rs`
- [MangaDex settings](https://github.com/aidoku-community/sources/blob/main/sources/multi.mangadex/src/settings.rs): `sources/multi.mangadex/src/settings.rs`
- [Desu settings](https://github.com/aidoku-community/sources/blob/main/sources/ru.desu/src/settings.rs): `sources/ru.desu/src/settings.rs`
- [Remanga settings](https://github.com/aidoku-community/sources/blob/main/sources/ru.remanga/src/settings.rs): `sources/ru.remanga/src/settings.rs`
- [CopyManga auth](https://github.com/aidoku-community/sources/blob/main/sources/zh.copymanga/src/auth.rs): `sources/zh.copymanga/src/auth.rs`
- [Noyacg auth](https://github.com/aidoku-community/sources/blob/main/sources/zh.noyacg/src/auth.rs): `sources/zh.noyacg/src/auth.rs`

### Source templates

- [Reader parser template](https://github.com/aidoku-community/sources/blob/main/templates/mangareader/src/parser.rs): `templates/mangareader/src/parser.rs`
- [Gigaviewer parser](https://github.com/aidoku-community/sources/blob/main/templates/gigaviewer/src/parser.rs): `templates/gigaviewer/src/parser.rs`

### Other components

- **Aidoku app**
- **Comic provider sites**
- **Cubari storage service**

## Connections

- Aidoku app → Naver parser: invokes source (evidence: `README.md`)
- Aidoku app → Webtoon parser: invokes source (evidence: `README.md`)
- Webtoon parser → Comic provider sites: requests pages (evidence: `sources/multi.webtoon/src/parser.rs`)
- Naver parser → Comic provider sites: requests pages (evidence: `sources/ko.naverwebtoon/src/parser.rs`)
- Naver parser → Naver auth: uses authentication (evidence: `sources/ko.naverwebtoon/src/parser.rs`)
- E-Hentai parser → Comic provider sites: parses provider pages
- Cubari remote history → Cubari settings: reads and updates (evidence: `sources/multi.cubari/src/remotestorage.rs`)
- Cubari remote history → Cubari local history: reads and writes (evidence: `sources/multi.cubari/src/remotestorage.rs`)
- Cubari remote history → Cubari storage service: fetches history (evidence: `sources/multi.cubari/src/remotestorage.rs`)
- MangaDex auth → MangaDex settings: reads and updates (evidence: `sources/multi.mangadex/src/auth.rs`)
- CopyManga auth → CopyManga favorites: clears cached state (evidence: `sources/zh.copymanga/src/auth.rs`)
- Noyacg auth → Comic provider sites: posts login (evidence: `sources/zh.noyacg/src/auth.rs`)
- Reader parser template → Comic provider sites: parses provider pages
