SubMinerImmersion Mining for MPV

Watch media, mine vocabulary, and craft anki cards without leaving the scene.

Built for mpv

Tracks subtitles via mpv IPC in real time. Launch with the wrapper script or the mpv plugin - no external bridge needed.

How it works

Bundled Yomitan

Ships with a built-in Yomitan instance for instant word lookups and context-aware card creation directly from subtitle text.

Mining workflow

Anki Card Enrichment

Auto-fills card fields with sentence, audio clip, screenshot, and translation so you can focus on learning.

Anki integration

Reading Annotations

N+1 targeting, character-name matching, frequency highlighting, and JLPT tagging - all layered on subtitle text in real time.

Annotation details

YouTube Playback

Play YouTube URLs or ytsearch targets directly - SubMiner automatically selects and loads subtitles for the video.

YouTube playback

Jellyfin Integration

Browse your Jellyfin library, pick media interactively, and play through mpv with full subtitle and mining support.

Jellyfin setup

Subtitle Download & Sync

Search and pull subtitles from Jimaku, then retime subtitles with alass or ffsubsync - all from the overlay.

Jimaku integration

Stats Dashboard

Browse session history, streak calendars, vocabulary frequency, and per-series progress in a local dashboard - then mine cards straight from your viewing history.

Dashboard & tracking

Cross-Platform

Runs on Linux (Hyprland, Sway, X11), macOS, and Windows with compositor-aware window positioning and platform-native integration.

Platform setup

How it fits together

Start

Launch with the wrapper or existing mpv setup and keep subtitles in sync.

Lookup

Hover a token in the interactive overlay, then trigger Yomitan lookup to open context.

Mine

Create cards from Yomitan or mine sentence cards directly from subtitle lines.

Enrich

Automatically attach timing-accurate audio, sentence text, and visual evidence.

Track

Open the stats dashboard to review sessions, vocabulary trends, and mine cards from past viewing history.

See it in action

Subtitles, lookup flow, and card enrichment from a real playback session.

subminer -- playback