Что это и зачем
Купил или скачал книгу не на своём языке - и упёрся в выбор: платить за перевод, мучиться со специальными читалками или читать как есть. doc-html-translate решает это самым дешёвым способом: превращает файл в обычный локальный HTML и отдаёт его браузеру, а перевод делает встроенный переводчик Chrome - бесплатно и для любого языка.
На вход - EPUB, PDF, MOBI, AZW3, FB2, RTF, TXT, Markdown и HTML. На выходе - папка с чистыми HTML-страницами, оглавлением и постраничной навигацией, которая сразу открывается в браузере. Текст остаётся текстом (не картинкой), поэтому браузер переводит его «на лету».
Это инструмент для Windows: есть командная строка (doc-html-translate) и оконное GUI-приложение (doc-html-ui) - выбирай, что удобнее.
Никакого API-ключа и платных вызовов в базовом сценарии. Конвертация локальная, перевод - средствами браузера. По желанию подключаются Google Cloud или локальная Ollama.
Три шага бесплатного чтения
Открой или запусти
Открой файл приложением или выполни простую команду. Перевод выключен, пока не добавишь -google или -ollama.
Читай в Chrome
Инструмент сам открывает сгенерированный index.html с оглавлением и навигацией по страницам.
Переводи в браузере
Включи встроенный перевод страницы в Chrome - и читай на любом нужном языке бесплатно.
# Быстрый бесплатный сценарий doc-html-translate.exe "book.epub" # или doc-html-translate.exe "book.pdf" # инструмент откроет index.html в браузере # в Chrome: «Перевести страницу» -> твой язык
Поддерживаемые форматы
Из коробки работают EPUB, TXT, FB2, RTF, HTML и Markdown. Для PDF используется встроенный движок (его можно усилить внешними утилитами - см. ниже). MOBI и AZW3 конвертируются через Calibre.
MOBI и AZW3 требуют установленного Calibre. Файлы с DRM не поддерживаются.
Установка и загрузка
Самый быстрый путь - winget:
winget install SerZhyAle.DocHtmlTranslate
Или возьми готовые бинарники Windows x64 со страницы релизов. Каждый релиз содержит:
doc-html-translate-<версия>-windows-x64.exe- инструмент командной строки;doc-html-ui-<версия>-windows-x64.exe- оконное GUI-приложение;...-windows-x64.zip- полный архив (оба бинарника + LICENSE + README).
Сборка из исходников (нужен Go):
go build -o build/doc-html-translate.exe ./cmd/doc-html-translate
Режимы перевода
- Браузер (по умолчанию, бесплатно): конвертация без перевода, дальше «Перевести страницу» в Chrome. Без ключей и оплаты.
- Google Cloud (
-google): перевод через Google Cloud Translation API. Положи файлgoogle_api.keyрядом с исполняемым файлом. - Локальная Ollama (
-ollama): перевод локальной моделью, полностью офлайн. Модель задаётся флагом-ollama-model(по умолчаниюgemma3:12b).
doc-html-translate.exe -src en -dst ru "book.epub" doc-html-translate.exe -google "book.epub" doc-html-translate.exe -ollama -ollama-model gemma3:12b "book.epub"
Основные флаги
| Флаг | По умолчанию | Что делает |
|---|---|---|
-notranslate | false | Только конвертация, без перевода |
-noopen | false | Не открывать браузер автоматически |
-google | false | Перевод через Google Cloud Translation API |
-ollama | false | Перевод через локальную Ollama |
-ollama-model | gemma3:12b | Имя модели Ollama |
-split | 5000 | Разбивать страницы по N символов (0 отключает) |
-folder | пусто | Своя родительская папка для вывода |
-src | en | Исходный язык |
-dst | ru | Целевой язык |
-force | false | Пересобрать, даже если вывод уже есть |
-register | false | Зарегистрировать как обработчик файлов (HKCU) |
Полный список флагов - в документации.
Дополнительные внешние утилиты
Приложение работает «из коробки» для EPUB, TXT, FB2, RTF, HTML и Markdown. Эти утилиты добавляют полноценную поддержку PDF-картинок и дополнительных форматов:
| Утилита | Зачем | Для чего нужна |
|---|---|---|
| pdftotext (Xpdf / Poppler) | Качественное извлечение текста из PDF: сложные шрифты, лигатуры, многоколоночная вёрстка | PDF - по желанию, есть встроенный запасной движок |
| ffmpeg | Конвертирует картинки JPEG 2000 (.jpx) из PDF в JPEG - браузеры не умеют JPEG 2000 | PDF с изображениями JPEG2000 |
| Calibre | Конвертирует MOBI / AZW3 в EPUB перед обработкой | Обязательна для MOBI и AZW3 |
Без pdftotext используется встроенный Go-движок (качество чуть ниже). Без ffmpeg картинки JPEG2000 в PDF не отобразятся. Без Calibre файлы MOBI/AZW3 не открыть.
Спутник: FastMediaSorter LITE
Нужно читать скриншоты, мангу, фото или сканы страниц - то, что является изображением, а не текстом? FastMediaSorter LITE - бесплатное приложение для Windows: открывает и сортирует картинки и видео и умеет OCR + перевод прямо на изображении. Нажми T на картинке - и поверх неё ляжет перевод (локальная Ollama или LibreTranslate). Это дополнение для случаев, которые doc-html-translate не покрывает: документы-картинки.
winget install SerZhyAle.FastMediaSorter
Ссылки и происхождение
- Репозиторий на GitHub
- Последний релиз
- Полная документация
- Universal Agent Kit - переносимый метод работы с ИИ-агентами
Проект под лицензией MIT.