SubMinerImmersion Mining for MPV

Watch, look up a word, and get an Anki card with audio and a screenshot. Without pausing your show.

Built for mpv

Reads subtitle state over mpv's IPC socket. Launch with the wrapper script or the mpv plugin. There is no separate bridge process to run.

How it works

A Yomitan instance is bundled and preconfigured. Hover a word in the subtitle overlay to look it up and mine it.

Mining workflow

New cards get the subtitle line, an audio clip cut to the line timing, and a screenshot from that moment.

Anki integration

N+1 targeting, character-name matching, frequency highlighting, and JLPT tagging, drawn onto the subtitle line as it plays.

Annotation details

Pass a YouTube URL or a ytsearch target. SubMiner picks a subtitle track for the video and loads it.

YouTube playback

Browse your Jellyfin library from the overlay and play a title through mpv. Subtitles and mining work the same as with local files.

Jellyfin setup

Search Jimaku or TsukiHime and download a track, then retime it with alass or ffsubsync. Both run from the overlay.

Jimaku integration

A local dashboard with session history, streak calendars, word frequency, and per-series progress. You can mine cards from lines you already watched.

Dashboard & tracking

Runs on Linux (Hyprland, Sway, X11), macOS, and Windows. Overlay positioning is handled per compositor rather than assuming one window manager.

Platform setup

Start

Launch through the wrapper, or from an mpv setup you already have.

Lookup

Hover a token in the overlay to open the Yomitan popup for that word.

Mine

Add the word from Yomitan, or mine the whole line as a sentence card.

Enrich

SubMiner fills in the audio clip, the sentence, and a screenshot from that moment.

Track

Review past sessions and word trends, and mine anything you missed the first time.

Recorded from an actual playback session: subtitle hover, lookup, and the card that comes out the other end.

subminer -- playback