Pianpian 片片 Demo Features FAQ GitHub Download

Learn Mandarin from the videos you actually watch

Paste a Bilibili or YouTube link. Pianpian makes Chinese, pinyin and English subtitles on your Mac, then lets you hover any word and practise line by line.

v0.1.0 · free and open source · no account
Checking your device…
Pianpian 片片 · demo

This is the real app. Play the video, hover a word, open the menus. You can also drop a video of your own on it: it plays from your disk and nothing is uploaded.

What it does

Everything below works in the demo above.

Every wordHover a word, see what it means

Its pinyin, a dictionary meaning, its HSK level and its measure words. The same word lights up in the pinyin and in the English.

PracticePractise line by line

← → jump between lines, R replay, L loop, P pause after each line to say it yourself, and slow it down to half speed.

GrammarSee how a sentence is built

A cheat sheet for word order, each part in its own colour, and optional marks under 了, 过, 在 and 要 that say past, now or later.

Any videoBilibili, YouTube, or your own files

Uses the platform's subtitles when there are some; otherwise Whisper hears the Chinese. Burned-in subtitles are read with macOS's own text recognition.

Three lines中文, pinyin and English

Show any mix. Pinyin is coloured by tone, and it can sit right above each word instead of on its own line.

ListeningFollow the voice

The word being said lights up as it is spoken, so your eyes and ears stay on the same word.

Your levelAn HSK level for every video

Each video in your library shows the HSK level that covers 90% of its words, so you know what to watch next.

PrivateRuns on your Mac

Speech recognition and translation are local models. No account, no API key, no upload. Videos stay in a folder you choose.

Yours to keepA file for any player

Every video is also saved as one MKV with all the subtitle tracks, for IINA, VLC or mpv, on any device.

How it works

From a link to a video you can study, in about a minute for every ten minutes of video.

Paste a link

From Bilibili or YouTube, or drop a video file on the window.

It makes the subtitles

Chinese from the platform or from Whisper, pinyin with jieba and pypinyin, English from Tencent's Hy-MT2 model.

Watch, hover and practise

Click any line to jump to it, hover any word, loop what you want to say yourself.

Questions

Is it free?

Yes. Pianpian is free and open source (MIT licence). There is no account and nothing to subscribe to.

Which Macs can run it?

Macs with Apple Silicon (M1 or newer) on macOS 14 Sonoma or newer. It needs about 4 GB of disk, mostly for the two models. The check at the top of this page tells you if yours can.

What does the first start do?

It asks where to keep your videos and its tools, shows what it will download (its engine, about 0.65 GB, and the speech and translation models, 1.6 GB and 1 GB), and installs them once, with progress. From mainland China it picks the faster mirrors by itself.

Is anything uploaded?

No. Videos are downloaded to your Mac and processed there. The app only goes online to download videos you ask for, its tools on the first start, and updates.

Which videos can I use?

Bilibili, YouTube and most video sites, plus any video file you already have. Use it for videos you are allowed to watch, and don't re-upload them.

macOS says it can't check the app. Is it safe?

Pianpian isn't signed with a paid Apple developer certificate yet, so the first time macOS asks. Open it once, then go to System Settings → Privacy & Security and choose Open Anyway. The source code is public on GitHub.

Windows or iPhone?

Not yet. The app relies on Apple Silicon for its models today; a Windows version is planned.

Your next video, in 中文, pinyin and English

Free for Mac. One piece at a time: 一天一片.