CasaVargas

Deckle

Deckle prints a real morning newspaper on your Kindle, Kobo, PocketBook or reMarkable, built on your own computer from your town’s news and weather and the reading you saved; makes puzzle books about what you love, clued by an AI on your own Mac, to solve in ink; and finishes the books you own like the store’s: typesetting, covers, X-Ray, comics fitted to the screen, recaps without spoilers.

The weather and almanac page of The Morning Deckle on an e-reader: five days ahead, sunrise, sunset and the moon
The front page of The Morning Deckle on an e-reader: masthead, date, weather and the lead headlines
A local story from The Morning Deckle on an e-reader, with a grayscale photo

A demo edition: Linden Falls and its stories are fictional. Photos are public domain.

Deckle is a free, open-source desktop app for your e-ink reader. Every morning it sets a real newspaper on your own computer, from your town’s news and weather, your feeds and the articles you saved, and puts it on your Kindle, Kobo, PocketBook or reMarkable. It also finishes the books you own the way the store does, fits comics to each screen, and makes puzzle books to solve in ink. It runs on macOS and Windows, and prints the paper from a Linux container.

Status
Open source
Runs on
macOS, Windows, Linux
Price
Free and open source (GPL-3.0)
Built with
Tauri, Rust, React

Why it exists

Books you load onto a Kindle yourself are second-class. They miss Enhanced Typesetting, lose their covers, and get no page numbers, X-Ray or Word Wise. Every fix exists somewhere as a calibre plugin or a forum recipe, each with its own install story, and they fight each other: the one that gives you X-Ray takes away your cover on a 2024 Kindle Scribe. Deckle is one tool that does all of it, and picks the trade-off for each Kindle instead of leaving it to you.

What it does

A morning paper
A front page that doubles as the cover, so the library tile is today’s paper; whole stories with grayscale photos; a horoscope Deckle writes itself. It builds at the hour you pick and waits on the reader.
Not only a Kindle
A Kobo gets the paper as a KEPUB, a PocketBook as an EPUB, a reMarkable as a PDF laid out for its screen over its USB web interface, and a Boox or an iPad through an export folder. None of them need Kindle Previewer. Those paths are checked against simulated devices so far.
Enhanced Typesetting, and a cover that stays
Deckle drives Amazon’s free Kindle Previewer to produce the Enhanced Typesetting that store books get, and decides per Kindle whether a book can have both its cover and X-Ray. It never bundles Previewer; you install it once, free.
X-Ray and Word Wise
People and terms are found in the text, with optional descriptions written by an AI model you choose. Word Wise hints point at the Kindle’s own dictionary.
More than EPUB
Word documents, Markdown and notes folders, text PDFs, web articles and finished KFX files go through the same pipeline as EPUBs, and several files can be bound into one book. Comics and manga arrive as pictures fitted to each reader’s screen, and puzzle books come as PDFs you solve in ink on a Kindle Scribe.
KOReader and calibre
KOReader takes the paper over Wi-Fi from Deckle’s own catalog and syncs progress back; Deckle manages its plugins and answers its calibre connection, writes reading data into calibre, and builds shelves from calibre rules.
Private by default
No account, no telemetry. Deckle checks GitHub for a newer version when it starts and installs nothing without a click. Every online lookup is listed, and all but a one-time Word Wise download are off until you turn them on. The paper fetches only the sources you give it.

How it’s built

A paper that always goes to press

Every source sits behind one small network interface and is gathered on its own, so a feed that is down becomes an “unavailable today” line in its section and the edition still builds, even with no network at all. The front page is drawn in Rust with bundled open-licence fonts and becomes the EPUB’s cover, and the paper is always sent as a personal document so that cover shows on every Kindle.

A KFX writer, ported byte for byte

Kindle Previewer produces a KPF: a zip around a SQLite database of Ion fragments. A Kindle wants a single monolithic KFX. jhowell’s kfxlib has the complete path between them; Deckle’s KFX writer is a Rust port of it, tested byte for byte against kfxlib’s own output, so no Python ships with the app.

One rule for covers and features

X-Ray and Word Wise only load for books marked EBOK with an ASIN, and an EBOK the store doesn’t know shows a grey cover once the Kindle goes online. So Deckle reads each Kindle: where system/thumbnails is writable it sends EBOK and restores its own thumbnail on every send; on MTP-only Kindles it sends PDOC, so the cover wins, unless the book matched a real Amazon edition.

Its own MTP client

The 2024 Scribe, Colorsoft and Paperwhite only speak MTP, and macOS has none. Deckle carries a small PTP/MTP client over USB that always uses the 32-bit ObjectInfo layout, because libmtp’s layout switch makes every write to a Kindle fail with 0xA806.

Word Wise without the words

A Word Wise sidecar holds no text, only positions and sense ids into a dictionary already on the Kindle. Deckle matches each book against its own Wiktionary-derived lexicon of 174,000 senses, with every inflection mapped to its lemma, and detects proper nouns per book so that "Darcy" is never glossed as a unit of permeability.

Spec first, in the open

Every feature starts as a design document in the repository, and the pipeline is tested against fixtures and a simulated Kindle disk image before it touches a real device. What has been verified on real Kindles is recorded model by model in docs/devices.md.

Deckle’s Kindle tab, Shelf: every book on a Kindle Paperwhite with its cover, progress and when it was last opened

The Kindle tab: what is on the device, how far you are in each book, and what Deckle can build better.

On the record

License
GPL-3.0-or-later
Releases
0.1.0 on 19 October 2026; 0.12.0 on 3 November 2026, for macOS, Windows and Linux
Verified on
A Kindle Scribe (2024) over MTP: cover, X-Ray, Word Wise and fixed-layout comics. Also a Kindle Paperwhite over USB mass storage. Other Kindles pending; Kobo, PocketBook and reMarkable simulated only.
Codebase
About 180,000 lines of Rust in 25 crates, with a React front end
Credits
Built on research by jhowell (KFX Input and kfxlib), xxyzz (WordDumb), jloutsch, seapy and calibre’s Kindle driver

Deckle is free and open source. Kindle books need Amazon’s free Kindle Previewer 4; the paper for other readers needs nothing else.