A collection of documentation and tools for working with Kobo dictionaries.
These tools are designed to work with v2 dictionaries (4.7.10364+).
If you’re interested in creating dictionaries, look at the dictgen documentation. If you’re interested in installing or manipulating existing dictionaries, see the dictutil documentation. Otherwise, see the dicthtml documentation for more information about the Kobo dictionary format.
These pages are some notes I’ve made about the Kobo dictionary format based on reverse engineering the firmware and the official dictionaries.
- Format: About the Kobo dictionary format.
- Prefixes: Details about prefix calculation.
- v1/v2 dictionaries: Changes between v1/v2 dictionaries.
- Installing custom dictionaries: Notes about sideloading dictionaries.
dictutil is a low-level tool to unpack, pack, and perform other operations on Kobo dictzips.
- Install: Install a dictzip.
- Uninstall: Uninstall a dictzip.
- Pack: Pack a dictzip from a dictdir.
- Unpack: Unpack a dictzip into a dictdir.
- Prefix: Calculate the dicthtml prefix for a word.
dictgen is an easy-to-use tool/library to generate Kobo dictionaries from scratch or use in conversion scripts. It deals with all the unusual bits (e.g. variant capitalization, prefix generation, etc) for you and gives warnings when it can’t.
These are some tools which make use of dictutil to convert actual dictionaries.
- gotdict-convert: Converts github.com/wjdp/gotdict to a dictfile.
- webster1913-convert: Converts Project Gutenberg’s Webster’s Unabridged Dictionary to a dictfile.
- dictzip-decompile: An experimental tool to convert a dictzip into a dictfile.
- bgl-convert: A simple tool to convert Babylon BGL dictionaries to a dictfile.