[!IMPORTANT]
如打算公开分享本工具的机翻结果，且没有有经验的译者进行过完整的翻译或校对，请在显眼位置注明机翻。

BallonTranslator

简体中文 | English | pt-BR | Русский | 日本語 | Indonesia | Tiếng Việt | 한국어 | Español | Français

深度学习辅助漫画翻译工具，支持一键机翻和简单的图像/文本编辑

界面预览

Features

• 一键机翻

  • 译文回填参考对原文排版的估计，包括颜色，轮廓，角度，朝向，对齐方式等
  • 最后效果取决于文本检测，识别，抹字，机翻四个模块的整体表现
  • 支持日漫和美漫
  • 英译中，日译英排版已优化，文本布局以提取到的背景泡为参考，中文基于 pkuseg 进行断句，日译中竖排待改善

• 图像编辑
  支持掩膜编辑和修复画笔

• 文本编辑

  • 支持所见即所得地富文本编辑和一些基础排版格式调整、字体样式预设
  • 支持全文/原文/译文查找替换
  • 支持导入导出 word 文档

• 适用于条漫

使用说明

Windows

如果用 Windows 而且不想自己手动配置环境，而且能正常访问互联网:
从 MEGA 或 Google Drive 下载 BallonsTranslator_dev_src_with_gitpython.7z，解压并运行 launch_win.bat 启动程序。如果无法自动下载库和模型，手动下载 data 和 ballontrans_pylibs_win.7z 并解压到程序目录下。
运行 scripts/local_gitpull.bat 获取更新。 注意这些打包版无法在 Windows 7 上运行，win 7 用户需要自行安装 Python 3.8 运行源码。

运行源码

安装 Python <= 3.12 (别用微软应用商店版) 和 Git

# 克隆仓库
$ git clone https://github.com/dmMaze/BallonsTranslator.git ; cd BallonsTranslator

# 启动程序
$ python3 launch.py

# 更新程序
python3 launch.py --update

第一次运行会自动安装 torch 等依赖项并下载所需模型和文件，如果模型下载失败，需要手动从 MEGA 或 Google Drive 下载 data 文件夹(或者报错里提到缺失的文件)，并保存到源码目录下的对应位置。

构建 macOS 应用(适用 apple silicon 芯片)

参考
可能会有各种问题，目前还是推荐跑源码

一键翻译

建议在命令行终端下运行程序，首次运行请先配置好源语言/目标语言，打开一个带图片的文件夹，点击 Run 等待翻译完成

一键机翻嵌字格式如大小、颜色等默认是由程序决定的，可以在设置面板->嵌字菜单中改用全局设置。全局字体格式就是未编辑任何文本块时右侧字体面板显示的格式:

画板

修复画笔

修复画笔

矩形工具

矩形工具

按下鼠标左键拖动矩形框抹除框内文字，按下右键拉框清除框内修复结果。
抹除结果取决于算法(gif 中的"方法1"和"方法2")对文字区域估算的准确程度，一般拉的框最好稍大于需要抹除的文本块。两种方法都比较玄学，能够应付绝大多数简单文字简单背景，部分复杂背景简单文字/简单背景复杂文字，少数复杂背景复杂文字，可以多拉几次试试。
勾选"自动"拉完框立即修复，否则需要按下"修复"或者空格键才进行修复，或 Ctrl+D 删除矩形选框。

文本编辑

文本编辑

批量文本格式调整及自动排版

OCR并翻译选中文本框

界面说明及快捷键

• Ctrl+Z，Ctrl+Y 可以撤销重做大部分操作，注意翻页后撤消重做栈会清空
• A/D 或 pageUp/Down 翻页，如果当前页面未保存会自动保存
• T 切换到文本编辑模式下(底部最右"T"图标)，W激活文本块创建模式后在画布右键拉文本框
• P 切换到画板模式，右下角滑条改原图透明度
• 标题栏->运行 可以启用/禁用任意自动化模块，全部禁用后Run会根据全局字体样式和嵌字设置重新渲染文本
• 设置面板配置各自动化模块参数
• Ctrl++/- 或滚轮缩放画布
• Ctrl+A 可选中界面中所有文本块
• Ctrl+F 查找当前页，Ctrl+G全局查找
• 0-9调整嵌字/原图透明度
• 文本编辑下 Ctrl+B 加粗，Ctrl+U 下划线，Ctrl+I 斜体
• 字体样式面板-"特效"修改透明度添加阴影
• Alt+Arrow Keys 或 Alt+WASD (正在编辑文本块时 pageDown 或 pageUp) 在文本块间切换

命令行模式 (无GUI)

python launch.py --headless --exec_dirs "[DIR_1],[DIR_2]..."

所有设置 (如检测模型, 原语言目标语言等) 会从 config/config.json 导入。
如果渲染字体大小不对, 通过 --ldpi 指定 Logical DPI 大小, 通常为 96 和 72。

自动化模块

本项目重度依赖 manga-image-translator，在线服务器和模型训练需要费用，有条件请考虑支持一下

• Ko-fi: https://ko-fi.com/voilelabs
• Patreon: https://www.patreon.com/voilelabs
• 爱发电: https://afdian.net/@voilelabs

Sugoi 翻译器作者: mingshiba

文本检测

• 暂时仅支持日文(方块字都差不多)和英文检测，训练代码和说明见https://github.com/dmMaze/comic-text-detector
• 支持使用 星河云(团子漫画OCR)的文本检测，需要填写用户名和密码，每次启动时会自动登录。
  • 详细说明见 团子OCR说明
• YSGDetector 是由 lhj5426 训练的模型，能更好地过滤日漫/CG里的拟声词。需要手动从 YSGYoloDetector 下载模型放到 data/models 目录下。

OCR

• 所有 mit 模型来自 manga-image-translator，支持日英汉识别和颜色提取
• manga_ocr 来自 kha-white，支持日语识别，注意选用该模型程序不会提取颜色
• PaddleOCRVLManga 支持日语识别，选用该模型程序不会提取颜色
• 支持使用 星河云(团子漫画OCR)的OCR，需要填写用户名和密码，每次启动时会自动登录。
  • 目前的实现方案是逐个textblock进行OCR，速度较慢，准确度没有明显提升，不推荐使用。如果有需要，请使用团子Detector。
  • 推荐文本检测设置为团子Detector时，将OCR设为none_ocr，直接读取文本，节省时间和请求次数。
  • 详细说明见 团子OCR说明
• OCR设置项: 字体识别。把字体识别模型（YuzuMarker.FontDetection）下载下来放在data\models\YuzuMarker.FontDetection目录下。 需要的三个文件分别是data\models\YuzuMarker.FontDetection\font_dataset ， data\models\YuzuMarker.FontDetection\name=4x-epoch=18-step=368676.ckpt， data\font_demo_cache.bin
  识别到的置信率大于60%的字体名称会保存在json文件的_detected_font_name字段中。目前没做可视化外显，使用脚本导出LabelPlus txt时可选带上字体字号信息，导入到其他软件（如PS/ID）嵌字用。

图像修复

• AOT 修复模型来自 manga-image-translator
• patchmatch 是非深度学习算法，也是PS修复画笔背后的算法，实现来自 PyPatchMatch，本程序用的是我的修改版
• lama* 是微调过的lama

翻译器

• 谷歌翻译器已经关闭中国服务，大陆再用需要设置全局代理，并在设置面板把 url 换成*.com
• 彩云，需要申请 token
• papago
• DeepL 和 Sugoi (及它的 CT2 Translation 转换)翻译器，感谢 Snowad14，如果要使用Sugoi翻译器(仅日译英)，下载离线模型，将 sugoi_translator 移入 BallonsTranslator/ballontranslator/data/models。
• 支持 Sakura-13B-Galgame。如果在本地单卡上运行且显存不足，可以在设置面板里勾选 low vram mode (默认启用)。
• DeepLX 请参考Vercel 或 deeplx
• 支持两个版本的 OpenAI 兼容翻译器，支持兼容 OpenAI API 的官方或第三方LLM提供商，需要在设置面板里配置。
  • 无后缀版本token消耗更小，但分句稳定性稍差，长文本翻译可能有问题。
  • exp后缀版本token消耗更大，但稳定性更好，且在Prompt中进行了“越狱”，适合长文本翻译。
• m2m100: 下载并将 m2m100-1.2B-ctranslate2 移到 data/models 目录下

其它优秀的离线英文翻译模型请参考这条讨论
如需添加新的翻译器请参考加别的翻译器，本程序添加新翻译器只需要继承基类实现两个接口即可不需要理会代码其他部分，欢迎大佬提 pr

杂

• 电脑带 Nvidia 显卡或 Apple silicon 默认启用 GPU 加速
• 感谢 bropines 提供俄语翻译
• 第三方输入法可能会造成右侧编辑框显示 bug，见#76，暂时不打算修
• 选中文本迷你菜单支持聚合词典专业划词翻译沙拉查词: 安装说明

  原文件名 → 新文件名

  cublas.dll → cublas64_11.dll

  cusparse.dll → cusparse64_11.dll

  nvrtc.dll → nvrtc64_112_0.dll

BallonsTranslator 快速上手指南

BallonsTranslator 是一款基于深度学习的漫画翻译辅助工具，支持一键机翻、文本检测、图像修复及富文本编辑，适用于日漫和美漫的汉化工作。

环境准备

系统要求

• 操作系统: Windows 10/11 (推荐), macOS (Apple Silicon), Linux
• Python 版本: Python 3.8 - 3.12 (注意: 请勿使用微软应用商店版的 Python)
• 硬件加速:
  • NVIDIA 显卡或 Apple Silicon 芯片默认启用 GPU 加速
  • AMD 显卡需额外配置 (详见官方文档)
• 网络: 首次运行需联网下载模型和依赖库

前置依赖

• Git: 用于克隆代码仓库
• 基础运行库: 程序会自动安装 torch 等核心依赖

安装步骤

方法一：Windows 免配置启动（推荐新手）

如果你使用 Windows 且希望避免手动配置环境：

1. 下载打包文件：

   • MEGA 下载链接
   • 或 Google Drive 下载链接
   • 文件名：BallonsTranslator_dev_src_with_gitpython.7z

2. 解压文件并双击运行 launch_win.bat 启动程序。

3. 若自动下载失败：

   • 手动下载 data 文件夹和 ballontrans_pylibs_win.7z。
   • 将其解压到程序根目录下。

4. 更新程序： 运行 scripts/local_gitpull.bat 获取最新版本。

注意: 打包版不支持 Windows 7。Win7 用户请使用方法二自行安装 Python 3.8 运行源码。

方法二：源码运行（通用）

1. 安装依赖软件：

   • 安装 Python (版本 <= 3.12)
   • 安装 Git

2. 克隆仓库并启动：

   # 克隆仓库
   git clone https://github.com/dmMaze/BallonsTranslator.git
   cd BallonsTranslator
   
   # 启动程序（首次运行会自动安装依赖并下载模型）
   python3 launch.py
   

3. 模型下载失败处理： 如果自动下载模型失败，请手动从上述 MEGA 或 Google Drive 链接下载 data 文件夹，并将其放置在源码根目录下。

4. 更新程序：

   python3 launch.py --update
   

基本使用

1. 一键机翻

这是最核心的功能，可自动完成检测、识别、抹字和翻译回填。

1. 启动程序：建议在命令行终端运行 python3 launch.py 以便查看日志。
2. 加载图片：打开包含漫画图片的文件夹。
3. 配置语言：在设置面板中确认“源语言”和“目标语言”（如：日语 -> 中文）。
4. 执行翻译：点击界面上的 Run 按钮。
   • 程序将自动执行文本检测、OCR、背景修复和译文回填。
   • 回填效果会参考原文的颜色、轮廓、角度和对齐方式。

2. 图像与文本编辑

机翻完成后，通常需要进行人工校对和精修。

• 修复画笔 (Inpainting):

  • 使用矩形工具框选需要抹除的文字区域。
  • 按下鼠标左键拖动框选，松开后自动修复（或按空格键/"修复"按钮）。
  • 若效果不佳，可尝试调整框选范围稍大于文字块，或切换修复算法。

• 文本编辑:

  • 按 T 键或点击底部"T"图标进入文本编辑模式。
  • 支持富文本编辑（加粗 Ctrl+B、斜体 Ctrl+I、下划线 Ctrl+U）。
  • 支持批量调整字体样式和自动排版。
  • 可按 Ctrl+F 查找替换全文内容。

• 快捷键速查:

  • A / D 或 PageUp / PageDown: 翻页（未保存时自动保存）。
  • Ctrl + Z / Ctrl + Y: 撤销 / 重做。
  • Ctrl + 滚轮: 缩放画布。
  • P: 切换画板模式（调整原图透明度）。
  • Alt + 方向键: 在文本块间快速切换。

3. 导出结果

• 编辑完成后，可直接截图或使用内置功能导出。
• 支持导入/导出 Word 文档进行协作校对。
• 支持导出带有字体信息的 LabelPlus txt 文件，便于在 PS 等专业软件中进一步嵌字。

重要提示: 若公开分享机翻结果且未经人工完整校对，请务必在显眼位置注明“机翻”。