iinatan

iinatan adds dictionary popups to subtitles in IINA on macOS. Pause a video, hover a word, and look it up without leaving the player.

The plugin is still experimental, but the core workflow is usable today: install a dictionary, choose a lookup language, toggle iinatan on, and use it while watching subtitled video.

Anki export is available through AnkiConnect when Anki is running in the background.

Screenshots

German lookup	Anki setup
Dictionary selection	Recommended dictionary downloads

What You Get

• Dictionary lookups directly on IINA subtitles.
• Automatic pause on dictionary lookup and resume afterwards
• Japanese, English, French, German, Chinese, and Korean lookup modes.
• Built-in downloader for recommended dictionaries and frequency data.
• Import support for local Yomitan-compatible dictionary ZIP files.
• Frequency and pitch-accent dictionary support for Japanese
• Compact popups with structured entries, tags, source links, collapsed long sections, and custom CSS.
• One-click Anki card creation with duplicate detection, subtitle sentences, screenshots, and subtitle audio.
• Profiles for keeping separate language, dictionary, popup, and anki export settings.

Installation

For most users, the recommended option is the release package. Installing directly from GitHub follows the latest repository contents, so it can break temporarily when new commits are pushed.

Install a Release Package (Recommended)

Download iinatan.iinaplgz from the latest version on GitHub and install it through IINA's plugin manager.

Install From GitHub

Use this only if you want the newest in-progress changes and are comfortable with occasional breakage.

1. Open IINA's plugin manager.
2. Choose Install from GitHub.
3. Enter afn478/iinatan.
4. Enable the plugin.
5. Open Plugins -> iinatan -> Settings....
6. Install the recommended dictionary, or import a Yomitan-compatible dictionary ZIP.
7. Toggle iinatan with Shift+H.

Quick Start

1. Open Plugins -> iinatan -> Settings....
2. Choose the lookup language you want to use.
3. Go to the dictionaries section
4. Click Get recommended Dictionaries... and download the available dictionaries. Alternatively, import compatible dictionary ZIP files.
5. Enable and move dictionaries into the order you prefer.
6. Toggle iinatan with Shift+H.
7. Pause playback and hover subtitle text.

If the popup does not appear, press Shift+H to toggle iinatan on.

Dictionaries

The dictionary panel lets you:

• Install Jitendex for Japanese.
• Import local Yomitan-compatible dictionary ZIP files.
• Enable or disable installed dictionaries.
• Reorder dictionaries to choose which results appear first.

Language support depends on the dictionaries you install. iinatan currently has lookup modes for:

• Japanese
• English
• French
• German
• Chinese
• Korean (Experimental)

Some dictionary ZIP files do not label their language clearly. When that happens, iinatan may still let you import the file, but you may need to choose the right lookup language yourself.

Settings

Open Plugins -> iinatan -> Settings... to manage the plugin.

Common settings include:

• Lookup language
• Installed dictionaries and result priority
• Subtitle and popup appearance
• Playback behavior
• AnkiConnect export fields, duplicate behavior, screenshots, and sentence audio
• Advanced import and lookup options
• Profiles for separate setups

Anki Export

Install the AnkiConnect add-on, open Anki, then configure export from the Anki tab in Plugins -> iinatan -> Settings.... Anki settings are stored per profile, including the AnkiConnect URL, deck, note type, field templates, duplicate behavior, JPEG screenshot quality, and sentence audio format/bitrate.

To add cards from the popup:

1. Keep Anki open and make sure AnkiConnect shows as reachable in the Anki tab.
2. Choose the deck, note type, and field mappings for the active profile.
3. Enable Show Anki add button in popups. Without this checkbox, the popup will not show the add-card button even when AnkiConnect is configured.
4. Press Shift+H to turn iinatan on, pause playback, hover subtitle text, then click the add-card button in the popup.

The IINA plugin menu also includes Settings... and quick profile switching.

Troubleshooting

• If no popup appears, press Shift+H and try again while playback is paused.
• If a dictionary does not return results, check that it is enabled and that the current lookup language matches it.
• If the plugin stalls, restart IINA.

Development / Contributing

Development notes, build commands, test commands, packaging details, and release steps live in CONTRIBUTING.md.

License

iinatan is licensed under the GNU General Public License v3.0 only (GPL-3.0-only). See LICENSE for the full license text.

Thanks

• Yomipv for the original idea of bringing Yomitan-style lookup into mpv.
• Yomitan for the inspiration behind the popup dictionary experience.
• HoshiDicts for the dictionary engine used by iinatan.
• Chimahon and Hoshi Reader Android for examples of compact, reader-friendly lookup design.