Readwyn 0.1.0

An offline dictionary for your ebooks with Wiktionary

Wiktionary can live on your Mac, so the reader can look words up without a network. The Download button is in the Wiktionary row of Settings › Reading › Look up. Once the row says “Ready”, a word that you hold in the reader can bring up its Wiktionary entry.

What you download

You get the English entries of English Wiktionary, in the machine-readable extract that Wiktextract makes for kaikki.org. Readwyn downloads that extract and builds its own index from it on your Mac. Before you download, the row in Settings says “About 525 MB for offline use”: that’s the download. Readwyn’s estimate for the index is about 900 MB, but no one has measured an index built from the real extract yet. Once it’s built, the row shows its actual size on this Mac.

In October 2026 the extract was 523 MB. It holds only the English entries, and kaikki.org plans to retire it. Once it’s gone, Readwyn falls back to the extract of every language (about 3 GB) and keeps only the English lines.

The index keeps only what the popover shows: the word, its part of speech, the first pronunciation, the senses with one example each, up to 20 derived terms, and the origin. Translations and audio are left out.

Looking a word up reads only a few pages of the index, and the file is never loaded into memory. With an index of 1,000,000 synthetic entries, a release build of Readwyn finds a word in 50 to 120 µs.

What the row shows

The Wiktionary row changes as the download goes on:

  1. Before the download: the download size and Download.
  2. During the download: the progress, the time left, and Stop.
  3. Once the file is complete: a progress bar marked “Getting it ready” while Readwyn builds the index. After that it deletes the downloaded file.
  4. When it’s ready: the size on this Mac, the install date, “Ready”, and “Remove…”.

Stopping and resuming

Stop keeps the bytes your Mac already has, and so does an error or quitting the app. After an error, the row gives the reason, how much this Mac kept, and “Try again”. Both Download and “Try again” ask the server only for the rest of the file. If the server sends the whole file anyway, the download starts over.

“Remove…” asks before it does anything, then deletes the index and any kept bytes.

On Linux

Linux has no system dictionary, so Wiktionary is the only one Readwyn has there. Until you download it, a lookup in the reader shows the word, “No dictionary is ready”, and this offer:

Linux has no dictionary of its own. Wiktionary works offline, in English: about 900 MB, once.

“Download Wiktionary” starts the same download as Settings, with its progress in the popover. When the dictionary is ready, the popover looks the word up again and shows the entry. Words you saved to My Words before the download get their entries at that point too.

Next to the macOS Dictionary

On a Mac, Wiktionary sits beside the macOS Dictionary, and the lookup asks them in the order you set.

A Wiktionary entry has no list of phrases and no parent entry, because Wiktionary gives each phrase an entry of its own. A word whose senses all point to one other word opens that word’s entry instead: “gave” brings up “give”, and “colour” brings up “color”.

The licence

Wiktionary’s text is under the Creative Commons Attribution-ShareAlike licence, CC BY-SA 4.0. While Wiktionary is ready, its credit appears under the dictionary list in Settings and at the bottom of the popover for every Wiktionary entry: “Definitions from Wiktionary, by its contributors, under CC BY-SA 4.0. Extracted by Wiktextract (kaikki.org). Readwyn shortens and arranges the entries.” The index stays on your Mac, and Readwyn doesn’t distribute it.