# zhongbai2333/tomato-novel-downloader architecture

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

- Interactive diagram: https://gitdiagram.com/zhongbai2333/tomato-novel-downloader
- Repository: https://github.com/zhongbai2333/tomato-novel-downloader

## Overview

Tomato Novel Downloader searches or previews a novel, prepares its metadata and chapter plan, downloads chapters with resume/retry support, and exports text, EPUB, PDF, or audiobook files. Users enter through TUI, Web UI, legacy CLI, or restricted update mode; Web UI also supports task management and browsing/downloading the local library. The graph preserves documented export and UI capabilities even where implementation excerpts were unavailable. Edges reflect shown calls/import references or README statements; unsampled route and export internals are not inferred beyond those statements.

Main entry points: [`src/download/downloader.rs`](https://github.com/zhongbai2333/tomato-novel-downloader/blob/main/src/download/downloader.rs) (Chapter download orchestration), [`src/main.rs`](https://github.com/zhongbai2333/tomato-novel-downloader/blob/main/src/main.rs) (Application entry), [`src/ui/web/routes`](https://github.com/zhongbai2333/tomato-novel-downloader/tree/main/src/ui/web/routes) (Web routes), [`src/download/plan.rs`](https://github.com/zhongbai2333/tomato-novel-downloader/blob/main/src/download/plan.rs) (Search and download plan)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["User interfaces"]
  node_main["Application entry<br/>[main.rs]"]
  node_tui["Interactive TUI"]
  node_legacy["Legacy CLI"]
  node_web["Web server"]
  node_web_router["Web router<br/>[router.rs]"]
  node_web_routes["Web routes"]
  node_web_state["Web task state<br/>[state.rs]"]
end

subgraph group_planning["Discovery and planning"]
  node_planner["Search and download plan<br/>[plan.rs]"]
  node_network["Novel web/API access<br/>[network.rs]"]
end

subgraph group_download["Download runtime"]
  node_downloader["Chapter download orchestration<br/>[downloader.rs]"]
  node_third_party["Third-party content access<br/>[third_party.rs]"]
  node_progress["Download progress<br/>[progress.rs]"]
  node_book_manager[("Resume and chapter state<br/>[book_manager.rs]")]
end

subgraph group_outputs["Content outputs"]
  node_parser["Chapter content parser<br/>[parser.rs]"]
  node_epub["EPUB generation<br/>[epub_generator.rs]"]
  node_pdf["PDF finalization<br/>[finalize_pdf.rs]"]
  node_audio["Audiobook generation<br/>[audio_generator.rs]"]
end

subgraph group_foundation["Shared services"]
  node_config["Configuration and paths<br/>[context.rs]"]
  node_history[("Download history")]
end

node_user(("Reader / operator"))
node_external_novel{{"Novel service"}}
node_external_tts{{"Microsoft Edge TTS"}}
node_library[("Local download library")]

node_user -->|"starts"| node_main
node_main -->|"runs server"| node_web
node_main -->|"runs legacy UI"| node_legacy
node_main -->|"offers interactive UI"| node_tui
node_user -->|"browses and submits"| node_web
node_web -->|"routes requests"| node_web_router
node_web_router -->|"dispatches"| node_web_routes
node_web_router -->|"uses state"| node_web_state
node_web_state -->|"starts tasks"| node_downloader
node_web_routes -->|"browses and serves files"| node_library
node_tui -->|"starts downloads"| node_downloader
node_user -->|"requests search or preview"| node_planner
node_planner -->|"fetches metadata and chapters"| node_network
node_network -.->|"requests novel data"| node_external_novel
node_planner -.->|"prepares plan"| node_downloader
node_downloader -->|"fetches content"| node_third_party
node_downloader -->|"parses chapters"| node_parser
node_downloader -->|"saves resume state"| node_book_manager
node_downloader -->|"updates progress"| node_progress
node_downloader -->|"records downloads"| node_history
node_downloader -.->|"finalizes output"| node_epub
node_downloader -.->|"finalizes output"| node_pdf
node_downloader -.->|"generates audiobook"| node_audio
node_audio -->|"synthesizes speech"| node_external_tts
node_audio -->|"uses downloaded chapters"| node_book_manager
node_downloader -->|"uses download settings"| node_config
node_planner -->|"uses output settings"| node_config
node_web_routes -->|"edits output settings"| node_config
node_web_routes -->|"downloads files or ZIPs"| node_library

click node_main "https://github.com/zhongbai2333/tomato-novel-downloader/blob/main/src/main.rs"
click node_tui "https://github.com/zhongbai2333/tomato-novel-downloader/tree/main/src/ui/tui"
click node_legacy "https://github.com/zhongbai2333/tomato-novel-downloader/tree/main/src/ui/noui"
click node_web "https://github.com/zhongbai2333/tomato-novel-downloader/tree/main/src/ui/web"
click node_web_router "https://github.com/zhongbai2333/tomato-novel-downloader/blob/main/src/ui/web/router.rs"
click node_web_routes "https://github.com/zhongbai2333/tomato-novel-downloader/tree/main/src/ui/web/routes"
click node_web_state "https://github.com/zhongbai2333/tomato-novel-downloader/blob/main/src/ui/web/state.rs"
click node_planner "https://github.com/zhongbai2333/tomato-novel-downloader/blob/main/src/download/plan.rs"
click node_network "https://github.com/zhongbai2333/tomato-novel-downloader/blob/main/src/network_parser/network.rs"
click node_downloader "https://github.com/zhongbai2333/tomato-novel-downloader/blob/main/src/download/downloader.rs"
click node_third_party "https://github.com/zhongbai2333/tomato-novel-downloader/blob/main/src/download/third_party.rs"
click node_progress "https://github.com/zhongbai2333/tomato-novel-downloader/blob/main/src/download/progress.rs"
click node_book_manager "https://github.com/zhongbai2333/tomato-novel-downloader/blob/main/src/book_parser/book_manager.rs"
click node_parser "https://github.com/zhongbai2333/tomato-novel-downloader/blob/main/src/book_parser/parser.rs"
click node_epub "https://github.com/zhongbai2333/tomato-novel-downloader/blob/main/src/book_parser/epub_generator.rs"
click node_pdf "https://github.com/zhongbai2333/tomato-novel-downloader/blob/main/src/book_parser/finalize_pdf.rs"
click node_audio "https://github.com/zhongbai2333/tomato-novel-downloader/blob/main/src/book_parser/audio_generator.rs"
click node_config "https://github.com/zhongbai2333/tomato-novel-downloader/blob/main/src/base_system/context.rs"
click node_history "https://github.com/zhongbai2333/tomato-novel-downloader/blob/main/src/base_system/download_history.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_main,node_tui,node_legacy,node_web,node_web_router,node_web_routes,node_web_state toneBlue
class node_planner,node_network,node_library toneAmber
class node_downloader,node_third_party,node_progress,node_book_manager toneMint
class node_parser,node_epub,node_pdf,node_audio toneRose
class node_config,node_history,node_user,node_external_novel,node_external_tts toneIndigo
```

## Components

### User interfaces

- [Application entry](https://github.com/zhongbai2333/tomato-novel-downloader/blob/main/src/main.rs): `src/main.rs`
- [Interactive TUI](https://github.com/zhongbai2333/tomato-novel-downloader/tree/main/src/ui/tui): `src/ui/tui`
- [Legacy CLI](https://github.com/zhongbai2333/tomato-novel-downloader/tree/main/src/ui/noui): `src/ui/noui`
- [Web server](https://github.com/zhongbai2333/tomato-novel-downloader/tree/main/src/ui/web): `src/ui/web`
- [Web router](https://github.com/zhongbai2333/tomato-novel-downloader/blob/main/src/ui/web/router.rs): `src/ui/web/router.rs`
- [Web routes](https://github.com/zhongbai2333/tomato-novel-downloader/tree/main/src/ui/web/routes): `src/ui/web/routes`
- [Web task state](https://github.com/zhongbai2333/tomato-novel-downloader/blob/main/src/ui/web/state.rs): `src/ui/web/state.rs`

### Discovery and planning

- [Search and download plan](https://github.com/zhongbai2333/tomato-novel-downloader/blob/main/src/download/plan.rs): `src/download/plan.rs`
- [Novel web/API access](https://github.com/zhongbai2333/tomato-novel-downloader/blob/main/src/network_parser/network.rs): `src/network_parser/network.rs`

### Download runtime

- [Chapter download orchestration](https://github.com/zhongbai2333/tomato-novel-downloader/blob/main/src/download/downloader.rs): `src/download/downloader.rs`
- [Third-party content access](https://github.com/zhongbai2333/tomato-novel-downloader/blob/main/src/download/third_party.rs): `src/download/third_party.rs`
- [Download progress](https://github.com/zhongbai2333/tomato-novel-downloader/blob/main/src/download/progress.rs): `src/download/progress.rs`
- [Resume and chapter state](https://github.com/zhongbai2333/tomato-novel-downloader/blob/main/src/book_parser/book_manager.rs): `src/book_parser/book_manager.rs`

### Content outputs

- [Chapter content parser](https://github.com/zhongbai2333/tomato-novel-downloader/blob/main/src/book_parser/parser.rs): `src/book_parser/parser.rs`
- [EPUB generation](https://github.com/zhongbai2333/tomato-novel-downloader/blob/main/src/book_parser/epub_generator.rs): `src/book_parser/epub_generator.rs`
- [PDF finalization](https://github.com/zhongbai2333/tomato-novel-downloader/blob/main/src/book_parser/finalize_pdf.rs): `src/book_parser/finalize_pdf.rs`
- [Audiobook generation](https://github.com/zhongbai2333/tomato-novel-downloader/blob/main/src/book_parser/audio_generator.rs): `src/book_parser/audio_generator.rs`

### Shared services

- [Configuration and paths](https://github.com/zhongbai2333/tomato-novel-downloader/blob/main/src/base_system/context.rs): `src/base_system/context.rs`
- [Download history](https://github.com/zhongbai2333/tomato-novel-downloader/blob/main/src/base_system/download_history.rs): `src/base_system/download_history.rs`

### Other components

- **Reader / operator**
- **Novel service**
- **Microsoft Edge TTS**
- **Local download library**

## Connections

- Reader / operator → Application entry: starts
- Application entry → Web server: runs server (evidence: `src/main.rs`)
- Application entry → Legacy CLI: runs legacy UI (evidence: `src/main.rs`)
- Application entry → Interactive TUI: offers interactive UI
- Reader / operator → Web server: browses and submits
- Web server → Web router: routes requests (evidence: `src/ui/web/router.rs`)
- Web router → Web routes: dispatches (evidence: `src/ui/web/router.rs`)
- Web router → Web task state: uses state (evidence: `src/ui/web/router.rs`)
- Web task state → Chapter download orchestration: starts tasks (evidence: `src/ui/web/state.rs`)
- Web routes → Local download library: browses and serves files
- Interactive TUI → Chapter download orchestration: starts downloads (evidence: `src/ui/tui/download.rs`)
- Reader / operator → Search and download plan: requests search or preview
- Search and download plan → Novel web/API access: fetches metadata and chapters (evidence: `src/download/plan.rs`)
- Novel web/API access → Novel service: requests novel data
- Search and download plan → Chapter download orchestration: prepares plan (evidence: `src/download/downloader.rs`)
- Chapter download orchestration → Third-party content access: fetches content (evidence: `src/download/downloader.rs`)
- Chapter download orchestration → Chapter content parser: parses chapters (evidence: `src/download/downloader.rs`)
- Chapter download orchestration → Resume and chapter state: saves resume state (evidence: `src/download/downloader.rs`)
- Chapter download orchestration → Download progress: updates progress (evidence: `src/download/downloader.rs`)
- Chapter download orchestration → Download history: records downloads (evidence: `src/download/downloader.rs`)
- Chapter download orchestration → EPUB generation: finalizes output
- Chapter download orchestration → PDF finalization: finalizes output
- Chapter download orchestration → Audiobook generation: generates audiobook (evidence: `src/book_parser/audio_generator.rs`)
- Audiobook generation → Microsoft Edge TTS: synthesizes speech
- Audiobook generation → Resume and chapter state: uses downloaded chapters (evidence: `src/book_parser/audio_generator.rs`)
- Chapter download orchestration → Configuration and paths: uses download settings (evidence: `src/download/downloader.rs`)
- Search and download plan → Configuration and paths: uses output settings (evidence: `src/download/plan.rs`)
- Web routes → Configuration and paths: edits output settings (evidence: `src/ui/web/routes/preview.rs`)
- Web routes → Local download library: downloads files or ZIPs
