Skip to content
9retirement6irkPublic

About

Your Grimmory library on a Kindle, from the Kindle 2 and Nook 1 to the Scribe. Read, and keep your place, bookmarks, highlights and notes in sync; send books from your browser; listen to audiobooks and Plex music; write and draw notes; see your calendars.

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Latest commit

 

History

1,085 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

GZreader logo

GZreader

Grimmory + ZenOS + KOReader for Kindles, Kobos and Nooks
Your Grimmory (formerly BookLore) library on an e-reader, from the Kindle 2 and Nook 1 to the Scribe, and on Kobos: read, and keep your place, bookmarks, highlights and notes in sync with Grimmory; send books from your browser; listen to audiobooks and Plex music; write and draw Memos notes; see your calendars.

Download the latest release · Wiki · Install · Changelog


GZreader is KOReader trimmed down to reading, with the ZenOS interface and a built-in connection to your self-hosted Grimmory book server.

It runs on Kindles with a keyboard, a 5-way, a touchscreen or a pen, from the Kindle 2 to the Kindle Scribe, and as test builds on Kobos, the Nook 1st Edition and the Nook Simple Touch: which ones have been tried is in device compatibility.

Home: the book you're reading and your shelf
Home
The Catalog's Books page, laid out like a bookshop
Catalog: books
The Catalog's Audiobooks page: Continue listening, Recently added
Catalog: audiobooks
The Catalog's Music page: Plex albums as CD cases
Catalog: music
Downloads on shelves: books, the audiobook walkman and the CD player
Downloads on shelves
Music playing in the CD player
Music from Plex
The audiobook player: a cassette walkman
Audiobooks
Notes from Memos
Notes from Memos
The Bookshelf theme screen: plank, ornaments and a preview of your shelf
Bookshelf theme and ornaments
Drawing in a note: pen, eraser, undo, paper, pages
Drawing notes
A note's drawing on the Notes tab
Drawings in Memos notes
The House tab: Home Assistant rooms, lights and a thermostat
House: Home Assistant

More screenshots

What it does

  • 📖 Reading: EPUB, PDF, MOBI, AZW3, FB2, CBZ and more, with KOReader's reader and the ZenOS interface. Your place (to the exact spot), bookmarks, highlights and notes sync both ways with Grimmory, with ratings and reading sessions for its statistics, so you can carry on in Grimmory's web reader or another Kindle.

  • 📚 The Catalog: one tab, three pages you swipe (or page) between, each laid out like a shop: covers on display ledges, then a bookcase of lists. Pick something, and it downloads in the background:

    • Books from Grimmory: Continue reading, Recently added, All books, libraries, shelves, authors, series and search. Download or Download & open; your place, bookmarks, highlights and ratings stay in sync with Grimmory.
    • Audiobooks from Grimmory (or a Plex library): Continue listening, Recently added, authors, shelves, series. Download & listen opens the player, and your place is kept.
    • Music from Plex: Recently played, Recently added, playlists, albums and artists as CD cases. Download for offline, or Play: it starts as soon as the first track is in.

    Audiobooks and Music are on Kindles with a speaker or headphone jack (Kindle 2, 3, DX, Touch) or with Bluetooth (Scribe, Paperwhite 5 and newer…); the others have the Books page.

  • 🗄️ Bookshelves: your books stand on shelves, spines out; the one you pick turns to show its cover. Audiobooks sit on the shelf as a cassette walkman (each one a cassette tape inside), music as a CD player (each album a CD). Lists and tiles are a tap away.

  • 🪴 Ornaments: a plant, a clock, a model ship or a pumpkin in October stands where a shelf has room, on an oak, walnut or plain plank, or your own pictures. Pick them on a screen of tiles with a preview of your shelf (hold an ornament to open it); in colour on the Kindle Colorsoft.

  • 🌐 Set up from your browser: scan one QR code, or type the Kindle's address into any browser on your Wi‑Fi and enter the PIN it shows. One page connects everything (single sign-on works too).

  • 📤 Send books from your browser: pick EPUBs, PDFs and other books on your phone or computer and they land in the Kindle's Downloads, ready to read; pictures sent the same way become sleep screens.

  • 🔁 Copy connections from another GZreader over the Wi‑Fi with a PIN.

  • 🔌 No Wi‑Fi? Sync with a computer (Kindle 2, DX): plug the Kindle in and open the sync page in Chrome or Edge. Your reading goes to Grimmory; books, audiobooks and Plex music (chosen on the Kindle or the page), notes, calendars, GZreader updates and a copy of your library (to browse the Catalog tab) come back.

  • 📝 Notes: your Memos notes as sticky notes; tick checklists, journal entries, offline too. On touch Kindles, a rich text editor like Memos' own: headings, bold and italic, lists, numbered lists, checklists and tags from a formatting bar, typed straight into the formatted note.

  • ✏️ Drawing notes (touch and pen Kindles): full drawing in a note with a finger, or with the pen on a Kindle Scribe: pressure, the side button erases, and your hand can rest on the screen. Pen, fountain pen, marker, pencil, highlighter and eraser, undo and redo, pinch zoom, pages, notepaper (ruled, Gregg, dot grid, graph, Cornell); drawings go to Memos as Memos' own drawings, and ones made in Memos open and edit on the Kindle.

  • 📅 Calendars: CalDAV accounts and calendar links (Proton, Google, Outlook…): agenda, day, week, month.

  • 🎵 Music (Kindles with audio or Bluetooth): albums and playlists from Plex, played while you read, in a portable CD player with its queue on the back of the case. The quick panel gets a Music tile while it plays. A Music tab of its own is in Settings → Home and tabs → Tab bar → Tabs.

  • 🏠 House: your Home Assistant rooms on a tab: switch lights (and dim them), switches, thermostats, locks, garage doors and scenes, straight over your Wi‑Fi.

  • 🔊 Read aloud (Kindle 2, 3, DX, Touch; Bluetooth Kindles): any EPUB, MOBI, AZW3, FB2 or TXT read to you in the Kindle's own voice, the sentence being spoken highlighted and the pages turning by themselves. Shift + Sym plays and stops, like the stock Kindle.

  • 🎧 Audiobooks (Kindles with audio or Bluetooth): a cassette walkman with chapters, a sleep timer and the volume keys; your place syncs with Grimmory's audiobook progress.

  • 🎧 Bluetooth (Scribe, Paperwhite 5 and newer…): pair and connect headphones or a speaker in Settings; audiobooks, music and read aloud play through them.

  • 🔋 Wi‑Fi only when needed, a built-in English dictionary, updates from GitHub.

All the details are in the wiki: feature overview, device compatibility, what's changed from KOReader and ZenOS.

Install

  1. Jailbreak the Kindle (and install KUAL on the Kindle 2, 3, DX, 4 and Touch): Jailbreaking and rooting, or kindlemodding.org's Jailbreak Wizard.

  2. Download the package for your Kindle from the latest release:

    Kindle Package
    Kindle 2, Keyboard (3), DX gzreader-kindle-legacy-<version>.zip
    Kindle 4, Kindle Touch, Paperwhite 1 (untested) gzreader-kindle-<version>.zip
    Any Kindle on firmware 5.16.3 or newer: Paperwhite 3, Scribe, untested: Paperwhite 4, 5, 6, Kindle 2019, 2022, 2024, Oasis 3, Scribe Colorsoft, Colorsoft gzreader-kindlehf-<version>.zip
    Paperwhite 2 and newer on firmware 5.16.2.1.1 or older: Paperwhite 3, untested: Paperwhite 2, 4, 5, Voyage, Oasis 1–3, Kindle 2014, 2016, 2019, 2022 gzreader-kindlepw2-<version>.zip

    The firmware version is in the Kindle's Settings → Device Info.

    Kobos (test build): gzreader-kobo-<version>.zip, for every Kobo KOReader runs on. No jailbreak: install NickelMenu or KFMon, unzip the package onto the Kobo's drive, eject, and start GZreader from NickelMenu (or the GZreader book with KFMon): Kobo in the wiki.

  3. Unzip it and copy its folders to the top of the Kindle's USB drive, merging with what's there (your books stay). Eject.

  4. Start it: KUAL → GZreader → Start GZreader, or on a Paperwhite or newer the GZreader item on the Kindle's home screen. The setup guide shows a QR code for your phone, and an address and PIN for any browser.

Updates come by themselves (Settings → General → Software update). Step-by-step help for each package, uninstalling, Kobos and the Nooks: Installing in the wiki.

Privacy

Passwords and tokens stay on the Kindle and are never written to its log. GZreader sends no usage statistics. It can send debug reports (errors, freezes, crashes; their log lines can name a book) to help fix problems, only if you choose: the setup guide or Settings → General → Send debug reports automatically (what's sent).

More

Credits and license

Built on KOReader (AGPL-3.0) and ZenOS, connecting to Grimmory. Dictionary: Open English WordNet (CC BY 4.0). GZreader is free software under the GNU Affero General Public License v3; KOReader's README is README.koreader.md.

About

Your Grimmory library on a Kindle, from the Kindle 2 and Nook 1 to the Scribe. Read, and keep your place, bookmarks, highlights and notes in sync; send books from your browser; listen to audiobooks and Plex music; write and draw notes; see your calendars.

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Used by

Contributors

Languages