manga-translator-ui — What is it?

hgmzhn/manga-translator-ui is an open-source manga translation tool that automates the process of detecting, translating, and editing text in manga images, supporting multiple languages and translation engines.

⭐ 2,141 Stars 🍴 98 Forks Python GPL-3.0 Author: hgmzhn
Source: Official README and linked documentation View on GitHub →

Why it matters

The project is being discussed because its coverage to manga translation, offering built-in OCR and translation engines, a visual editor for text styling, and support for various manga styles. Its integration with popular models and its user-friendly interface make it a standout choice for manga enthusiasts and translators.

Source: Official README and linked documentation

Core Features

Translation Functionality

Automatically detects text in manga images, supports multiple languages, and integrates various translation engines like OpenAI and Gemini. It also offers high-quality translations with AI-powered features like term extraction and multi-modal image processing.

Source: Official README and linked documentation
Formatting and Rich Text

Features intelligent bubble formatting, Chinese semantic sentence splitting, AI-based intelligent line breaking, and full rich text editing capabilities, including font management and style application.

Source: Official README and linked documentation
Visual Editor

A visual editor for text manipulation, including moving, rotating, and deforming text boxes, manual translation, and full rich text editing with features like bold, color, and stroke adjustments.

Source: Official README and linked documentation
Batch and Automation

Supports batch processing of entire folders, batch management for text replacement and styling, PSD export, JSON/TXT import/export, command-line mode, and web UI for account and quota management.

Source: Official README and linked documentation

Architecture

The architecture is modular, with distinct components for OCR, translation, editing, and user interface. It use various design patterns such as MVC for the editor and dependency injection for managing dependencies. The data flow is structured, with clear separation between image processing, text detection, translation, and rendering.

Source: Official repository tree and dependency files

Project Knowledge Graph

Knowledge graph: project (center) + core features (inner hexagons) + key dependencies (outer chips) PaddleOCR MangaJaNai Real-CUGAN ultralytics transformers Translation FunctionalityTranslation Functio… Formatting and Rich TextFormatting and Rich… Visual Editor Batch and Automation manga-translator-ui Project Core feature Key dependency

Tech Stack

LanguagePythonFrameworkPyQt6, FastAPI, aiohttp, and others
PaddleOCRMangaJaNaiReal-CUGANultralyticstransformers
Docker, Web UI, and command-line interface
Source: Official repository tree and dependency files

Quick Start

Windows: Download the portable package, extract it, run Win-Install-or-Update.bat, and then double-click Win-Start.bat. Linux/macOS: Run 'mkdir -p ~/manga-translator-ui && cd ~/manga-translator-ui; curl -L -O https://raw.githubusercontent.com/hgmzhn/manga-translator-ui/main/Unix-Install-or-Update.sh; chmod +x Unix-Install-or-Update.sh &&./Unix-Install-or-Update.sh;./Unix-Start.sh'. Docker: 'docker run -d --name manga-translator -p 8000:8000 --restart unless-stopped -v manga-translator-models:/app/models -v manga-translator-fonts:/app/fonts -v manga-translator-dict:/app/dict -v manga-translator-config:/app/config -v manga-translator-server:/app/manga_translator/server/data -v manga-translator-logs:/app/logs -v manga-translator-result:/app/result hgmzhn/manga-translator:latest-cpu'.
Source: Official README and linked documentation

Use Cases

The project is suitable for manga enthusiasts, translators, and anyone involved in the localization of manga content. It is useful for automating the translation and editing process, improving efficiency, and ensuring consistency in translations.

Source: Official README and linked documentation

Strengths & Limitations

Strengths

  • Strengths: broad translation and editing features, support for multiple languages and engines, user-friendly interface, and integration with capable models for high-quality translations.

Limitations

  • Limitations: May require specific hardware configurations for certain features, and the complexity of the tool might be overwhelming for some users.
Source: Official README and linked documentation

Latest Release

The latest stable release is v3.0.4. GitHub published the release on 2026-09-06, while its body labels the version date as 2026-08-29. It mainly adds patch layers to the editor and fixes AVIF and EPUB handling, font refresh, masks, translation dispatch, and error classification for online components.

Source: github.com/hgmzhn/manga-translator-ui/releases/tag/v3.0.4

Verification and evidence

status: docs-only  |  checked_at: 2026-09-23  |  environment: Reviewed the official README, v3.0.4 release, English installation, features, usage, settings, CLI, workflow, and development documentation,.gitignore, GPL-3.0 license, and the upstream manga-image-translator project. No portable package, model, or container was downloaded.  |  limitations: Release hashes, installation scripts, GPU or ROCm behavior, model downloads, API key storage, translation quality, PSD and EPUB handling, web authentication, proxy behavior, resource usage, and cost were not tested.  |  observed_output: The official repository marks v3.0.4 as latest. GitHub published it on 2026-09-06, while the release body gives 2026-08-29 as the release date. The documentation lists nine workflows, a Qt editor, local and online OCR, and Docker port 8000.

Source: github.com/hgmzhn/manga-translator-ui/releases/tag/v3.0.4;https://git…

Comparison

Compared with the upstream manga-image-translator, manga-translator-ui continues to use the same kinds of detection, OCR, translation, inpainting, and rendering stages, while adding PyQt6 rich-text editing, API management, project files, patches, multiple import and export paths, and a desktop installation experience. The upstream project is oriented more toward the CLI and web inference core and its server interface. Choose the UI when manual page-by-page editing is needed. Evaluate the upstream project first when embedding the engine in another service or reducing desktop dependencies.

Source: github.com/hgmzhn/manga-translator-ui;https://github.com/zyddnys/mang…

Verdict

hgmzhn/manga-translator-ui is a feature-rich tool for manga translation and editing, suitable for users who require advanced text detection, translation, and styling capabilities. Its integration with capable models and user-friendly interface make it a valuable asset for manga enthusiasts and professionals in the localization industry.

Frequently Asked Questions

What did the documentation review verify for manga-translator-ui on 2026-09-23?

The official repository marks v3.0.4 as latest. GitHub published it on 2026-09-06, while the release body gives 2026-08-29 as the release date. The documentation lists nine workflows, a Qt editor, local and online OCR, and Docker port 8000.

What evidence boundary applies to this manga-translator-ui review?

The review environment was: Reviewed the official README, v3.0.4 release, English installation, features, usage, settings, CLI, workflow, and development documentation,.gitignore, GPL-3.0 license, and the upstream manga-image-translator project. No portable package, model, or container was downloaded.

Sources and review scope
This review is based on the project's public documentation. Versions, installation commands, and feature boundaries can change upstream; check the cited sources and current release before use. Sources checked on: 2026-09-23 13:55.

Reference materials: README, GitHub API, dependency files