# manga-download/hakuneko architecture

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

- Interactive diagram: https://gitdiagram.com/manga-download/hakuneko
- Repository: https://github.com/manga-download/hakuneko

## Overview

HakuNeko is a cross-platform manga and anime downloader for offline consumption. The main user workflow is to select a source connector, browse its catalog, choose a chapter or episode, and download media for local reading or playback. The web engine also manages bookmarks, chaptermarks, settings, history, and export-related capabilities. The Electron app configures and launches the web experience, checking for and applying cached application updates first. Some engine modules are indexed but unsampled, so uncertain internal links are omitted.

Main entry points: [`src/web/mjs/HakuNeko.mjs`](https://github.com/manga-download/hakuneko/blob/master/src/web/mjs/HakuNeko.mjs) (Web engine facade), [`src/app/App.js`](https://github.com/manga-download/hakuneko/blob/master/src/app/App.js) (App startup), [`src/web/mjs/engine/Connector.mjs`](https://github.com/manga-download/hakuneko/blob/master/src/web/mjs/engine/Connector.mjs) (Connector behavior), [`src/web/mjs/engine/Storage.mjs`](https://github.com/manga-download/hakuneko/blob/master/src/web/mjs/engine/Storage.mjs) (Media storage)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Desktop application"]
  node_app["App startup<br/>[App.js]"]
  node_config["Platform config<br/>[Configuration.js]"]
  node_updater["Cache updater<br/>[Updater.js]"]
  node_update_server["Update server client"]
  node_cache["App cache"]
  node_electron["Electron bootstrap"]
end

subgraph group_catalog["Source discovery"]
  node_connectors["Connector registry<br/>[Connectors.mjs]"]
  node_connector_base["Connector behavior<br/>[Connector.mjs]"]
  node_coreview["CoreView template<br/>[CoreView.mjs]"]
  node_madara["Madara template"]
end

subgraph group_engine["Download engine"]
  node_web_app["Web engine facade<br/>[HakuNeko.mjs]"]
  node_manga["Manga model<br/>[Manga.mjs]"]
  node_request["Request engine<br/>[Request.mjs]"]
  node_download_manager["Download queue"]
  node_download_job["Download job<br/>[DownloadJob.mjs]"]
  node_storage["Media storage<br/>[Storage.mjs]"]
end

subgraph group_library["User library"]
  node_bookmarks["Bookmarks"]
  node_chaptermarks["Chaptermarks"]
  node_settings["Settings<br/>[Settings.mjs]"]
  node_history["Download history<br/>[HistoryWorker.mjs]"]
  node_blacklist["Blacklist<br/>[Blacklist.mjs]"]
end

subgraph group_integrations["Media integrations"]
  node_ebook["Ebook export<br/>[EbookGenerator.mjs]"]
  node_discord["Discord presence"]
  node_video["Video stream handlers"]
end

node_user(("User"))
node_source_sites(("Media websites"))
node_local_files[("Local media files")]

node_user -->|"launches"| node_app
node_app -->|"selects config"| node_config
node_app -->|"checks cache"| node_updater
node_app -->|"launches"| node_electron
node_app -->|"requests updates"| node_update_server
node_app -->|"updates cache"| node_cache
node_user -.->|"uses application"| node_web_app
node_web_app -->|"initializes"| node_connectors
node_connectors -.->|"registers connectors"| node_connector_base
node_coreview -->|"extends"| node_connector_base
node_madara -->|"extends"| node_connector_base
node_coreview -->|"creates"| node_manga
node_madara -->|"creates"| node_manga
node_connector_base -.->|"fetches catalog"| node_source_sites
node_user -.->|"queues media"| node_download_manager
node_web_app -->|"exposes queue"| node_download_manager
node_download_manager -->|"creates jobs"| node_download_job
node_download_manager -->|"checks connector lock"| node_connector_base
node_download_job -.->|"downloads pages"| node_storage
node_storage -.->|"writes media"| node_local_files
node_web_app -->|"constructs"| node_request
node_connector_base -.->|"uses requests"| node_request
node_web_app -->|"constructs"| node_bookmarks
node_bookmarks -->|"saves bookmarks"| node_storage
node_web_app -->|"constructs"| node_chaptermarks
node_chaptermarks -->|"saves marks"| node_storage
node_web_app -->|"constructs"| node_settings
node_web_app -->|"constructs"| node_blacklist
node_web_app -->|"imports"| node_history
node_web_app -->|"constructs"| node_ebook
node_storage -->|"imports"| node_ebook
node_web_app -->|"constructs"| node_discord
node_user -.->|"plays anime"| node_video

click node_app "https://github.com/manga-download/hakuneko/blob/master/src/app/App.js"
click node_config "https://github.com/manga-download/hakuneko/blob/master/src/app/Configuration.js"
click node_updater "https://github.com/manga-download/hakuneko/blob/master/src/app/Updater.js"
click node_update_server "https://github.com/manga-download/hakuneko/blob/master/src/app/UpdateServerManager.js"
click node_cache "https://github.com/manga-download/hakuneko/blob/master/src/app/CacheDirectoryManager.js"
click node_electron "https://github.com/manga-download/hakuneko/blob/master/src/app/ElectronBootstrap.js"
click node_web_app "https://github.com/manga-download/hakuneko/blob/master/src/web/mjs/HakuNeko.mjs"
click node_connectors "https://github.com/manga-download/hakuneko/blob/master/src/web/mjs/engine/Connectors.mjs"
click node_connector_base "https://github.com/manga-download/hakuneko/blob/master/src/web/mjs/engine/Connector.mjs"
click node_coreview "https://github.com/manga-download/hakuneko/blob/master/src/web/mjs/connectors/templates/CoreView.mjs"
click node_madara "https://github.com/manga-download/hakuneko/blob/master/src/web/mjs/connectors/templates/WordPressMadara.mjs"
click node_manga "https://github.com/manga-download/hakuneko/blob/master/src/web/mjs/engine/Manga.mjs"
click node_request "https://github.com/manga-download/hakuneko/blob/master/src/web/mjs/engine/Request.mjs"
click node_download_manager "https://github.com/manga-download/hakuneko/blob/master/src/web/mjs/engine/DownloadManager.mjs"
click node_download_job "https://github.com/manga-download/hakuneko/blob/master/src/web/mjs/engine/DownloadJob.mjs"
click node_storage "https://github.com/manga-download/hakuneko/blob/master/src/web/mjs/engine/Storage.mjs"
click node_bookmarks "https://github.com/manga-download/hakuneko/blob/master/src/web/mjs/engine/BookmarkManager.mjs"
click node_chaptermarks "https://github.com/manga-download/hakuneko/blob/master/src/web/mjs/engine/ChaptermarkManager.mjs"
click node_settings "https://github.com/manga-download/hakuneko/blob/master/src/web/mjs/engine/Settings.mjs"
click node_history "https://github.com/manga-download/hakuneko/blob/master/src/web/mjs/engine/HistoryWorker.mjs"
click node_blacklist "https://github.com/manga-download/hakuneko/blob/master/src/web/mjs/engine/Blacklist.mjs"
click node_ebook "https://github.com/manga-download/hakuneko/blob/master/src/web/mjs/engine/EbookGenerator.mjs"
click node_discord "https://github.com/manga-download/hakuneko/blob/master/src/web/mjs/engine/DiscordPresence.mjs"
click node_video "https://github.com/manga-download/hakuneko/tree/master/src/web/mjs/videostreams"

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_app,node_config,node_updater,node_update_server,node_cache,node_electron,node_user toneBlue
class node_connectors,node_connector_base,node_coreview,node_madara,node_local_files toneAmber
class node_web_app,node_manga,node_request,node_download_manager,node_download_job,node_storage toneMint
class node_bookmarks,node_chaptermarks,node_settings,node_history,node_blacklist toneRose
class node_ebook,node_discord,node_video,node_source_sites toneIndigo
```

## Components

### Desktop application

- [App startup](https://github.com/manga-download/hakuneko/blob/master/src/app/App.js): `src/app/App.js`
- [Platform config](https://github.com/manga-download/hakuneko/blob/master/src/app/Configuration.js): `src/app/Configuration.js`
- [Cache updater](https://github.com/manga-download/hakuneko/blob/master/src/app/Updater.js): `src/app/Updater.js`
- [Update server client](https://github.com/manga-download/hakuneko/blob/master/src/app/UpdateServerManager.js): `src/app/UpdateServerManager.js`
- [App cache](https://github.com/manga-download/hakuneko/blob/master/src/app/CacheDirectoryManager.js): `src/app/CacheDirectoryManager.js`
- [Electron bootstrap](https://github.com/manga-download/hakuneko/blob/master/src/app/ElectronBootstrap.js): `src/app/ElectronBootstrap.js`

### Source discovery

- [Connector registry](https://github.com/manga-download/hakuneko/blob/master/src/web/mjs/engine/Connectors.mjs): `src/web/mjs/engine/Connectors.mjs`
- [Connector behavior](https://github.com/manga-download/hakuneko/blob/master/src/web/mjs/engine/Connector.mjs): `src/web/mjs/engine/Connector.mjs`
- [CoreView template](https://github.com/manga-download/hakuneko/blob/master/src/web/mjs/connectors/templates/CoreView.mjs): `src/web/mjs/connectors/templates/CoreView.mjs`
- [Madara template](https://github.com/manga-download/hakuneko/blob/master/src/web/mjs/connectors/templates/WordPressMadara.mjs): `src/web/mjs/connectors/templates/WordPressMadara.mjs`

### Download engine

- [Web engine facade](https://github.com/manga-download/hakuneko/blob/master/src/web/mjs/HakuNeko.mjs): `src/web/mjs/HakuNeko.mjs`
- [Manga model](https://github.com/manga-download/hakuneko/blob/master/src/web/mjs/engine/Manga.mjs): `src/web/mjs/engine/Manga.mjs`
- [Request engine](https://github.com/manga-download/hakuneko/blob/master/src/web/mjs/engine/Request.mjs): `src/web/mjs/engine/Request.mjs`
- [Download queue](https://github.com/manga-download/hakuneko/blob/master/src/web/mjs/engine/DownloadManager.mjs): `src/web/mjs/engine/DownloadManager.mjs`
- [Download job](https://github.com/manga-download/hakuneko/blob/master/src/web/mjs/engine/DownloadJob.mjs): `src/web/mjs/engine/DownloadJob.mjs`
- [Media storage](https://github.com/manga-download/hakuneko/blob/master/src/web/mjs/engine/Storage.mjs): `src/web/mjs/engine/Storage.mjs`

### User library

- [Bookmarks](https://github.com/manga-download/hakuneko/blob/master/src/web/mjs/engine/BookmarkManager.mjs): `src/web/mjs/engine/BookmarkManager.mjs`
- [Chaptermarks](https://github.com/manga-download/hakuneko/blob/master/src/web/mjs/engine/ChaptermarkManager.mjs): `src/web/mjs/engine/ChaptermarkManager.mjs`
- [Settings](https://github.com/manga-download/hakuneko/blob/master/src/web/mjs/engine/Settings.mjs): `src/web/mjs/engine/Settings.mjs`
- [Download history](https://github.com/manga-download/hakuneko/blob/master/src/web/mjs/engine/HistoryWorker.mjs): `src/web/mjs/engine/HistoryWorker.mjs`
- [Blacklist](https://github.com/manga-download/hakuneko/blob/master/src/web/mjs/engine/Blacklist.mjs): `src/web/mjs/engine/Blacklist.mjs`

### Media integrations

- [Ebook export](https://github.com/manga-download/hakuneko/blob/master/src/web/mjs/engine/EbookGenerator.mjs): `src/web/mjs/engine/EbookGenerator.mjs`
- [Discord presence](https://github.com/manga-download/hakuneko/blob/master/src/web/mjs/engine/DiscordPresence.mjs): `src/web/mjs/engine/DiscordPresence.mjs`
- [Video stream handlers](https://github.com/manga-download/hakuneko/tree/master/src/web/mjs/videostreams): `src/web/mjs/videostreams`

### Other components

- **User**
- **Media websites**
- **Local media files**

## Connections

- User → App startup: launches (evidence: `src/app/App.js`)
- App startup → Platform config: selects config (evidence: `src/app/App.js`)
- App startup → Cache updater: checks cache (evidence: `src/app/App.js`)
- App startup → Electron bootstrap: launches (evidence: `src/app/App.js`)
- App startup → Update server client: requests updates (evidence: `src/app/App.js`)
- App startup → App cache: updates cache (evidence: `src/app/App.js`)
- User → Web engine facade: uses application
- Web engine facade → Connector registry: initializes (evidence: `src/web/mjs/HakuNeko.mjs`)
- Connector registry → Connector behavior: registers connectors
- CoreView template → Connector behavior: extends (evidence: `src/web/mjs/connectors/templates/CoreView.mjs`)
- Madara template → Connector behavior: extends (evidence: `src/web/mjs/connectors/templates/WordPressMadara.mjs`)
- CoreView template → Manga model: creates (evidence: `src/web/mjs/connectors/templates/CoreView.mjs`)
- Madara template → Manga model: creates (evidence: `src/web/mjs/connectors/templates/WordPressMadara.mjs`)
- Connector behavior → Media websites: fetches catalog
- User → Download queue: queues media
- Web engine facade → Download queue: exposes queue (evidence: `src/web/mjs/HakuNeko.mjs`)
- Download queue → Download job: creates jobs (evidence: `src/web/mjs/engine/DownloadManager.mjs`)
- Download queue → Connector behavior: checks connector lock (evidence: `src/web/mjs/engine/DownloadManager.mjs`)
- Download job → Media storage: downloads pages
- Media storage → Local media files: writes media
- Web engine facade → Request engine: constructs (evidence: `src/web/mjs/HakuNeko.mjs`)
- Connector behavior → Request engine: uses requests
- Web engine facade → Bookmarks: constructs (evidence: `src/web/mjs/HakuNeko.mjs`)
- Bookmarks → Media storage: saves bookmarks (evidence: `src/web/mjs/engine/BookmarkManager.mjs`)
- Web engine facade → Chaptermarks: constructs (evidence: `src/web/mjs/HakuNeko.mjs`)
- Chaptermarks → Media storage: saves marks (evidence: `src/web/mjs/engine/ChaptermarkManager.mjs`)
- Web engine facade → Settings: constructs (evidence: `src/web/mjs/HakuNeko.mjs`)
- Web engine facade → Blacklist: constructs (evidence: `src/web/mjs/HakuNeko.mjs`)
- Web engine facade → Download history: imports (evidence: `src/web/mjs/HakuNeko.mjs`)
- Web engine facade → Ebook export: constructs (evidence: `src/web/mjs/HakuNeko.mjs`)
- Media storage → Ebook export: imports (evidence: `src/web/mjs/engine/Storage.mjs`)
- Web engine facade → Discord presence: constructs (evidence: `src/web/mjs/HakuNeko.mjs`)
- User → Video stream handlers: plays anime
