SubMiner

Look up words, mine to Anki, and enrich cards with context — without leaving mpv.

What it does

SubMiner is an Electron overlay that sits on top of mpv. It turns your video player into a full sentence-mining workstation:

• Hover to look up — Yomitan dictionary popups directly on subtitles
• One-key mining — Creates Anki cards with sentence, audio, screenshot, and translation
• N+1 highlighting — Marks known words from your Anki deck so unknown ones jump out
• Subtitle tools — Download from Jimaku, sync with alass/ffsubsync
• Immersion tracking — SQLite-powered stats on your watch time and mining activity
• Custom texthooker page — Built-in custom texthooker page and websocket, no extra setup
• Jellyfin integration — Remote playback setup, cast device mode, and direct playback launch
• AniList progress — Track episode completion and push watching progress automatically

Quick start

1. Install

Linux (AppImage):

wget https://github.com/ksyasuda/SubMiner/releases/latest/download/SubMiner.AppImage -O ~/.local/bin/SubMiner.AppImage
chmod +x ~/.local/bin/SubMiner.AppImage
wget https://github.com/ksyasuda/SubMiner/releases/latest/download/subminer -O ~/.local/bin/subminer
chmod +x ~/.local/bin/subminer

Note

The subminer wrapper uses a Bun shebang. Make sure bun is on your PATH.

From source or macOS — see the installation guide.

2. Install the mpv plugin and configuration file

wget https://github.com/ksyasuda/SubMiner/releases/latest/download/subminer-assets.tar.gz -O /tmp/subminer-assets.tar.gz
tar -xzf /tmp/subminer-assets.tar.gz -C /tmp
cp /tmp/plugin/subminer.lua ~/.config/mpv/scripts/
cp /tmp/plugin/subminer.conf ~/.config/mpv/script-opts/
mkdir -p ~/.config/SubMiner && cp /tmp/config.example.jsonc ~/.config/SubMiner/config.jsonc

3. Set up Yomitan Dictionaries

subminer app --start --yomitan

4. Mine

subminer app --start --background
subminer video.mkv # toggle invisible overlay with y-i and visible overlay with y-t

Requirements

Required	Optional
bun
mpv with IPC socket	yt-dlp
ffmpeg	guessit (better AniSkip title/episode detection)
mecab + mecab-ipadic	fzf / rofi
Linux: hyprctl or xdotool + xwininfo	chafa, ffmpegthumbnailer
macOS: Accessibility permission

Documentation

For full guides on configuration, Anki, Jellyfin, and more, see docs.subminer.moe.

Acknowledgments

Built on the shoulders of GameSentenceMiner, texthooker-ui, mpvacious, Anacreon-Script, and autosubsync-mpv. Subtitles powered by Jimaku.cc. Dictionary lookups via Yomitan.

License

GNU General Public License v3.0