Skip to content
/ core Public

[ ᚱ ] Desktop app to generate and manage custom ereader dictionaries for fictional worlds.

Notifications You must be signed in to change notification settings

Runik-3/core

Repository files navigation

Runik

Generate and manage custom e-reader dictionaries for your favourite fictional worlds.

Motivation

Most e-readers have built-in dictionaries, letting you define words in-text as you read. While this feature can tell you the meaning of words like 'tabard' and 'thaumaturgy', it can't help you define names, places, or magical items specific to the world of your book.

Runik leverages the crowd-sourced info of fan wikis to generate custom e-reader dictionaries, extending the volcabulary of your e-reader to include fictional references.

Limitations

Runik is in early development and is bound to contain bugs. Feel free to report any issues you encounter.

Runik is designed to work with MediaWiki sites. There is variablility in the way wikis can be configured or the way articles are written -- runik is not guaranteed to work with all of them. I mostly tested against Fandom wikis which are pretty consistent and should be well supported.

If Runik does not yet support your device -- and you are comfortable tinkering -- you can use the Runik Builder cli tool to generate dictionaries and use one of the many other tools out there to convert it for use with your device.

FAQs

Why are Kobo dictionaries prefixed with dicthtml-[r]?

Kobo expects dictionaries to be in the following format dicthtml-<language-code>, automatically detecting dicthtml-es as a spanish language dictionary and displaying it as Espanol. Without the dicthtml prefix, kobos don't know to treat this file as a dictionary, and if we tried to put the dictionary name alone after the prefix (eg. dicthtml-gameofthrones), the kobo treats the first two letters "ga" as a language code, interpreting this as a gaelic dictionary. So instead, we use characters that cannot be mistaken for a language code before the name of the dictionary, "[r]". It's not a perfect solution and I'm working on a solution to get more user-friendly kobo dictionary names.

Runik is made with