# dmmaze/ballonstranslator

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/dmmaze-ballonstranslator).**

4,551 stars · 296 forks · Python · gpl-3.0

## Links

- GitHub: https://github.com/dmMaze/BallonsTranslator
- awesome-repositories: https://awesome-repositories.com/repository/dmmaze-ballonstranslator.md

## Topics

`auto-translation` `chinese-translation` `comics` `computer-aided-translation` `computer-vision` `deep-learning` `inpainting` `manga` `ocr` `pyqt` `pyqt6` `pytorch` `qt` `qt6` `scene-text-detection`

## Description

BallonsTranslator is a software suite designed for extracting, translating, and replacing text within comic panels while preserving the original visual layout. It functions as an image translation tool that combines text region detection, optical character recognition, and deep learning inpainting to automate the localization of comics.

The tool features a deep learning image inpainter that removes original text and restores backgrounds using generative neural networks and patch-matching algorithms. It also includes a rich-text translation editor for modifying translated dialogue with support for font presets, search-and-replace, and document exports.

The system provides a multi-engine OCR pipeline for extracting text and font colors, and a layout-aware replacement system that matches font sizes and positioning. For automated workflows, a headless command-line interface allows for batch image translation and rendering without a graphical user interface.

## Tags

### Graphics & Multimedia

- [Comic Panel Translators](https://awesome-repositories.com/f/graphics-multimedia/panel-detection-techniques/comic-panel-translators.md) — Detects, removes, and replaces text in comic panels using deep learning while preserving the original visual layout. ([source](https://cdn.jsdelivr.net/gh/dmmaze/ballonstranslator@dev/README.md))
- [Comic Text Extraction](https://awesome-repositories.com/f/graphics-multimedia/optical-character-recognition/comic-text-extraction.md) — Identifies text areas in comic panels using specialized models for Japanese and English. ([source](https://cdn.jsdelivr.net/gh/dmmaze/ballonstranslator@dev/README.md))

### Artificial Intelligence & ML

- [Image Inpainting](https://awesome-repositories.com/f/artificial-intelligence-ml/deep-learning-architectures/image-inpainting.md) — Ships a deep learning inpainting pipeline that removes text and restores comic backgrounds.
- [Image Text Translators](https://awesome-repositories.com/f/artificial-intelligence-ml/image-translation-pipelines/image-text-translators.md) — Extracts, translates, and replaces text in comic panels while preserving the original visual layout using deep learning inpainting.
- [Batch Processing](https://awesome-repositories.com/f/artificial-intelligence-ml/image-translation-pipelines/image-text-translators/batch-processing.md) — Automates the full translation pipeline across multiple images via a headless command-line interface.
- [Translation APIs](https://awesome-repositories.com/f/artificial-intelligence-ml/image-translation-pipelines/image-text-translators/translation-apis.md) — Provides a multi-engine translation abstraction that switches between cloud APIs and local models. ([source](https://cdn.jsdelivr.net/gh/dmmaze/ballonstranslator@dev/README.md))
- [OCR Pipelines](https://awesome-repositories.com/f/artificial-intelligence-ml/machine-learning/infrastructure/model-inference-serving/inference-engines/onnx-runtime-inference/ocr-pipelines.md) — Extracts text and font colors from comic panels using multiple recognition engines in an end-to-end pipeline.
- [OCR Engines](https://awesome-repositories.com/f/artificial-intelligence-ml/ocr-engines.md) — Extracts text from detected regions using multiple OCR engines with optional font name detection. ([source](https://cdn.jsdelivr.net/gh/dmmaze/ballonstranslator@dev/README.md))
- [Translation Editors](https://awesome-repositories.com/f/artificial-intelligence-ml/text-translation-tools/translation-editors.md) — Includes a rich-text translation editor with font presets, search-and-replace, and document exports.

### Part of an Awesome List

- [Text Detection Models](https://awesome-repositories.com/f/awesome-lists/ai/text-detection-models.md) — Uses specialized deep learning models to detect text regions in comic panels for Japanese and English.
- [Headless Batch Pipelines](https://awesome-repositories.com/f/awesome-lists/security/header-injection/header-injections-from-commands/headless-batch-pipelines.md) — Runs the full translation pipeline in headless batch mode via a configuration file. ([source](https://cdn.jsdelivr.net/gh/dmmaze/ballonstranslator@dev/README.md))
- [Translation Text Editors](https://awesome-repositories.com/f/awesome-lists/devtools/editing-and-text-manipulation/translation-text-editors.md) — Adjusts font formatting and style presets, and performs find-and-replace across source or translated text. ([source](https://cdn.jsdelivr.net/gh/dmmaze/ballonstranslator@dev/README.md))

### Data & Databases

- [Layout-Aware Replacement](https://awesome-repositories.com/f/data-databases/text-pattern-matching/text-search-and-replace/layout-aware-replacement.md) — Matches font sizes and positioning to insert translated dialogue while preserving original comic layout.

### Development Tools & Productivity

- [Headless Batch Pipelines](https://awesome-repositories.com/f/development-tools-productivity/command-line-interfaces/headless-batch-pipelines.md) — Runs the full translation pipeline in headless batch mode via a configuration file.