How meangrinch/mangatranslator works
MangaTranslator is a manga/comic image translation application with Web UI and CLI entry points. Users provide pages or batches, configure languages and translation/model options, and receive cleaned, translated, typeset images. The documented processing covers speech-bubble and outside-text detection, OCR, inpainting, LLM translation, rendering, and optional upscaling. The pipeline is the central orchestrator. Relationships below are limited to README statements and SOURCE INDEX references; unsampled implementation details are not assumed.
Main entry points: pipeline.py Translation pipeline · main.py CLI · logic.py UI actions · batch_coordinator.py Batch coordination
Components 20
User interfaces
- Web UI
ui/layout.py - CLI
main.py - UI actions
ui/logic.py
Image workflow
- Batch coordination
core/batch_coordinator.py - Translation pipeline
core/pipeline.py - Text detection
core/image/detection.py - OCR
core/image/ocr_detection.py - Outside text
core/outside_text_processor.py - Image cleaning
core/image/cleaning.py - Inpainting
core/image/inpainting.py - Text translation
core/services/translation.py - Text rendering
core/text/text_renderer.py - Image upscaling
core/scaling.py - Translated images
Models and services
- Model manager
core/ml/model_manager.py - LLM providers
utils/endpoints
Configuration and support
- Processing config
core/config.py - Saved settings
ui/settings_manager.py - Processing cache
core/caching.py
Other components
- User
Connections 24
- User → Web UI: uploads pages
README.md - User → CLI: supplies input
README.md - Web UI → UI actions: starts translation
ui/layout.py - UI actions → Translation pipeline: runs pipeline
ui/logic.py - CLI → Translation pipeline: runs pipeline
main.py - UI actions → Batch coordination: coordinates batches
- Translation pipeline → Batch coordination: coordinates batches
core/pipeline.py - Translation pipeline → Text detection: detects text
core/pipeline.py - Translation pipeline → OCR: uses OCR
- Translation pipeline → Outside text: processes outside text
core/pipeline.py - Translation pipeline → Image cleaning: cleans regions
core/pipeline.py - Image cleaning → Inpainting: uses inpainting
core/image/cleaning.py - Translation pipeline → Text translation: translates text
core/pipeline.py - Text translation → LLM providers: dispatches requests
core/services/translation.py - Translation pipeline → Text rendering: renders translations
core/pipeline.py - Translation pipeline → Image upscaling: upscales images
core/pipeline.py - Text detection → Model manager: loads models
core/image/detection.py - Inpainting → Model manager: loads models
core/image/inpainting.py - Outside text → OCR: uses OCR
core/outside_text_processor.py - Translation pipeline → Processing cache: uses cache
core/pipeline.py - Translation pipeline → Processing config: uses settings
core/pipeline.py - Saved settings → Processing config: validates settings
ui/settings_manager.py - Translation pipeline → Translated images: produces images
README.md - CLI → Batch coordination: processes archives
main.py