Repository navigation
Install Kindle HF
Package: gzreader-kindlehf-<version>.zip — for any Kindle on firmware 5.16.3 or newer: the Paperwhite 3 (tested), and untested: Paperwhite 4, 5 and Signature Edition, Paperwhite 6, Kindle 2019, 2022, 2024, Oasis 3, Scribe, Colorsoft (shown in greys). Built on KOReader's kindlehf package (hard-float, for the newer system libraries).
On firmware 5.6.1 – 5.16.2.x take the kindlepw2 package instead. The firmware version is in Settings → Device Options → Device Info.
Use the method kindlemodding.org's Jailbreak Wizard names for your Kindle and firmware: Jailbreaking and rooting → Paperwhite and newer. Newer firmware is patched against older methods, so check before updating a jailbroken Kindle: one updated past what any jailbreak handles can't be jailbroken until a new method comes out (and can't be downgraded without one).
From the latest release, take gzreader-kindlehf-<version>.zip.
- Connect the Kindle to the computer with USB; it shows up as a drive.
- Unzip the package on the computer. Inside are the folders
koreader,extensionsanddocuments(with one file,GZreader.sh). - Copy those folders to the top of the Kindle's drive, merging with what's there (your books stay). If an old KOReader is installed, its
koreaderfolder is replaced. - Eject the Kindle safely and unplug it.
- Tap the GZreader item with GZreader's logo on the Kindle's home screen (
documents/GZreader.sh, a scriptlet, which the current jailbreaks run). - Or, with KUAL: GZreader → Start GZreader.
The setup guide runs on the first start (After installing), followed by a short tour of the quick panel.
- Touch throughout. → Using GZreader → Touch Kindles
- Kindles with a frontlight get a light slider in the quick panel; those with a warm light (Paperwhite 5 and newer, Oasis 3, Scribe, Colorsoft) also a warmth slider, Cool to Warm. → Using GZreader → Touch Kindles
- These Kindles have no speaker or headphone jack (the newer ones play audio over Bluetooth only, which GZreader doesn't use): audiobooks, music and read aloud aren't offered.
Updating and uninstalling: Updating and uninstalling.
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 -
Nook 1st Edition ·
nook-1st-edition -
Nook Simple Touch ·
nook - Updating and uninstalling
Using it
- Using GZreader
- Setup page and connections
- Grimmory library
- Grimmory sync
- Home and bookshelves
- Picture books
- Notes
- Calendar
- Music
- House (Home Assistant)
- Audiobooks and read aloud
- Sync with a computer
- Wi‑Fi: on, off, auto
- Updates and test builds
- Privacy and diagnostics
- Nook 1st Edition
- Nook Simple Touch
Under the hood