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

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

Mining workflow

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

Anki integration

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

Annotation details

Play YouTube URLs or searches with native subtitles, or generate them with whisper.cpp and optional AI cleanup.

YouTube playback

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

Jellyfin setup

Search and pull subtitles from Jimaku, then auto-sync timing with alass or ffsubsync — all from the overlay.

Jimaku integration

Logs watch time, words encountered, and cards mined to SQLite with daily and monthly rollups for long-term progress tracking.

Tracking details

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

Platform setup

Start

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

Lookup

Hover or click a token in the interactive overlay to open Yomitan 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

Review immersion history and repeat high-value patterns over time.

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

subminer -- playback