⛶ Japtoanki ⛶

Automated pipeline to turn Japanese text from files or images into high-quality anki-flashcards

Extracts sentences containing kanji from manga, screenshots, etc, with mokuro and automatically creates Anki flashcards for later study.

Uses Mokuro OCR to extract text from images, and MeCab (Fugashi) to filter bad grammar and readings.

---

Features:

• Morphological analysis (MeCab / Fugashi) to discard OCR hallucinations and junk.

• Generates standard furigana reading.

• Option to translate using Google translate API.

• Users can provide a .txt, .json, .md file containing kanji they have already mastered. Sentences containing only mastered kanji are filtered.

• Automatically links every unmastered kanji to the Hochanh RTK Guide.

• Pushes cards directly to Anki when Anki-connect is enabled, otherwise generates .csv decks to manually import into Anki.

• Easy file navigation.

• Mokuro automatically generates .html files to read manga on the web-browser with selectable text.

Installation

pip install japtoAnki

Requirements:

• Python3.12
• Anki
• Mokuro OCR (installed as depency)

Usage

(This is a demo video which is completely outdated, but I can't be arsed to make a better demo video of the current system. . . . I'll get around to that maybe. But I kept it because it does show the idea behind japtoanki)

Your browser does not support the video tag.

Command Line Interface

Running japtoAnki opens a file navigator.

japtoAnki

When running without a path argument, japtoAnki opens an interactive file navigator. Translation can be toggled directly inside the navigator.

You can enable/disable translation and set the target language before selecting files.

Highly recommended to use with Anki-connect plugin in Anki. Anki needs to be open as japtoAnki runs.

japtoAnki /path/to/directory --deck Kanji_Sentences --tag manga --no-furigana --translate en --mastered-kanji /path/to/file

run activate-global-python-argcomplete --user in the terminal so that flags autocomplete when TAB is pressed.

Warning for manga / lightnovels: The OCR struggles with front matter and is very prone to making mistakes and the japtAAnki filters struggle with removing these mistakes.

Flags:

--deck Name of the deck in Anki you would like to store the generated cards. If the deck doesn't exist, it will be created.

--tags Tag each generated card. By default every card is tagged "japtoAnki"

--translate Translate each sentence into desired language using Google-translate API (Default is en (english))

--no-furigana Furigana is generated for kanji by default. Use this flag to disable.

--mastered-kanji Provide a document containing kanji you have already mastered to update the known set. Can be manually edited at (~/.mastered_kanji_list(japtoAnki).txt)

---

Note Model

JaptoAnki creates a custom model in Anki with the following fields:

Note Model

JaptoAnki creates a custom Anki note type with the following fields:

~ Front: Japanese sentence with kanji (e.g.,きょうはいいてんきですね)

~ Back: Same sentence with furigana readings above kanji (e.g., 今日[きょう]はいい天気[てんき]ですね)

~ Use --no-furigana to show plain kanji

~ HochanhLinks: Clickable kanji links to RTK memorization guides (only shows unmastered kanji)

~ Translation: Optional automatic translation via Google Translate (--translate en)

Examples

Cli file navigation

Navigation mimics Yazi or Ranger (terminal file managers). Using arrow keys or h, j, k, l for navigation. The card-type (when scanning .json files) can automatically change to fit the .json format best.

---

Specifying anki deck

---

Anki card examples:

Front:

Back:

---

Cloze format Front:

Cloze Format Back:

---

Math Front:

Math Back:

---

When --translate and --no-furigana flags are used: