DualScribe – Effortless Bilingual Text Alignment for Chinese Learners
[
DualScribe is a desktop app designed for learners and language enthusiasts who want to deeply engage with Chinese text. Whether you’re studying Mandarin, preparing lessons, or simply curious about Chinese literature, DualScribe helps you effortlessly transform raw Chinese content into aligned, learner-friendly formats.
🚀 What is DualScribe?
DualScribe takes in Chinese .txt
files or pasted content, and auto-generates aligned outputs with:
- Simplified Chinese
- Pinyin (with tone marks)
- English translation (via Google Translate)
It outputs everything in an HTML format that’s clean, easy to read, and perfect for digital or printed study materials.
✨ Key Features
- 🈶 Auto Pinyin Injection – Converts Chinese characters to pinyin with accurate tones using
pypinyin
. - 🌍 One-Click Translation – Integrates Google Translate (via
deep_translator
) for high-speed translations. - 📁 Batch File Processing – Supports folder-wide file conversion for bulk workflows.
- 📄 Formatted HTML Output – Generates web-ready or print-ready documents in styled HTML.
- 🧠 Smart Handling of Dialogue – Maintains traditional Chinese dialogue symbols like「」and proper punctuation.
- 🔒 Offline-Friendly Setup – Built for local use. No cloud dependency after setup.
🖥️ Who is it for?
- Chinese language learners (students and self-learners)
- Educators and tutors creating study materials
- Writers and translators aligning texts
- Developers and linguists prototyping bilingual datasets
🔧 How It Works
- Select or drop in your
.txt
file(s) - Choose translation and pinyin options
- Click Generate
- Your output appears as a formatted HTML file, ready to open or publish
🛠️ Open Source on GitHub
Want to see the source or customize it for your needs? Check out the full codebase here:
We welcome contributions, issue reports, and ideas for new features.
📸 See It In Action


✅ Why DualScribe?
Unlike generic translation tools, DualScribe focuses on the educational formatting and multi-line structure learners need. It’s also:
- 🧩 Easy to integrate into custom pipelines
- ✅ Free and open-source
- 🖱️ No coding required
💬 Get Started Today
Download or fork the app on GitHub:
👉 https://github.com/MLT-solutions/DualScribe
Whether you’re building your vocabulary or preparing your next language workshop, DualScribe is the tool you’ve been waiting for.