FIXES AND EDITS TO WZYBOYS CODE

I forked this very useful repo for exporting kindle vocab builder words to Anki to make a few fixes. Incorporated fixes according to this issue: wzyboy#5 and a fix for incorrectly formatted dictionaries where the definitions for a few words can end up as more than 100 000 characters long. Will also try to make a simple GUI to make the repo easier to use for people (like myself) who aren't used to using command line programs.

Export Kindle Vocabulary Builder to Anki

Kindle Vocabulary Builder is useful, as it collects new words automatically when you read books. However, it has only two decks: "Learning" and "Mastered". It lacks a lot of functionalities found in professional flashcard software like Anki. Kindle Vocabulary Builder stores all the data in /system/vocabulary/vocab.db SQLite3 database. This repo contains helpers to extract words from Kindle Vocabulary Builder and import them into Anki.

Usage

Install requirements from requirements.txt.
Use DeDRM Tools to strip DRM if your Kindle dictionary is protected by DRM (Note: built-in dictionaries cannot be decrypted).
Use KindleUnpack to unpack your Kindle dictionary into raw HTML files.
Run ./convert_dict.py mobi7/book.html dict.tsv to convert the HTML dictionary into a TSV dictionary.
Run ./convert_vocab.py vocab.db dict.tsv notes.tsv to extract words from Kindle Vocabulary Builder, add definitions to them, and save them into a TSV Anki notes file.
You can now import the notes.tsv file into Anki.

File Formats

TSV stands for Tab-seperated vlues. The fact that there are unlikely any \ts in dictionary definitions or book citations, makes TSV a better choice than CSV for both plain-text dictionaries and Anki notes.

The TSV dictionary generated by convert_dict.py has two columns, Stem and Definition. You can use --expand-iform flag to make every inflectional form its own entry (e.g. abandon, abandoned, abandoning, abandons would be four entries with same definitions). The generated file would be much larger.

The TSV dictionary could also be used in Kindle Mate.

The TSV Anki notes file has three columns: Stem, Usage, Definition. You can map them to whatever fields you like. The "Usage" and "Definition" columns are HTML, so remember to check "Allow HTML in fields" when importing into Anki. The "Usage" column contains all the citations in Kindle Vocabulary Builder, i.e. if you look up a word in different books, the usage sentences will be merged into one single Anki note.

Templates and Styling

The templates and styling below make the rendered Anki cards very similar to their counterparts in Kindle Vocabulary Builder.

Front Template:

<h1>{{Word}}</h1>
<hr>
{{Usage}}

Back Template:

{{FrontSide}}
<hr>
{{Definition}}

Styling:

h1 {
 text-align: center;
}
blockquote small:before {
 content: " -- ";
}

Similar Projects

External Links

Anki —— 高效的间隔重复记忆软件

emileberhard / kindle_vocab_anki_fixed