MangaTranslator

---

Quick Setup

1. Download

• Portable Package (Recommended): Download the portable build from Releases.
  • Windows: No requirements.
  • Linux / macOS: Requires Python 3.11+ 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.14.1+cu130 torchvision==0.29.1+cu130 --extra-index-url https://download.pytorch.org/whl/cu130 # or pip install torch==2.14.1 torchvision==0.29.1 (macOS)
  pip install -r requirements.txt
  

For additional information, see Installation.

2. Configure

• 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.

3. Translate

• 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).

---

Features

• Automation: One-click translation; no manual intervention required
• Interfaces: Web UI (Gradio) and CLI
• Processing: Single image, folder, and ZIP/CBZ 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 (Fibo 2.0, FLUX.3 Image Klein, Qwen-Image 2.1, FLUX.2 Klein, FLUX.1 Kontext, LaMa, 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

---

Documentation

• Hardware Requirements
• Installation
• Configuration
• CLI
• Fonts
• Troubleshooting

---

Support the Project

MangaTranslator is open-source and free. If it saves you time or enhances your reading experience, consider supporting its development!

---

License & Credits

• License: Apache-2.0 (see LICENSE)
• Author: grinnch

• YOLOv8m Speech Bubble Detector: kitsumed
• Manga109 Speech Bubble Detector: huyvux3005
• Manga109 YOLO: deepghs
• AnimeText YOLO: deepghs
• Comic Text and Bubble Detector RT-DETR-v2: ogkalu
• SAM 2.1: Meta AI
• SAM 3: Meta AI
• Manga OCR: kha-white
• PaddleOCR-VL-1.6: PaddlePaddle
• Koharu Text SAM-TS-L: mayocream
• LaMa Manga: mayocream
• FLUX.1 Kontext: Black Forest Labs
• FLUX.2 Klein 4B: Black Forest Labs
• FLUX.2 Klein 9B: Black Forest Labs
• FLUX.3 Image Klein: Black Forest Labs
• Fibo 2.0 Edit Turbo: Bria AI
• Qwen-Image-2.1-Turbo: Qwen
• 2x-AnimeSharpV4: Kim2091
• Nunchaku: Nunchaku AI
• SDNQ Quants: Disty0, OzzyGT, SamuelTallet
• stable-diffusion.cpp: leejet
• Unsloth Quants: Unsloth
• INT8 ConvRot Weights: Comfy-Org, ml-resources