Skip to content

Setting Up Yomipv

Use Yomipv to create cards without leaving MPV or breaking immersion.

Requirements

  • MPV (0.33.0 or higher)
  • FFmpeg (Required for media extraction, but fallbacks to mpv's internal encoder if not found)
  • Anki with AnkiConnect
  • Yomitan and Yomitan Api
  • Node.js (Required for the lookup app)

  • curl (Usually pre-installed on Windows, used for API requests)

  • Clone the repository to your MPV directory and install dependencies (make sure you have Node.js installed):

    • Windows: %APPDATA%/mpv/

      git clone https://github.com/BrenoAqua/Yomipv && xcopy /e /i /y Yomipv . && rd /s /q Yomipv && cd scripts\yomipv\lookup-app && npm install

    • Linux: ~/.config/mpv/

      git clone https://github.com/BrenoAqua/Yomipv && cp -rn Yomipv/* . && rm -rf Yomipv && cd scripts/yomipv/lookup-app && npm install

  • Configure Settings

    • Open script-opts/yomipv.conf and update your Anki deck/note type names and field mappings (usually not necessary, as everything is preconfigured for Senren).

  • External Services

    • Ensure Anki is running with AnkiConnect enabled.
    • Ensure Yomitan API is running and the browser with the Yomitan extension is open and has dictionaries installed.

Usage

Basic Workflow

  1. Open a video with Japanese subtitles in MPV.
  2. Press c to activate the word selector.
  3. Navigate with arrow keys or mouse hover to select a word.
  4. Press Enter, c, or left-click to create an Anki card.

Advanced Features

  • Append Mode (Shift+C): Select multiple subtitle lines before exporting.

  • Press Shift+C to enter append mode, c to start the word selector, or Shift+C again to cancel.

  • Selection Expansion:

  • Ctrl+Left / Ctrl+Right: Expand selection to adjacent words.

  • Shift+Left / Shift+Right: Expand to previous/next subtitle line.

  • Word Splitting (s or right-click): Split compound words into smaller segments.

  • Dictionary Lookup (Ctrl+c): Open real-time dictionary definitions window that uses your yomitan glossary.

  • History Panel (a): Toggle subtitle history panel

  • Click on previous/next lines to select them to expand the subtitle lines (when selector is open) or seek to that timestamp (when selector is closed).