Doc-HTML-Translate.Document converter for Windows · GUI · CLI · Chromium extensionКонвертер документов для Windows · GUI · CLI · расширение ChromiumКонвертер документів для Windows · GUI · CLI · розширення Chromium
Turn any book, document or comic into a local web pageЛюбая книга, документ или комикс - в локальную веб-страницуБудь-яка книжка, документ чи комікс - у локальну вебсторінку
Read it, search it and translate it with your browser's native engine - free, private, no keys required.Читайте, ищите и переводите встроенным движком браузера - бесплатно, приватно, без ключей.Читайте, шукайте та перекладайте вбудованим рушієм браузера - безкоштовно, приватно, без ключів.
For anyone reading books and documents in another language: EPUB, PDF, MOBI, FB2, RTF, TXT, Markdown, HTML, comics, and images become local HTML with a table of contents and navigation. OCR is available for images.Для тех, кто читает книги и документы на чужом языке: EPUB, PDF, MOBI, FB2, RTF, TXT, Markdown, HTML, комиксы и изображения превращаются в локальный HTML с оглавлением и навигацией. Для изображений доступен OCR.Для тих, хто читає книжки й документи іншою мовою: EPUB, PDF, MOBI, FB2, RTF, TXT, Markdown, HTML, комікси та зображення перетворюються на локальний HTML зі змістом і навігацією. Для зображень доступний OCR.
EPUB / PDF / FB2 / CBZ / ..→local index.html→Chrome / Edge→reading and translationчтение и переводчитання й переклад
Demo, 42 seconds, no sound: converting a book, its table of contents, the reading themes and the text layer over a comic page. The captions in the video are in English.Демонстрация, 42 секунды, без звука: конвертация книги, оглавление, темы чтения и текстовый слой поверх страницы комикса. Подписи в кадре - на английском.Демонстрація, 42 секунди, без звуку: конвертація книжки, зміст, теми читання та текстовий шар поверх сторінки коміксу. Підписи в кадрі - англійською.
The desktop app (window + command line) and the browser extension install independently. Every option is free.Настольное приложение (окно + командная строка) и расширение для браузера устанавливаются независимо. Все варианты бесплатны.Настільний застосунок (вікно + командний рядок) і розширення для браузера встановлюються незалежно. Усі варіанти безкоштовні.
Install the app from the Microsoft Store, with winget or the setup installer - or download the portable zip from GitHub Releases.Установите приложение из Microsoft Store, через winget или установщиком; либо скачайте portable-архив из GitHub Releases.Встановіть застосунок із Microsoft Store, через winget або інсталятором - чи завантажте portable-архів із GitHub Releases.
Open a supported file in the app window, or with the command below.Откройте поддерживаемый файл в окне приложения или командой ниже.Відкрийте підтримуваний файл у вікні застосунку або командою нижче.
The app creates the HTML and opens it in the browser; translate it from the browser's Translate menu.Приложение создаст HTML и откроет его в браузере; перевод - через меню браузера «Перевести».Застосунок створить HTML і відкриє його у браузері; переклад - через меню браузера «Перекласти».
winget install SerZhyAle.DocHtmlTranslate
doc-html-translate.exe "book.epub"
ImportantВажноВажливо
By default, the app converts and opens the file without paid translation. Google Cloud and Ollama are separate modes described below.По умолчанию приложение конвертирует и открывает файл без платного перевода. Google Cloud и Ollama - отдельные режимы, описанные ниже.Типово застосунок конвертує й відкриває файл без платного перекладу. Google Cloud та Ollama - окремі режими, описані нижче.
Windows protected your PC?
The setup installer and the portable programs are not code-signed, so Windows SmartScreen may stop the first launch. Click More info, then Run anyway. The Microsoft Store version is signed by Microsoft and shows no such window. Why, and what the app never does.Установщик и portable-программы не подписаны сертификатом разработчика, поэтому Windows SmartScreen может остановить первый запуск. Нажмите «Подробнее», затем «Выполнить в любом случае». Версия из Microsoft Store подписана Microsoft и этого окна не показывает. Почему так и чего приложение никогда не делает.Інсталятор і portable-програми не підписані сертифікатом розробника, тому Windows SmartScreen може зупинити перший запуск. Натисніть More info, потім Run anyway (в українській Windows - їхній переклад). Версія з Microsoft Store підписана Microsoft і цього вікна не показує. Чому так і чого застосунок ніколи не робить.
#What's new in 26.1117.1450Что нового в 26.1117.1450Що нового в 26.1117.1450
The command line takes verbs: convert, output status, doctor, input check, ocr langs, ocr download, report build, integration add, default-handler set and default-handler release. Each ends with a fixed exit code and, with --result, writes a JSON record for a script; a call of commands lists them all, and every older flag keeps working. The full reference is docs/CLI.md.
The app window can be driven from the command line: open --in puts the documents you name into the queue of the window that is already open, show brings it forward, status says whether it is running, and quit closes it (it waits while a conversion runs, unless --cancel-runs is given). A second launch hands its files to the running window instead of opening another one.
On a touch screen, the icon-only buttons of the reader pages and of the extension viewer, and the help buttons in the extension options, show their name beside the icon.
Extension: an update applied while the browser was closed no longer makes the right-click menu rebuild fail with duplicate-id errors, and a tab closed during a page-OCR run no longer logs a "No tab with id" error on the extension's error page.
Командная строка принимает команды-глаголы: convert, output status, doctor, input check, ocr langs, ocr download, report build, integration add, default-handler set и default-handler release. Каждая завершается фиксированным кодом выхода и с --result записывает JSON-ответ для скрипта; команда commands перечисляет их все, а все прежние ключи продолжают работать. Полный справочник - docs/CLI.md.
Окном приложения можно управлять из командной строки: open --in кладёт названные документы в очередь уже открытого окна, show выводит его на передний план, status сообщает, запущено ли оно, а quit закрывает его (пока идёт конвертация, ждёт, если не указан --cancel-runs). Повторный запуск передаёт свои файлы работающему окну вместо открытия ещё одного.
На сенсорном экране кнопки без подписи на страницах для чтения и в просмотрщике расширения, а также кнопки справки в настройках расширения показывают своё название рядом со значком.
Расширение: обновление, применённое при закрытом браузере, больше не приводит к ошибкам «duplicate id» при перестроении контекстного меню, а вкладка, закрытая во время распознавания страницы, больше не пишет ошибку «No tab with id» на страницу ошибок расширения.
Командний рядок приймає команди-дієслова: convert, output status, doctor, input check, ocr langs, ocr download, report build, integration add, default-handler set і default-handler release. Кожна завершується фіксованим кодом виходу й з --result записує JSON-відповідь для скрипту; команда commands перелічує їх усі, а всі попередні ключі продовжують працювати. Повний довідник - docs/CLI.md.
Вікном застосунку можна керувати з командного рядка: open --in кладе названі документи в чергу вже відкритого вікна, show виводить його на передній план, status повідомляє, чи воно запущене, а quit закриває його (поки триває конвертація, чекає, якщо не вказано --cancel-runs). Повторний запуск передає свої файли працюючому вікну замість відкриття ще одного.
На сенсорному екрані кнопки без підпису на сторінках для читання й у переглядачі розширення, а також кнопки довідки в налаштуваннях розширення показують свою назву поряд зі значком.
Розширення: оновлення, застосоване за закритого браузера, більше не призводить до помилок «duplicate id» під час перебудови контекстного меню, а вкладка, закрита під час розпізнавання сторінки, більше не пише помилку «No tab with id» на сторінку помилок розширення.
#What it is forДля чего нуженДля чого потрібен
Four main workflows without depending on a particular reader or online service.Четыре основных сценария без привязки к конкретной читалке или онлайн-сервису.Чотири основні сценарії без прив’язки до конкретної читалки чи онлайн-сервісу.
READ
Open a book or documentОткрыть книгу или документВідкрити книжку чи документ
Get a local page with a table of contents, navigation, themes, and saved position.Получить локальную страницу с оглавлением, навигацией, темами и сохранением позиции.Отримати локальну сторінку зі змістом, навігацією, темами й збереженням позиції.
TRANSLATE
Translate in the browserПеревести в браузереПерекласти у браузері
Open the HTML in Chrome or Edge and use the browser's full-page translation.Открыть HTML в Chrome или Edge и использовать штатный перевод всей страницы.Відкрити HTML у Chrome або Edge й використати штатний переклад усієї сторінки.
OCR
Recognise text in an imageРаспознать текст на изображенииРозпізнати текст на зображенні
Add translatable text layers to a scan, image, or comic page. The plates cover the lettering they replace, and a button in the header hides the whole layer so you can look at the artwork underneath.Добавить переводимые текстовые слои к скану, изображению или странице комикса. Плашки закрывают буквы, которые заменяют, а кнопка в шапке прячет весь слой, чтобы посмотреть рисунок под ним.Додати перекладні текстові шари до скану, зображення чи сторінки коміксу. Плашки закривають літери, які замінюють, а кнопка у шапці ховає весь шар, щоб подивитися малюнок під ним.
LOCAL
Keep the result locallyСохранить результат локальноЗберегти результат локально
A normal folder with HTML and resources that can be moved and opened again.Обычная папка с HTML и ресурсами; её можно переносить и открывать повторно.Звичайна тека з HTML і ресурсами; її можна переносити й відкривати повторно.
#Ways to use itСпособы работыСпособи роботи
One converter through three interfaces.Один конвертер в трёх интерфейсах.Один конвертер у трьох інтерфейсах.
GUI
Desktop windowОкно приложенияВікно застосунку
Choose or drop a file, set options, and open the result.Выберите или перетащите файл, настройте параметры и откройте результат.Оберіть або перетягніть файл, налаштуйте параметри й відкрийте результат.
CLI
Command lineКомандная строкаКомандний рядок
Repeatable tasks, explicit options, output folders, and translation-engine selection.Повторяемые задачи, явные параметры, папки вывода и выбор движка перевода.Повторювані задачі, явні параметри, теки виводу й вибір рушія перекладу.
Converts a document directly in a tab without the desktop application. Extension pageПреобразует документ прямо во вкладке без установки настольного приложения. Страница расширенияПеретворює документ просто у вкладці без встановлення настільного застосунку. Сторінка розширення
#Details and guidesПодробности и инструкцииДеталі та інструкції
01
Formats and compatibilityФорматы и совместимостьФормати та сумісність
Supported formats are EPUB, PDF, TXT, Markdown, HTML, FB2, RTF, MOBI, AZW3, CBZ/CBR/CB7/CBT comics, and PNG/JPG/WebP/GIF/BMP/TIFF/JPEG XL images. MOBI/AZW3 need Calibre; CBR/CB7 need 7-Zip. DRM files are not supported.Поддерживаются EPUB, PDF, TXT, Markdown, HTML, FB2, RTF, MOBI, AZW3, комиксы CBZ/CBR/CB7/CBT и изображения PNG/JPG/WebP/GIF/BMP/TIFF/JPEG XL. Для MOBI/AZW3 нужен Calibre; CBR/CB7 требуют 7-Zip. DRM-файлы не поддерживаются.Підтримуються EPUB, PDF, TXT, Markdown, HTML, FB2, RTF, MOBI, AZW3, комікси CBZ/CBR/CB7/CBT і зображення PNG/JPG/WebP/GIF/BMP/TIFF/JPEG XL. Для MOBI/AZW3 потрібен Calibre; CBR/CB7 потребують 7-Zip. DRM-файли не підтримуються.
The interface speaks 13 languages: Интерфейс на 13 языках: Інтерфейс 13 мовами: en ru uk de it es fr pt ar hi bn ur zh. The app, the window and the extension follow your system language; Arabic and Urdu are laid out right to left. The interface language never changes the document's language - Chrome still offers to translate the page.Приложение, окно и расширение сами берут язык системы; арабский и урду отображаются справа налево. Язык интерфейса не меняет язык документа - Chrome по-прежнему предлагает перевести страницу.Застосунок, вікно й розширення самі беруть мову системи; арабська й урду відображаються справа наліво. Мова інтерфейсу не змінює мову документа - Chrome і далі пропонує перекласти сторінку.
The safe base route is local conversion and browser page translation. -google uses Google Cloud Translation API; -max-cost stops a request before sending when its estimate exceeds your limit. -ollama uses a local model. Images and OCR overlays need external Tesseract; if it is absent, conversion still completes.Безопасный базовый сценарий - локальная конвертация и перевод страницы силами браузера. Режим -google использует Google Cloud Translation API; ограничитель -max-cost отменяет запрос до отправки, если оценка превышает заданную сумму. -ollama использует локальную модель. Для изображений и OCR-слоёв нужен внешний Tesseract; если его нет, конвертация не прерывается.Безпечний базовий шлях - локальна конвертація та переклад сторінки силами браузера. -google використовує Google Cloud Translation API; -max-cost зупиняє запит до відправлення, якщо оцінка перевищує вказану суму. -ollama використовує локальну модель. Для зображень та OCR-шарів потрібен зовнішній Tesseract; без нього конвертація все одно завершується.
03
Full documentation, FAQ, and source codeПолная документация, FAQ и исходный кодПовна документація, FAQ та вихідний код
Press F1 or the ? button in the window for a help page about the part of the window you are in (English, Russian, Ukrainian).Нажмите F1 или кнопку ? в окне - откроется справка о той части окна, где вы находитесь (на английском, русском и украинском).Натисніть F1 або кнопку ? у вікні - відкриється довідка про ту частину вікна, де ви перебуваєте (англійською, російською та українською).
04
Release history and licenceИстория релизов и лицензияІсторія релізів і ліцензія
Something went wrong?Что-то пошло не так?Щось пішло не так?
The application can pack its own run logs and open a pre-addressed message to the author. Nothing leaves your machine until you press Send.Приложение умеет само упаковать свои журналы запусков и открыть готовое письмо автору. Ничего не покидает компьютер, пока вы не нажмёте «Отправить».Застосунок уміє сам запакувати свої журнали запусків і відкрити готового листа авторові. Ніщо не покидає комп'ютер, доки ви не натиснете «Надіслати».
Related toolСвязанный инструментПов’язаний інструмент
For individual images, scans, and media that you need to view or sort, use Fast Media Sorter & Sharing for Windows. It complements this tool rather than replacing it.Для отдельных изображений, сканов и медиа, которые нужно просмотреть или отсортировать, подходит Fast Media Sorter & Sharing for Windows. Он дополняет этот инструмент, а не заменяет его.Для окремих зображень, сканів і медіа, які потрібно переглянути чи відсортувати, підійде Fast Media Sorter & Sharing for Windows. Він доповнює цей інструмент, а не замінює його.