Open-source offline translation library for Python, usable as a library, command-line tool, or GUI, built on OpenNMT models.
sokcuri/hdTrans
An offline, rule-based Japanese-to-Korean translator with a bundled dictionary, Windows GUI, CLI, and hooks for ezTrans-compatible tools.
Open-source alternative to:ezTrans
- Stars
- 91
- Forks
- 5
- Open issues
- 1
- Last commit
- 2 days ago
What is it?
hdTrans is an offline Japanese-to-Korean translation program built on a rule-based engine and a bundled dictionary, so it works without a network connection once extracted. It ships as a Windows release with a translation window and document translation, as well as a command-line tool for Windows, Linux and macOS. It can also be installed from npm as a CLI or as a JavaScript/TypeScript library that runs a WASM engine.
The project targets common Japanese-to-Korean output problems, such as mistranslated onomatopoeia, interjections and ambiguous words, using user dictionaries and rule tweaks. A speech-style option switches sentence endings between formal-plain '-다' and casual speech, and the document mode uses surrounding lines for context such as names and multi-line quotes.
For Windows users, the native engine can be connected to visual novel and game translation tools that work with ezTrans-style engines. Users can add their own entries through a tab-separated UTF-8 user dictionary.
Key features
- 01Offline translation with a bundled dictionary and engine.
- 02Windows translation window with document translation for multiple files.
- 03Command-line tool with UTF-8 input and output files.
- 04npm package with a JavaScript and TypeScript API.
- 05Switchable strict and soft speech styles for sentence endings.
- 06Tab-separated user dictionary for custom term translations.
Use cases
- Translating Japanese novels, documents or text files into Korean offline.
- Adding Korean translation to Japanese visual novels or games through compatible tools.
- Calling Japanese-to-Korean translation from a Node.js or TypeScript application.
- Fixing recurring mistranslations by adding entries to a personal dictionary.
Quick start
- 1
Install the command-line tool with npm (requires Node.js 22 or later)
npm install -g hdtrans - 2
Translate a UTF-8 Japanese text file into Korean
hdtrans --in input.ja.txt --out output.ko.txt - 3
Or on Windows, download the hdTrans zip from the Releases page and run hdTransGUI.exe
Things to know
- It translates only Japanese to Korean.
- It is rule-based, so output quality varies with sentence style and dictionary coverage.
- The Windows GUI and ezTrans-compatible engine are Windows-only.
- It is licensed under MPL-2.0, a copyleft license that requires sharing changes to modified MPL-covered files.
In collections
Topics
FAQ
- What is hdTrans?
- An offline, rule-based Japanese-to-Korean translator with a bundled dictionary, Windows GUI, CLI, and hooks for ezTrans-compatible tools. hdTrans is an offline Japanese-to-Korean translation program built on a rule-based engine and a bundled dictionary, so it works without a network connection once extracted. It ships as a Windows release with a translation window and document translation, as well as a command-line tool for Windows, Linux and macOS. It can also be installed from npm as a CLI or as a JavaScript/TypeScript library that runs a WASM engine.
- Is hdTrans free to use? What license does it have?
- hdTrans is open source under the MPL-2.0 license. Check the license terms before using it in commercial products.
- Is hdTrans still maintained?
- Actively maintained. The last commit to hdTrans was on Nov 6, 2026.
- What can I use hdTrans for?
- Translating Japanese novels, documents or text files into Korean offline. Adding Korean translation to Japanese visual novels or games through compatible tools. Calling Japanese-to-Korean translation from a Node.js or TypeScript application. Fixing recurring mistranslations by adding entries to a personal dictionary.
- How do I install hdTrans?
- Install the command-line tool with npm (requires Node.js 22 or later): npm install -g hdtrans Translate a UTF-8 Japanese text file into Korean: hdtrans --in input.ja.txt --out output.ko.txt Or on Windows, download the hdTrans zip from the Releases page and run hdTransGUI.exe
- Where can I get hdTrans?
- The source code and installation instructions are on GitHub: https://github.com/sokcuri/hdTrans
Summary generated by AI from the project's README. GitHub stats refresh daily.
Related projects
An open-source pixel font covering Latin and CJK (Chinese, Japanese, Korean) characters, in a sans-serif gothic style.
An Agent Skill that rewrites AI-generated Japanese work documents into natural, readable prose without adding facts or changing certainty.
A visual novel translator that extracts game text via hooks or OCR and translates it with many engines, including LLMs and offline models.
A curated list of Japanese NLP resources covering Python libraries, LLMs, dictionaries, corpora and datasets, plus Claude Code and Codex skills for searching them.
Desktop app that transcribes and translates audio and video offline on your computer, built on OpenAI's Whisper.