Skip to content
hockyyPublic

About

Free video player for learning Japanese, Mandarin, Cantonese and Vietnamese from what you watch. Click any subtitle word for its reading and offline dictionary meaning. Plays local files and YouTube, with dual subtitles, karaoke lyrics and Anki export.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

122 stars

Watchers

6 watching

Forks

Repository files navigation

Miteiru logo

Miteiru 見ている

Learn Japanese, Mandarin, Cantonese and Vietnamese from what you watch.

A free video player that turns every subtitle word into something you can click,
with the reading on top, the meaning underneath and a full dictionary entry one click away.

Latest release Downloads Stars Platforms License: CC BY-NC-SA 4.0

⬇️ Download · 🌐 Website · ▶️ Watch the 36-second trailer

Why Miteiru?

  • Every word is clickable. Subtitles are split into words (Miteiru's own Rust tokenizers: an IPADIC lattice for Japanese, Jieba for Chinese) with furigana, pinyin or jyutping on top and short meanings underneath. Click a word for its full dictionary entry, pitch accent, conjugations and kanji breakdown.
  • Your videos, your subtitles. Drop in local files (MKV, MP4, HEVC, AV1, multiple audio tracks: anything mpv plays, with no converting) with .srt, .ass, .vtt or .lrc subtitles, or paste a YouTube link and pick one of its caption tracks.
  • Dictionaries stay on your computer. JMdict, KANJIDIC, CC-CEDICT, CantoDict and VNEDict work offline once a language is downloaded. No account, no subscription, no server.
  • Made for immersion. Your target language on top and English underneath, a key to repeat the current line, karaoke lyrics, colours for the words you know, flashcards and one-click Anki cards.

Features

Click any word, pitch accent, every conjugation, kanji broken down Colour what you know, flashcards, one-click Anki cards, karaoke lyrics Two subtitles at once, every line on the seek bar, settings in plain words, fonts for every script Local files and YouTube, AI translations, dictionaries offline, sync with a GitHub Gist
Everything else
  • [ / ] shift a subtitle's timing when it's out of sync.
  • Lyrics search on LRCLIB for music videos.
  • Optional AI translations (formal, neutral or casual, with grammar notes), using your own OpenRouter key.
  • Notes on words, a vocabulary sidebar, and syncing your progress through a GitHub Gist.
  • Bundled subtitle fonts (Noto Sans JP, SC and TC), or any font installed on your computer.
  • CC Live subtitles a video that has none, using the system's live captions (Windows, and recent macOS on Apple silicon).

Download

kiwi Download Miteiru pomegranate

Get the newest version from Releases:

Platform File Note
Windows 10/11 Miteiru_<version>_x64-setup.exe The installer isn't code-signed, so SmartScreen may warn: More info → Run anyway.
macOS (Apple silicon) Miteiru_<version>_aarch64.dmg Not notarized (no paid Apple Developer account): open it anyway.
Linux Miteiru_<version>_amd64.deb or .AppImage Built on Ubuntu 22.04. Video plays through the system's libmpv: the .deb installs it; for the AppImage, install libmpv2 (or libmpv1 on Ubuntu 22.04).

Upgrading from 7.x keeps your words, notes and settings: Miteiru 8 reads the same data folder.

Miteiru 8.0 doesn't update itself yet: new versions appear on the releases page, and you install them the same way.

macOS: what the warning looks like

The macOS dialog about an unidentified developer

Quick start

  1. Open Miteiru and pick your language. Its dictionaries download the first time you use it (sizes below).
  2. Drag a video into the window (with its subtitle files, if you have them), or paste a YouTube link with Ctrl+V.
  3. In the subtitle picker, your language goes on top and English underneath. Change either if you like.
  4. Click any word. R repeats the line, X opens the settings, Z shows the controls and Ctrl+H goes home. Every shortcut is listed on the home screen.

Tip

  • YouTube captions come through yt-dlp, and subtitles inside video files through FFmpeg. Home → Settings & tools → Optional media tools shows whether they're found and links to them.
  • Anime subtitles: many Japanese ones are on kitsunekko.

Languages

🇯🇵 Japanese 🇨🇳 Mandarin 🇭🇰 Cantonese 🇻🇳 Vietnamese
Words split by Miteiru's tokenizer (IPADIC) Jieba Jieba (Cantonese) Longest match
Readings Furigana, romaji Pinyin Jyutping
Dictionary JMdict, KANJIDIC CC-CEDICT CantoDict VNEDict
Extras Pitch accent, conjugations, kanji strokes Simplified and traditional, hanzi strokes Tone marks A meaning under every word

Language data downloads on first use, from the same release as the app, and stays on your computer. The installer is small because it leaves the data out:

Language Download
Japanese (dictionaries, kanji, WaniKani levels, tokenizer) 30 MB
Chinese (Mandarin) 12.7 MB, plus the 10.9 MB hanzi stroke data it shares with Cantonese
Cantonese 8.1 MB, plus the same hanzi stroke data
Vietnamese 0.6 MB

Offline install: download the Miteiru-language-<name>.mtrpack files from the release that matches your Miteiru version (a pack from another version is refused, and says which one it is), then pick each one with Install it from a file… on the home page (or Settings & tools → Languages → Install from a file…). Or build with npm run tauri:build:full to get an installer that carries every language.

More detail in README_LANGUAGES.md.

FAQ

Is it really free?

Yes: no account, no ads, no subscription. Miteiru is licensed under CC BY-NC-SA 4.0: you may share and adapt it for non-commercial use, with credit, under the same license.

Does it need the internet?

Only for YouTube and the optional AI translation. Local videos, subtitles and dictionary lookups work offline.

Can an AI assistant find videos for me?

Yes. Claude and other AI apps that take MCP servers can search YouTube for videos in your language, check how many of their words you've saved, and open the one you pick in Miteiru with its subtitles set up. Settings → AI → AI assistants shows the command to add and copies it. Miteiru needs to be open while they work. Details, and the local API for other programs: docs/LOCAL_API.md.

The YouTube subtitle list is empty

The subtitle picker says why. Usually yt-dlp is missing or outdated. Put a current yt-dlp in Miteiru's tools folder or on your PATH, then load the link again.

Found a bug or have an idea?

Open an issue or start a thread in Discussions.

Support Miteiru

If Miteiru helps you learn, give it a ⭐: stars are how other learners find it. Telling your study group, class or Discord server about it helps even more.

For developers

Miteiru is a Tauri app: a Next.js interface in the system webview, a Rust shell (src-tauri/) and libmpv for video. It needs Node.js 22.15+, a stable Rust toolchain and Tauri's system dependencies (on Linux also libmpv-dev). script:initrepo downloads language assets from the assets release into renderer/public/language-assets; Windows and macOS builds fetch a pinned LGPL libmpv on their own.

npm install
npm run script:initrepo
npm run dev              # the app with hot reload
npm run build            # installers for this OS (NSIS, DMG, or deb and AppImage)
npm run build:live-captions   # Windows and macOS: the Live Captions helper, before `npm run build`

Language assets:

npm run script:download-language-assets
npm run script:pack-language-assets
npm run script:unpack-language-assets
npm run script:download-language-assets -- mandarin han-character-core

npm run tauri:build leaves the language data out of the installer and bundles a manifest of language packs instead (built by npm run build:language-packs, into dist/language-packs/); npm run tauri:build:full bundles the data too, for an offline build. MITEIRU_FORCE_ASSET_DOWNLOAD=1 redownloads existing zips. Releases and in-app updates: docs/RELEASING.md. How the language data ships, and how to add a dataset: docs/DATA_FORMAT.md, docs/ADDING_DATA.md. More notes are in docs/, and contributions are welcome: see CONTRIBUTING.md.

Credits and license

Dictionary data comes from JMdict and KANJIDIC (EDRDG), CC-CEDICT, CantoDict, VNEDict, KanjiVG and Make Me a Hanzi, each under its own license. Japanese pitch accents come from Kanjium and Mandarin HSK levels from complete-hsk-vocabulary (MIT). Japanese JLPT levels come from Jonathan Waller's JLPT Resources through yomitan-jlpt-vocab, and word frequencies from wordfreq by Robyn Speer; both are CC BY-SA 4.0, kept with their licence and notices in renderer/public/study-data/japanese-levels/. Video playback uses libmpv and FFmpeg in their LGPL 2.1 builds; the licence text ships with the app.

The Japanese tokenizer is Miteiru's own Rust lattice and suffix engine, reading the existing IPADIC pack, JMdict and Your dictionary. Its kuromoji.js compatibility reference and IPADIC notices are in native/rust/crates/miteiru-tokenizer/NOTICE; the Apache-2.0 text ships beside them. See the tokenizer design and evaluation.

Miteiru is made by Hocky Yudhiono and licensed under CC BY-NC-SA 4.0. It is provided as is; use it at your own risk. Found a security issue? Email miteiru@hocky.id or open an issue.

About

Free video player for learning Japanese, Mandarin, Cantonese and Vietnamese from what you watch. Click any subtitle word for its reading and offline dictionary meaning. Plays local files and YouTube, with dual subtitles, karaoke lyrics and Anki export.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

122 stars

Watchers

6 watching

Forks

Releases

Sponsor this project

Used by

Contributors

Languages