xué

A free, open-source desktop app

Mandarin Learning Reader

Turn any Chinese e-book into a read-aloud, speak-back Mandarin tutor — pinyin over every character, and instant feedback on how you said it.

By Jeremy Lee

拼 Pinyin over every character 🔊 Hear it 🎤 Speak it back 简 ⇄ 繁 Simplified / Traditional

What it does

You give it a Chinese EPUB; it becomes a patient tutor. The app shows one short sentence at a time — big, centred, with the pinyin printed above every character — reads it aloud in a natural Mandarin voice, and then listens to you say it back. It marks each character green, red, or amber depending on how close you got, and moves on when you nail it. Everything runs on your own machine, for free, and your voice never leaves your computer.

green = right · amber = right sound, wrong character · red = missed

Pinyin on every word

Tone-marked pinyin sits above each character, so you always know how it's pronounced — no lookups.

🗣️

Natural voices, free

Microsoft's neural Mandarin voices read each sentence — male or female, Mainland or Taiwan, five speeds.

🎤

Speak it back

Record yourself and a private, offline speech model checks your pronunciation. No internet, no account.

🟢

Character-level feedback

Every character turns green, red, or amber. Score 90% and the app advances to the next line on its own.

简繁

Simplified ⇄ Traditional

Read a Simplified book as Traditional or vice versa with one toggle — grading understands both.

💾

Picks up where you left off

Reopens your last book, chapter, and sentence, and remembers your voice, speed, and theme.

How it works

  1. Open a Chinese EPUB. The app finds the chapters and splits each into short, speakable lines.
  2. Read along. The current sentence is shown large, with pinyin above every character.
  3. Listen. Hear it in a natural Mandarin voice, as slow or fast as you like.
  4. Speak it back. Record yourself; the app grades each character and shows you exactly what to fix.
Built by a Cantonese speaker learning Mandarin — one that reads Traditional comfortably and wanted to get faster at Simplified. The whole loop is read, listen, speak, and get corrected, one sentence at a time.
Private & yours: the app ships no books — you bring your own EPUB files, for e-books you own or public-domain titles. Speech recognition runs entirely on your computer (a one-time model download on first use); your microphone audio is never uploaded.

Get it

The app is open source. Grab the code, install a few free Python packages, and run it — full step-by-step instructions are in the README.

Get the app on GitHub Read the setup guide