Repository navigation
Install Kobo
Package: gzreader-kobo-<version>.zip — for every Kobo KOReader runs on: Touch, Mini, Glo, Glo HD, Aura (all of them), Touch 2.0, Clara HD, Clara 2E, Clara BW, Clara Colour, Forma, Libra H2O, Libra 2, Libra Colour, Nia, Sage, Elipsa, Elipsa 2E. A test build: it has been run in GZreader's emulator as a Clara HD and a Libra 2, not yet on a real Kobo. Try it on a Kobo whose books you've backed up, and send back what happens. How to use it: Kobo.
A Kobo needs no jailbreak. GZreader starts from NickelMenu (an item in the Kobo's menu) or KFMon (a "GZreader" book in your library): you need one of them. NickelMenu is the simpler one, and a Kobo update doesn't remove it.
-
Install NickelMenu (pgaskin.net/NickelMenu: copy its
KoboRoot.tgzinto the Kobo's.kobofolder, eject; the Kobo installs it and restarts), or KFMon (its package unzipped onto the drive: KOReader's Kobo guide has both). -
Plug the Kobo into a computer and download
gzreader-kobo-<version>.zipfrom the latest release. -
Unzip it onto the Kobo's drive (
KOBOeReader), at the top: you get a hidden.addsfolder (on a Mac press ⌘ ⇧ . to see it) and a picture,gzreader.png. If a.addsfolder is there already, merge them (don't replace it: NickelMenu and KFMon keep their files there too).- GZreader goes into
.adds/koreader, where KOReader goes. A KOReader installed there is replaced by GZreader (its settings folder stays). - With NickelMenu and no KFMon, delete
gzreader.png: it's only KFMon's book.
- GZreader goes into
-
Firmware 4.17 and newer: keep the Kobo from listing GZreader's own files as books. Open
.kobo/Kobo/Kobo eReader.confon the drive in a text editor and add, under[FeatureSettings](make that line if there isn't one):ExcludeSyncFolders=(\\.(?!kobo|adobe).+|([^.][^/]*/)+\\..+) -
Eject the Kobo and unplug it. It takes in what's new (and restarts, the first time with NickelMenu or KFMon).
-
Start GZreader: NickelMenu: the GZreader item in its menu (bottom right of Home, or the main menu). KFMon: open the GZreader book in your library.
The first start shows the setup guide, as on a Kindle: Installing → After installing. Books you download go to the GZreader folder at the top of the Kobo's drive; the Kobo's own library lists them too.
Back to the Kobo's own software: the quick panel (swipe down from the top) → Exit to Kobo.
-
No GZreader item or book: check that the folders are
.adds/koreaderand.adds/nm(or.adds/kfmon) at the top of the drive, not inside another folder. With KFMon, a Kobo update turns KFMon off: install it again. -
It flashes and goes back to the Kobo's Home:
.adds/koreader/crash.logon the drive says why. Attach it to an issue. - Something else: quick panel → Diagnostics → Send to the developer, or Save to the Kobo and attach the file. → Diagnostic log
What to send back from a first try: which Kobo and firmware (Settings → Device information), whether it started, a photo if the screen looks wrong, and .adds/koreader/crash.log.
Installing
- Installing
- Jailbreaking and rooting
-
Kindle 2, 3, DX ·
kindle-legacy -
Kindle 4, Touch ·
kindle -
Touch Kindles, firmware ≤ 5.16.2 ·
kindlepw2 -
Touch Kindles, firmware 5.16.3+ ·
kindlehf -
Kobo ·
kobo -
Nook 1st Edition ·
nook-1st-edition -
Nook Simple Touch ·
nook - Updating and uninstalling
Using it
- Using GZreader
- Settings
- Setup page and connections
- Grimmory library
- Grimmory sync
- Home and bookshelves
- Picture books
- Notes
- Calendar
- Music
- House (Home Assistant)
- Daily paper
- Audiobooks and read aloud
- Sync with a computer
- Wi‑Fi: on, off, auto
- Bluetooth
- Updates and test builds
- Privacy and diagnostics
- Kobo
- Nook 1st Edition
- Nook Simple Touch
Under the hood