How josuebarretogit/manga-tui works
Manga-tui is a terminal manga reader and downloader. Users select a provider, search or browse manga, open chapters in the reader, and can download chapters or whole series; reading history is stored locally, with optional AniList tracking. The README also documents provider filters, language selection, multiple download formats, and terminal image rendering. The graph preserves those capabilities, but several connections are dashed where the supplied excerpts and reference index do not establish exact runtime calls.
Main entry points: pages App pages · cli.rs CLI entry · backend.rs Backend setup · app.rs App controller
Components 24
Terminal experience
- CLI entry
src/cli.rs - TUI event loop
src/backend/tui.rs - App controller
src/view/app.rs - App pages
src/view/pages - View widgets
src/view/widgets.rs
Manga catalog
- Provider interface
src/backend/manga_provider.rs - MangaDex provider
src/backend/manga_provider/mangadex.rs - Other providers
src/backend/manga_provider - HTML parser
src/backend/html_parser.rs - Scraper adapter
src/backend/html_parser/scraper.rs
Reading and tracking
- History database
src/backend/database.rs - Download coordinator
src/backend/manga_downloader.rs - Download formats
src/backend/manga_downloader - Tracking interface
src/backend/tracker.rs - AniList integration
src/backend/tracker/anilist.rs
Runtime services
- Configuration
src/config.rs - Backend setup
src/backend.rs - Response cache
src/backend/cache.rs - Database migration
src/backend/migration.rs - Update notifier
src/backend/release_notifier.rs
Other components
- User
- Terminal
- Manga services
- AniList
Connections 24
- User → CLI entry: runs
- CLI entry → TUI event loop: starts
- TUI event loop → App controller: runs
src/backend/tui.rs - App controller → App pages: creates pages
src/view/app.rs - App controller → View widgets: renders
src/view/app.rs - Terminal → TUI event loop: sends input
src/backend/tui.rs - App pages → Provider interface: uses provider
src/view/pages/search.rs - Provider interface → MangaDex provider: dispatches to
src/backend/manga_provider.rs - Provider interface → Other providers: dispatches to
src/backend/manga_provider.rs - MangaDex provider → Manga services: requests data
- Other providers → Manga services: requests data
- Other providers → HTML parser: parses pages
src/backend/manga_provider/manganato/response.rs - HTML parser → Scraper adapter: implemented by
src/backend/html_parser.rs - App pages → History database: stores reading state
src/view/pages/search.rs - App pages → Download coordinator: requests downloads
- Download coordinator → Download formats: selects format
src/backend/manga_downloader.rs - App pages → Tracking interface: updates progress
src/view/pages/search.rs - Tracking interface → AniList integration: implemented by
src/backend/tracker.rs - AniList integration → AniList: syncs progress
- CLI entry → Configuration: reads options
src/cli.rs - Backend setup → Response cache: initializes
src/backend.rs - Backend setup → History database: initializes
src/backend.rs - Backend setup → Database migration: runs migrations
src/backend.rs - CLI entry → Update notifier: checks updates