wingetCollections
  • Auto
  • Search
  • Awesome Collections
  • Awesome Programs
  • My Favorite Collections
  • My Collections
  • Account / Settings
  • Terms of Service
  • Privacy
  • About

© 2026 winget.ragerworks.com

Loading...
Install doc-html-translate using Winget - wingetCollections
  1. Go back
  2. Packages
  3. doc-html-translate
doc-html-translate logo

doc-html-translate SZA

azw3 cli convert ebook epub fb2 google-translate html markdown mobi ollama pdf rtf translation txt windows
Use this command to install doc-html-translate:
winget install --id=SerZhyAle.DocHtmlTranslate -e

doc-html-translate is a Windows command-line tool that converts documents (EPUB, PDF, TXT, Markdown, FB2, RTF, HTML, MOBI, AZW3) into local HTML with generated navigation and a table of contents. It can optionally translate extracted text via the Google Cloud Translation API or a local Ollama model. Re-opening an already-converted book is instant. The package ships both the CLI (doc-html-translate) and a small GUI launcher (doc-html-ui). pdftotext is bundled inside the binary; MOBI and AZW3 conversion additionally requires Calibre to be installed (non-DRM files only).

README

doc-html-translate

Project Links

  • GitHub Pages: https://serzhyale.github.io/doc-html-translate/
  • GitHub Repository: https://github.com/SerZhyAle/doc-html-translate

Windows-focused Go CLI that converts documents to local HTML and optionally translates extracted text.

Features

  • Convert: EPUB, PDF, TXT, Markdown, FB2, RTF, HTML, MOBI, AZW3
  • Local HTML output with generated navigation and TOC
  • Optional translation:
    • Google Cloud Translation API (-google)
    • Local Ollama (-ollama)
  • Re-open existing extracted book instantly (idempotent behavior)
  • Optional Windows file association registration (-register)
  • MOBI/AZW3: requires Calibre installed (non-DRM files only)

Installation

Build from source:

go build -o build/doc-html-translate.exe ./cmd/doc-html-translate

Or use project scripts:

./scripts/build.ps1

Download Application

Prebuilt application files are published in the repository build folder:

  • https://github.com/SerZhyAle/doc-html-translate/tree/master/build

Direct expected binary path:

  • https://github.com/SerZhyAle/doc-html-translate/blob/master/build/doc-html-translate.exe

Quick Usage

# Default open flow: convert + open in browser (no translation unless -google or -ollama is set)
doc-html-translate.exe "book.epub"

# Convert + Google translation
doc-html-translate.exe -google "book.epub"

# Convert + Ollama translation
doc-html-translate.exe -ollama -ollama-model gemma3:12b "book.epub"

# Specify language direction
doc-html-translate.exe -src en -dst ru "book.epub"

# Put output under a custom folder
doc-html-translate.exe -folder "D:\out" "book.pdf"

# Force full rebuild even if output already exists
doc-html-translate.exe -force "book.epub"

# Register as handler in current user registry
doc-html-translate.exe -register

Fastest Free Workflow (Recommended)

The most convenient scenario for many users is:

Versions
26.0428.0237
26.0427.1713
Website
github.com
License
Last updated
4/28/2026
Download latest version
  1. Open the file with the app or run the default command:
doc-html-translate.exe "book.epub"

or

doc-html-translate.exe "book.pdf"
  1. Let the tool open index.html in Chrome.
  2. Use Chrome built-in page translation to your language.

-notranslate is still available, but it is only the explicit form of the default non-API flow.

Why this workflow is popular:

  • Free (no Google Cloud API billing)
  • Fast to start (single command)
  • Comfortable reading flow in browser with page navigation

Flags

FlagDefaultDescription
-registerfalseRegister app as document handler in HKCU
-notranslatefalseConvert only, skip translation
-noopenfalseDo not open browser after conversion
-googlefalseTranslate via Google Cloud Translation API
-ollamafalseTranslate via local Ollama
-freefalseAlias of -ollama
-ollama-modelgemma3:12bOllama model name
-ollama-parallel1Parallel batch requests
-ollama-ctx8192Ollama context size
-split5000Split pages at N chars (0 disables split)
-folderemptyOutput parent folder
-forcefalseRe-extract and re-translate even if output exists
-vfalseVerbose output
-srcenSource language
-dstruTarget language
-versionfalsePrint version and exit

Google API Key

For -google, place google_api.key next to the executable.

Example file contents:

AIzaSy...your_key_here...

If the file is missing/empty, the app logs a warning and skips translation.

Behavior Notes

  • Output directory name is derived from input filename and sanitized for Windows compatibility.
  • Existing extracted output with index.html is reused unless -force is set.
  • PDF extraction is best-effort and includes fallback flows for difficult files.

Development

./scripts/test.ps1
./scripts/lint.ps1
./scripts/check.ps1

Main entry points:

  • cmd/doc-html-translate/main.go
  • internal/pipeline/pipeline.go
  • internal/pdf/extract.go
  • internal/translator/translator.go

License

This project is licensed under the MIT License. See LICENSE for details.