Anki Miner

PyPI version Python 3.11+ License: GPL v3 GitHub downloads GitHub stars Discord community

English · 日本語 · Русский · Français · Español · Deutsch · Português (Brasil) · Bahasa Indonesia · Tiếng Việt · 简体中文 · 繁體中文 · Italiano

Turn native Japanese, Chinese, and Korean content into Anki vocabulary cards.

Also on Android - Anki Miner for Android.

Please leave a ⭐ star if Anki Miner helped you - it helps others find it :).

Mining Demo

Anki Miner Showcase

⬇️ Full demo with sound (MP4)

Example cards

ホント いちゃいちゃ 代
⬇️ MP4 (sound) ⬇️ MP4 (sound) ⬇️ MP4 (sound)

Installation

Requirements

  • Anki with the AnkiConnect add-on (code 2055492159)
  • ffmpeg + libmpv (video preview only) - needed only when installing via pip/pipx or source.

Grab the download for your platform from the latest release:

Platform Download
Windows AnkiMiner-*-Setup.exe
macOS (Apple Silicon / M1-M4) AnkiMiner-*-macOS-arm64.tar.gz
macOS (Intel) AnkiMiner-*-macOS-x86_64.tar.gz ¹
Linux (Debian/Ubuntu) anki-miner_*_amd64.deb
Linux (other) AnkiMiner-*-Linux-x86_64.AppImage

¹ Excludes local Whisper subtitle generation and AVIF screenshots. For full functionality: pipx install "anki-miner[asr]".

First-run notes (unsigned builds)

  • macOS: Gatekeeper blocks the app. Extract first, then xattr -dr com.apple.quarantine AnkiMiner/
  • Windows SmartScreen: More info -> Run anyway.
  • Windows Defender false positive: restore from Protection history or report to Microsoft.
Install from PyPI (Python 3.11+) 
pipx install anki-miner   # or: pip install anki-miner
anki_miner_gui

Japanese needs nothing extra. For Chinese or Korean mining, add the engine:

pipx install "anki-miner[languages]"   # both; or [zh] / [ko] for one

The downloads above fetch these in-app instead, from Settings -> Mining Language.

Install from source 
git clone https://github.com/0xzerolight/anki_miner.git
cd anki_miner
pip install -e .
anki_miner_gui

For full development setup, see CONTRIBUTING.md.

Tabs

  • Video - mine a single video/subtitle pair, a batch folder, or YouTube URLs.
  • Deck Builder - mine a whole series into one frequency-ranked deck.
  • Audiobooks - mine audiobooks, podcasts, radio, songs (audio + subtitle/transcript pairs).
  • Reading - mine manga (mokuro), novels (.epub, .txt; single book or a whole folder), standalone subtitle files, or pasted text.
  • Analytics - mining history, difficulty rankings, milestones.
  • Utilities - generate subtitles (local Whisper), retime subtitles (ffsubsync/alass), condense media to dialogue-only audio, download video/audio/subtitles from any site yt-dlp supports, copy the worth-learning part of a premade deck into a new one, and backfill fields on existing cards.
  • Settings - everything configurable.

Other Features

  • Mining languages - Japanese, Chinese, and Korean, switched in Settings. Korean downloads its language model in-app.
  • Word Curator - review every candidate word before cards are made, with its scene, manga page, and dictionary entry side by side.
  • Undo a run - delete the notes a run just created, straight from its results dialog.
  • Extensive filtering: i+1, frequency rank range, blacklist, regex, wordsets, and more.
  • Offline Yomitan dictionary import - definitions, pitch accent, frequency - chained by priority.
  • Multiple frequency lists chained by priority.
  • Word audio on cards from local audio packs, JapanesePod101, or Google TTS.
  • Sentence audio on Reading cards from Google Translate TTS or Naver Papago (off by default).
  • Per-dictionary glossary styling, Yomitan-style.
  • Embedded libmpv video preview - play a word's scene while curating, or nudge subtitle timing with live playback.
  • Animated screenshots (see example cards above).
  • Settings profiles - save named configurations and switch between them from the header.
  • Restyle Mined Cards - re-apply your current card styling to cards you already made (Tools menu).
Built-in themes (29)
  • Ayu - Light, Mirage, Dark
  • Catppuccin - Latte (light); Frappé, Macchiato, Mocha (dark)
  • Dracula - Dracula, Alucard
  • Everforest - Light, Dark
  • GitHub - Light; Dark, Dark Dimmed
  • Gruvbox - Light Medium, Dark Medium
  • Kanagawa - Lotus (light), Wave (dark)
  • Rosé Pine - Dawn (light); Main, Moon (dark)
  • Solarized - Light, Dark
  • Standalone - Light, Dark, Sakura, Nord, One Dark, Tokyo Night

Theme licenses: LICENSE-THEMES.md. Want another theme added? Suggest in a GitHub Issue.

How It Works
  1. Read the subtitles and split the text into individual words.
  2. Filter to content words you don't already know - optionally reviewing the list yourself in the Word Curator.
  3. Grab a screenshot and audio clip from the video for each line.
  4. Look up definitions in your configured offline dictionaries, optionally falling back to Jisho online if enabled (slower, rate-limited).
  5. Send the finished cards to Anki.

Recommended Resources

Japanese unless marked otherwise. The Setup Wizard offers the right set for your mining language.

Type Resource Download Add via
Dictionary JMdict Yomitan zip Add Dictionary…
Dictionary Jitendex Yomitan zip Add Dictionary…
Dictionary Bee's Character Dictionary Generated on site Add Dictionary…
Pitch Kanjium TSV Pitch Accent -> Add pitch source…
Pitch アクセント辞典v2 Drive Pitch Accent -> Add pitch source…
Frequency JPDB v2.2 Kana Yomitan zip Frequency -> Add frequency source…
Frequency BCCWJ SUW+LUW Yomitan zip Frequency -> Add frequency source…
Word audio local-audio-yomichan Collection torrent or generated android.db Audio -> Add audio source…
Dictionary (Chinese) CC-CEDICT Yomitan zip Add Dictionary…
Dictionary (Korean) KRDICT Yomitan zip Add Dictionary…
JMnedict License

Uses bundled name wordsets derived from JMnedict (JMdict/EDICT project, EDRDG, CC BY-SA 4.0).

Troubleshooting

Issue Solution
"Cannot connect to Anki" Start Anki and ensure AnkiConnect is installed.
"Deck not found" Pick an existing deck in Settings -> Cards & Anki. Decks are not created for you; make it in Anki first if you need a new one.
"Note type not found" Configure your note type's field names in Settings -> Cards & Anki.
"ffmpeg not found" Install ffmpeg and add it to PATH.
No definitions found Add a Yomitan dictionary in Settings -> Add Dictionary… (recommended), or enable the Jisho fallback (slower, rate-limited).
Windows installer will not open / SmartScreen warning See First-run notes: select More info -> Run anyway; restore Defender false positives from Protection history.
Fresh install has no definitions Run Tools -> Setup Wizard or Tools -> Download Recommended Resources. For manual import, keep the Yomitan ZIP intact (do not unzip it).
Add Dictionary stalls or fails Note the last visible stage and attach logs (see "Where are the logs?" below). Include the dictionary ZIP name, source, and size in the report.
Where are the logs? Use Help -> Open Log Folder, or open %USERPROFILE%\.anki_miner\anki_miner.log on Windows or ~/.anki_miner/anki_miner.log on macOS/Linux. Rotated logs use the .1 through .5 suffixes. Send anki_miner.crash too if it is there — a crash that took the app down writes its stack to that file, not to the log — and anki_miner.child.log, which holds a helper process's output.
Reporting a bug Help → Export Diagnostics… writes a ZIP to a location you choose, holding the logs (anki_miner.log and its rotations, anki_miner.crash, anki_miner.child.log), your settings.json, your config and UI-state files, queue snapshots and download manifests, and generated reports of the machine and app state (environment.txt, health.txt, resources.txt, stores.txt, disk.txt, screens.txt). Review it before uploading because it contains file paths and file names from your computer. Nothing is uploaded automatically.
More diagnostic logging Set ANKI_MINER_LOG_LEVEL=DEBUG before starting Anki Miner to capture third-party yt-dlp, urllib3, and fugashi details. The default is WARNING; Anki Miner logs remain at DEBUG.
Audio is wrong language The tool tries the mining language's audio tracks first, then falls back to the default.
Subtitles out of sync Use the subtitle offset control in the GUI (range ±300 seconds).

Roadmap

List of ideas for future versions of Anki Miner. Not in priority order. Feature requests take precedence.

  • Suggest a feature - Open an issue.

  • Discuss the roadmap - Discussions.

  • Features:

    • UI language selection.
    • Local subtitle creation tab: Opt-in tab to locally generate subtitles.
    • Reading tab: Mine manga and books.
    • Backfill tool.
    • Media library: Expand Analytics tab to display local media library across all media forms.
    • Automatic subtitle downloading.

  • Long-term:

Contributing

Contributions of any kind are welcome. If you want to support the project, please share it with others who may benefit from it.

Bug reports and feature requests -> Issues. General questions and discussion -> Discussions or Discord.

Special Thanks

Sincere thanks to people who made exceptional contributions to the project:

  • ★ StyraxBenzoin - Brilliant feature suggestions, new release testing, community building.
  • ★ rob-olvr - Excellent feature suggestions, community building and moderation on Discord.

See CONTRIBUTORS.md for everyone who has made any kind of contribution to the project.

License

GNU General Public License v3.0. See LICENSE.

Project links

Data verified by PyPI on Sep 5, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (3.3.0)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for 0xzerolight from gravatar.com 0xzerolight

Credits

Author: Anki Miner Contributors

GitHub Statistics

Data verified by PyPI on Sep 5, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

GPL-3.0-or-later
View SPDX License List

Requires

Python >=3.11

Provides Extra

asr asr-cuda asr-vulkan zh ko languages dev i18n

Tags

anki japanese vocabulary anime subtitles language-learning

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

anki_miner-3.1.0.tar.gz (9.7 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

anki_miner-3.1.0-py3-none-any.whl (10.0 MB view details)

Uploaded Python 3

File details

Details for the file anki_miner-3.1.0.tar.gz.

File metadata

  • Download URL: anki_miner-3.1.0.tar.gz
  • Upload date:
  • Size: 9.7 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for anki_miner-3.1.0.tar.gz
Algorithm Hash digest
SHA256 a97bc121e3adfe10d249efceb2c7391daee814425ee4005f031a4f569e98f43b
MD5 e88907bb438b08611598280f5b875b18
BLAKE2b-256 07e3f65b5cb9ee85c0b69d429d99fe8548904c58b9e64a1dfefd32870771d0b0

See more details on using hashes here.

Provenance

The following attestation bundles were made for anki_miner-3.1.0.tar.gz:

Publisher: publish.yml on 0xzerolight/anki_miner

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file anki_miner-3.1.0-py3-none-any.whl.

File metadata

  • Download URL: anki_miner-3.1.0-py3-none-any.whl
  • Upload date:
  • Size: 10.0 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for anki_miner-3.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 1d2db6b93f5d6d50061b0464d0207ddd9bb2369d9eec20c6ef2f1b9faaddd22a
MD5 d320a195cd87dd78cc25d06762bd8954
BLAKE2b-256 ee195d11108e0db6bb46f89479fafbb159979efec974c620df33f6938263d002

See more details on using hashes here.

Provenance

The following attestation bundles were made for anki_miner-3.1.0-py3-none-any.whl:

Publisher: publish.yml on 0xzerolight/anki_miner

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

3.3.0

2 files

3.2.0

2 files

This release

3.1.0 This release

2 files

3.0.0

2 files

2.14.0

2 files

2.13.0

2 files

2.12.0

2 files

2.11.0

2 files

2.10.0

2 files

2.9.3

2 files

2.9.2

2 files

2.9.1

2 files

2.9.0

2 files

2.8.4

2 files

2.8.3

2 files

2.8.2

2 files

2.8.1

2 files

2.8.0

2 files

2.7.8

2 files

2.7.7

2 files

2.7.6

2 files

2.7.5

2 files

2.7.4

2 files

2.7.3

2 files

2.7.2

2 files

2.7.1

2 files

2.7.0

2 files

2.6.7

2 files

2.6.6

2 files

2.6.5

2 files

2.6.4

2 files

2.6.3

2 files

2.6.2

2 files

2.6.1

2 files

2.6.0

2 files

2.5.0

2 files

2.4.7

2 files

2.4.6

2 files

2.4.5

2 files

2.4.4

2 files

2.4.3

2 files

2.4.2

2 files

2.4.1

2 files

2.4.0

2 files

2.3.4

2 files

2.3.3

2 files

2.3.2

2 files

2.3.1

2 files

2.3.0

2 files

2.2.0

2 files

2.0.4

2 files

2.0.2

2 files

2.0.1

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page