inkstream.
Setup guide

Put Inkstream on your PocketBook.

Four steps: install KOReader, add the Inkstream plugin, sign in, and protect it against firmware updates. No unlocking needed — a PocketBook lets you add apps over USB.

Time15 minutes
You needA computer + USB cable
ReversibleYes
The easy way Signed in to Inkstream? The installer does steps 01 to 04 for you in Chrome or Edge: plug in the PocketBook, pick it, done — nothing to drag or type.
01

Install KOReader

KOReader is the reading app Inkstream runs inside. It handles EPUB, PDF, CBZ, FB2, DjVu and more, and it's where the plugin lives. On a PocketBook you install it by copying a few files across.

  1. On your computer, download koreader-pocketbook-v2026.07.1.zip (40 MB) and unzip it. Use this version or a newer one from the KOReader releases — older versions crash on current PocketBook firmware.
  2. Connect the PocketBook with its USB cable. On the reader, choose to connect to the computer (usually PC link). It shows up as a drive.
  3. Copy two things, not the download folder. Open the unzipped applications folder on your computer. Select the koreader folder and the koreader.app file inside it, and drop those two into the applications folder on the reader. They must sit directly in it: applications/koreader.app, not inside another folder. Don't drag the download folder or the applications folder itself — the reader then can't find KOReader, and on a Mac Finder may replace what's already there.
  4. Open system → bin on the reader and copy koreader.app from the unzipped system/bin into it. Can't see system? Your computer hides it: on a Mac press Cmd + Shift + . in Finder; on Windows choose View → Show → Hidden items. No bin inside system? Create it.
  5. Eject the reader, unplug it and restart it (hold the power button). In Apps, KOReader is listed as @koreader, often at the bottom among the apps you added. It opens with a file browser — that is KOReader. Swipe down from the top for its menu.
02

Add Inkstream

The plugin adds Inkstream to KOReader's menu and sends your highlights, notes and reading sessions to your shelf over Wi-Fi.

  1. Download inkstream-plugin.zip on your computer and unzip it.
  2. Connect the PocketBook again and copy the inkstream.koplugin folder into applications/koreader/plugins on the reader. Check the folder is named exactly inkstream.koplugin — KOReader ignores it otherwise.
  3. Eject, unplug, and open KOReader. If it was still open, close it first with ☰ → Exit.
03

Sign in

  1. Make sure Wi-Fi is on, then in KOReader open ☰ → More tools → Inkstream.
  2. Enter the username and password you chose when you created your account. The server address is already set.
  3. Choose Test connection. Sync is on by default, so everything you mark appears on your shelf after the next Wi-Fi sync. (You can pause it any time with Enable highlight sync in the same menu.)
No account yet? Inkstream is invite-only for now. Ask the person who told you about it for an invitation link — you choose your username and password when you open it.
04

Protect it against firmware updates

PocketBook firmware updates sometimes remove KOReader's launcher, so the icon stops working even though your books and settings are still there. KOReader Rescue keeps a copy and puts it back.

  1. Download KOReader-Rescue.app and copy it into the applications folder on the reader, next to koreader.app.
  2. Eject, unplug, and open KOReader-Rescue from Applications once. It says Armed: your launcher is saved.
  3. If KOReader ever disappears after an update, open KOReader Rescue again. The repair page explains the rest.
──

When something breaks

  1. KOReader isn't in Applications. Check that koreader.app sits directly in applications on the reader, not in a folder inside it. Then restart the reader.
  2. KOReader shows "Don't Panic" or closes straight away. The version is probably too old for your firmware. Repeat step 01 with version 2026.07.1 or newer.
  3. KOReader stopped opening after a firmware update. Open KOReader Rescue (step 04), or follow the repair page.
  4. Inkstream isn't in the menu. Close KOReader with ☰ → Exit and reopen it. Then check the plugin folder name and place (step 02).
  5. Test connection fails. Check Wi-Fi is on, then sign in on the website with the same username and password to make sure they're right.