How manga-download/hakuneko works
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: HakuNeko.mjs Web engine facade · App.js App startup · Connector.mjs Connector behavior · Storage.mjs Media storage
Components 27
Desktop application
- App startup
src/app/App.js - Platform config
src/app/Configuration.js - Cache updater
src/app/Updater.js - Update server client
src/app/UpdateServerManager.js - App cache
src/app/CacheDirectoryManager.js - Electron bootstrap
src/app/ElectronBootstrap.js
Source discovery
- Connector registry
src/web/mjs/engine/Connectors.mjs - Connector behavior
src/web/mjs/engine/Connector.mjs - CoreView template
src/web/mjs/connectors/templates/CoreView.mjs - Madara template
src/web/mjs/connectors/templates/WordPressMadara.mjs
Download engine
- Web engine facade
src/web/mjs/HakuNeko.mjs - Manga model
src/web/mjs/engine/Manga.mjs - Request engine
src/web/mjs/engine/Request.mjs - Download queue
src/web/mjs/engine/DownloadManager.mjs - Download job
src/web/mjs/engine/DownloadJob.mjs - Media storage
src/web/mjs/engine/Storage.mjs
User library
- Bookmarks
src/web/mjs/engine/BookmarkManager.mjs - Chaptermarks
src/web/mjs/engine/ChaptermarkManager.mjs - Settings
src/web/mjs/engine/Settings.mjs - Download history
src/web/mjs/engine/HistoryWorker.mjs - Blacklist
src/web/mjs/engine/Blacklist.mjs
Media integrations
- Ebook export
src/web/mjs/engine/EbookGenerator.mjs - Discord presence
src/web/mjs/engine/DiscordPresence.mjs - Video stream handlers
src/web/mjs/videostreams
Other components
- User
- Media websites
- Local media files
Connections 33
- User → App startup: launches
src/app/App.js - App startup → Platform config: selects config
src/app/App.js - App startup → Cache updater: checks cache
src/app/App.js - App startup → Electron bootstrap: launches
src/app/App.js - App startup → Update server client: requests updates
src/app/App.js - App startup → App cache: updates cache
src/app/App.js - User → Web engine facade: uses application
- Web engine facade → Connector registry: initializes
src/web/mjs/HakuNeko.mjs - Connector registry → Connector behavior: registers connectors
- CoreView template → Connector behavior: extends
src/web/mjs/connectors/templates/CoreView.mjs - Madara template → Connector behavior: extends
src/web/mjs/connectors/templates/WordPressMadara.mjs - CoreView template → Manga model: creates
src/web/mjs/connectors/templates/CoreView.mjs - Madara template → Manga model: creates
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
src/web/mjs/HakuNeko.mjs - Download queue → Download job: creates jobs
src/web/mjs/engine/DownloadManager.mjs - Download queue → Connector behavior: checks connector lock
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
src/web/mjs/HakuNeko.mjs - Connector behavior → Request engine: uses requests
- Web engine facade → Bookmarks: constructs
src/web/mjs/HakuNeko.mjs - Bookmarks → Media storage: saves bookmarks
src/web/mjs/engine/BookmarkManager.mjs - Web engine facade → Chaptermarks: constructs
src/web/mjs/HakuNeko.mjs - Chaptermarks → Media storage: saves marks
src/web/mjs/engine/ChaptermarkManager.mjs - Web engine facade → Settings: constructs
src/web/mjs/HakuNeko.mjs - Web engine facade → Blacklist: constructs
src/web/mjs/HakuNeko.mjs - Web engine facade → Download history: imports
src/web/mjs/HakuNeko.mjs - Web engine facade → Ebook export: constructs
src/web/mjs/HakuNeko.mjs - Media storage → Ebook export: imports
src/web/mjs/engine/Storage.mjs - Web engine facade → Discord presence: constructs
src/web/mjs/HakuNeko.mjs - User → Video stream handlers: plays anime