One-click app that translates manga, manhwa, manhua, and comics using ML models. Targets both speech bubbles and outside-bubble text, restores background art with diffusion-based inpainting, and typesets translations across 60+ languages using LLMs and custom fonts.
Original → Translated (One-Click)
- Portable Package (Recommended): Download the portable build from Releases.
- Windows: No requirements.
- Linux / macOS: Requires Python 3.10+ and Git.
- From Source:
git clone https://github.com/meangrinch/MangaTranslator.git cd MangaTranslator python -m venv venv .\venv\Scripts\activate # or source venv/bin/activate (Linux/macOS) pip install torch==2.11.0+cu130 torchvision==0.26.0+cu130 --extra-index-url https://download.pytorch.org/whl/cu130 # or pip install torch==2.11.0 torchvision==0.26.0 (macOS) pip install -r requirements.txt
For additional information, see Installation.
- Provider: In the Web UI, navigate to Config → Translation to select your LLM provider (e.g., Google, OpenAI, Anthropic, DeepSeek...) and enter your API key, or use a local OpenAI-compatible endpoint (e.g., llama.cpp). Save to config to persist API keys/settings across sessions.
- Outside-Bubble Text (Optional): Navigate to Config → OSB Text and set a Hugging Face token with access to deepghs/AnimeText_yolo.
- Environment Variables: Alternatively, you can configure credentials in your environment (e.g.,
GEMINI_API_KEY,HF_TOKEN) for both Web UI and CLI usage.
For additional information, see Configuration.
- Web UI: Upload images to the Translator/Batch tab and click Translate.
- CLI:
python main.py --input "path/to/page.jpg" --input-language "Japanese" --output-language "English" --font-dir "fonts/Komika Hand" --provider Google --google-api-key <...> --osb-enable --osb-font-dir "fonts/Comicka" --osb-hf-token <...>
For additional examples, see CLI.
Tip
You can enable Cleaning-only Mode by navigating to Config → Other in the Web UI, or pass --cleaning-only in the CLI, to remove text without translating (e.g., for manual scanlation).
- Automation: One-click translation; no manual intervention required
- Interfaces: Web UI (Gradio) and CLI
- Processing: Single image, folder, and ZIP archive batch processing (with directory preservation)
- Detection: Speech bubble and outside-bubble text detection (YOLO, SAM 2.1/3)
- Cleaning: Inpaint speech bubbles and background text (FLUX.2 Klein, FLUX.1 Kontext, or OpenCV)
- Translation: OCR and translation supporting 60+ languages (cloud API or local LLM)
- Rendering: Custom text rendering with alignment, word wrap, and custom font packs
- Upscaling: Text region and full-page artwork upscaling (2x-AnimeSharpV4)
- Configuration: Flexible controls to adapt to diverse page layouts and fine-tune output quality
MangaTranslator is open-source and free. If it saves you time or enhances your reading experience, consider supporting its development!
ML Models and Libraries
- YOLOv8m Speech Bubble Detector: kitsumed
- Manga109 Speech Bubble Detector: huyvux3005
- Comic Text and Bubble Detector RT-DETR-v2: ogkalu
- Manga109 YOLO: deepghs
- AnimeText YOLO: deepghs
- SAM 2.1: Meta AI
- SAM 3: Meta AI
- Manga OCR: kha-white
- PaddleOCR-VL-1.6: PaddlePaddle
- FLUX.1 Kontext: Black Forest Labs
- FLUX.2 Klein 4B: Black Forest Labs
- FLUX.2 Klein 9B: Black Forest Labs
- Nunchaku: Nunchaku AI
- SDNQ Quants: Disty0
- Unsloth Quants: Unsloth
- stable-diffusion.cpp: leejet
- 2x-AnimeSharpV4: Kim2091