English · العربية · Español · Français · 日本語 · 한국어 · Tiếng Việt · 中文 (简体) · 中文（繁體） · Deutsch · Русский

Kindle

A reproducible Kindle Paperwhite 2 jailbreak and KOReader setup workspace for firmware 5.12.2.2.

This repository records Lachlan's Kindle Paperwhite 6th generation / PW2 workflow: WinterBreak2 jailbreak staging, Universal Hotfix, MRPI, KUAL, KOReader, and LinguaLeaf PDF sync helpers. It tracks repeatable scripts, checksums, and notes; downloaded archives, extracted packages, staging trees, and device backups are intentionally ignored.

Donate	PayPal	Stripe

Status

Computer-side staging is complete. The remaining Kindle-side actions are:

1. Install Update_hotfix_universal.bin with Update Your Kindle.
2. After reboot, open the Run Hotfix booklet if it appears.
3. Search for ;log mrpi to install KUAL.
4. Open KUAL and launch KOReader.

Contents

Path	Purpose
docs/paperwhite2-5.12.2.2-koreader-jailbreak.md	Full jailbreak and KOReader procedure notes
docs/package-manifest.md	Reproducible package URLs and SHA-256 checksums
scripts/	Detection, staging, eject, checksum, and LinguaLeaf sync helpers
references/lingualleaf-koreader-sync.md	KOReader PDF sync notes and observed device behavior
firmware/	Reserved firmware notes
logs/downloads.sha256	Recorded package hashes

Ignored local folders include downloads/, packages/, staging/, and device-backups/.

Quick Start

Windows fast path:

cd C:\Users\Administrator\Projects\Kindle
powershell -ExecutionPolicy Bypass -File .\scripts\kindle-jailbreak.ps1 -Action Diagnose
powershell -ExecutionPolicy Bypass -File .\scripts\kindle-jailbreak.ps1 -Action DownloadModern

The Windows script detects the mounted Kindle, reads system/version.txt, and blocks unsafe method mismatches. See docs/windows-fast-jailbreak-runbook.md for the direct next-time workflow.

Verify downloaded package hashes:

./scripts/check-downloads.sh

Rebuild extracted package cache and copy-ready staging trees:

./scripts/build-staging.sh

Detect a mounted Kindle:

./scripts/detect-kindle.sh

Stage WinterBreak2 before the on-device jailbreak:

./scripts/stage-winterbreak2.sh

After WinterBreak2 succeeds, stage Hotfix, MRPI, KUAL, and KOReader:

./scripts/stage-post-jailbreak.sh

If auto-detection fails but the mount root is known:

./scripts/stage-winterbreak2.sh /media/lachlan/Kindle
./scripts/stage-post-jailbreak.sh /media/lachlan/Kindle

Kindle Book Sender

Download the native Windows, Ubuntu/Linux, Intel Mac, or Apple Silicon app:

https://lachlanchen.github.io/Kindle/

First use requires one USB connection so the app can generate a key for that computer and install only its public key on the Kindle. Later, put both devices on the same Wi-Fi, start KOReader's SSH server, click Find my Kindle, drag in books, and send. Discovery, IP selection, SFTP/SCP fallback, and the destination folder are automatic.

LinguaLeaf Sync

Sync LinguaLeaf PDFs into a KOReader-friendly folder:

./scripts/sync-lingualleaf-books.sh --all

The default targets are:

documents/LinguaLeaf/en-main-color/
documents/LinguaLeaf/en-main-blackwhite/

Source folders can be overridden:

LINGUALEAF_COLOR_DIR="/path/to/en-main-color" \
LINGUALEAF_BLACKWHITE_DIR="/path/to/en-main-blackwhite" \
./scripts/sync-lingualleaf-books.sh --all

Validation

bash -n scripts/*.sh
git diff --check
./scripts/detect-kindle.sh --help

Scope

This workflow is for running homebrew such as KOReader on a personally owned Kindle. It is not a DRM-removal workflow. Keep Airplane Mode on unless Wi-Fi is needed, avoid unintended OTA updates, and exit KOReader before USB file transfer.

Citation

If you use this workspace in research or documentation, cite the repository. GitHub reads CITATION.cff and shows a Cite this repository panel on the repo page.

@software{chen_kindle_2026,
  author = {Chen, Lachlan},
  title = {Kindle: Kindle Paperwhite 2 Jailbreak and KOReader Setup Workspace},
  year = {2026},
  url = {https://github.com/lachlanchen/Kindle}
}