diff --git a/docs/user/devices/koreader-setup.md b/docs/user/devices/koreader-setup.md index 78681042..9eb8afde 100644 --- a/docs/user/devices/koreader-setup.md +++ b/docs/user/devices/koreader-setup.md @@ -1,12 +1,18 @@ + source when the plugin changes. KOReader ITSELF is out of scope: this + guide supports the plugin only, and installation is delegated to the + KOReader project's own documentation (README #installation, verified + 2026-11-02 — per-device wiki pages for Android, Kindle, Kobo, + PocketBook, reMarkable, and more). --> # KOReader Device Setup Guide This guide will help you set up KOReader on your e-reader device to sync with Bookhoard — reading position, bookmarks, highlights, notes, and even your -ratings, reviews, and reading time. +ratings, reviews, and reading time. One scope note up front: this guide is +about the **Bookhoard sync plugin**. Installing KOReader itself is a +different project's documentation, covered below. ## What is KOReader? @@ -26,52 +32,26 @@ Before you begin, make sure you have: - ✅ A Bookhoard instance running and accessible on your network - ✅ A web browser logged in to your Bookhoard account (for device approval) -- ✅ A KOReader-compatible e-reader device +- ✅ KOReader installed and running on your e-reader (see next section) - ✅ Your device connected to the same Wi-Fi network as your Bookhoard instance ## Installing KOReader -### Kindle Devices +One honest note first: **Bookhoard supports the Bookhoard sync plugin — +not KOReader itself.** Getting KOReader onto an e-reader usually involves +device-specific steps (jailbreaks, alternative launchers, one-click +packages) that vary by model and firmware. That's the KOReader project's +domain, not ours — we can't tell you how to modify your particular device, +and we won't pretend otherwise with half-remembered instructions. -1. **Install KOReader** - - Download the latest KOReader release from [koreader.rocks](https://koreader.rocks/) - - Extract the `koreader` folder to your Kindle's root directory - - Safely eject your Kindle from your computer +The good news: KOReader documents this properly. Their installation guide +routes you to model-specific steps for Android, Kindle, Kobo, PocketBook, +reMarkable, and more: -2. **Launch KOReader** - - On your Kindle, go to Home → Settings → Device Options → Personalize Your Kindle - - Select `koreader` from the launcher options - - Alternatively, you can use the `linkjail` method to access KOReader directly +**→ [KOReader installation guide](https://github.com/koreader/koreader#installation)** -3. **Enable Wi-Fi** - - In KOReader, tap the network icon in the top menu - - Connect to your Wi-Fi network - -### Kobo Devices - -1. **Install KOReader** - - Download the latest KOReader Kobo package from [koreader.rocks](https://koreader.rocks/) - - Copy the `koreader` folder to your Kobo's `.adds/` directory - - Safely eject your Kobo from your computer - -2. **Launch KOReader** - - Eject and disconnect your Kobo - - Kobo will restart and you'll see KOReader as an option - - Alternatively, create a shortcut on your home screen - -3. **Enable Wi-Fi** - - In KOReader, tap the network icon - - Connect to your Wi-Fi network - -### PocketBook Devices - -1. **Install KOReader** - - Download the PocketBook version from [koreader.rocks](https://koreader.rocks/) - - Copy to your device and install via the package manager - -2. **Launch KOReader** - - Open KOReader from your apps menu - - Enable Wi-Fi in the network settings +Once KOReader itself is installed and running, everything below applies, +whatever device you're on. ## Connecting KOReader to Bookhoard @@ -296,7 +276,7 @@ For day-to-day control of the same question on the device itself, use the ## Additional Resources -- [KOReader Documentation](https://github.com/koreader/koreader) -- [KOReader Forum](https://www.mobileread.com/forums/forumdisplay.php?f=271) +- [KOReader](https://github.com/koreader/koreader) — [installation](https://github.com/koreader/koreader#installation) · [user guide](https://koreader.rocks/user_guide/) +- [KOReader Forum](https://www.mobileread.com/forums/forumdisplay.php?f=276) — the project's official Mobileread subforum - [Bookhoard Universal Sync Guide](../sync-guide.md) - [Bookhoard KOReader Plugin](https://git.linuxhg.com/Bookhoard/bookhoard.koplugin)