KOReader's built-in sync carries your reading position. The Seekquel add-on also sends recorded reading time, passages, notes and reading status. You need KOReader installed before adding it.
If position is all you want, start with the built-in connection. Choose the add-on when you want the book's activity in your reading log.
Check your device before installing
KOReader runs on supported e-readers and other platforms. Installation differs by device. A stock Kindle needs compatible firmware and a jailbreak before it can run KOReader.
Read the upstream installation guidance for your hardware. This guide starts after KOReader already opens a book successfully. It does not claim that every Kindle or Kobo model supports installation.
Install and pair the add-on
- In Seekquel, open Settings, Integrations, then KOReader.
- Download the add-on and unzip it.
- Copy the seekquel.koplugin folder into koreader/plugins on your reader.
- Restart KOReader.
- Open Tools, Seekquel, then Connect this device.
- Enter the eight-character code in Seekquel on your phone or computer.
Keep the connection code private. You enter it in Seekquel; you do not type your account password on the e-reader.
The add-on can install later updates from its own menu when it finds a newer release. It asks you to act and restart. If the device cannot replace its files, use the manual installation route again.
See the setup screens
We checked these controls in a local demo of Seekquel's web app on 4 October 2026. The demo account had no reader connected.
Choosing Everything displayed the add-on download, installation steps and code field. Connect stayed unavailable while the code field was empty.
Choosing Progress only replaced those instructions with a Create a key button. Reading time, finished books and passages stay outside that connection.
These captures show the web setup controls. We did not pair a physical reader or measure a reading-time sync during this check.
Match the first file before relying on its record
Open a book and review its match in Seekquel. Confirm the title and edition instead of accepting a similar-looking cover.
A file that Seekquel cannot place waits for your answer. Choose the correct catalogue book, or choose Not in the catalogue for a private book. The add-on withholds that file's reading time and passages until you settle the match.
This matters with study PDFs, unusual editions and files named after an entire series. An incorrect match puts useful activity against the wrong book. Correct the match before treating the combined log as accurate.
Check position, minutes and passages separately
Read several pages while online, then choose Sync now in the add-on. Open the same book in Seekquel and check its position. Check today's reading time separately.
The add-on reads KOReader's recorded time and cannot reconstruct a session the statistics plugin missed. See the KOReader user guide for the reader's statistics settings.
Try a short passage and note if you want those to travel. Passages go from KOReader into Seekquel. A note you write in Seekquel does not return to the ebook. Deleting a passage on the reader leaves its saved copy in Seekquel.
The add-on sends the file's details for your private book where appropriate. It does not send cover images or overwrite the shared catalogue with your file's metadata.
Decide what this reader sends
Open Tools, Seekquel, then Settings on the reader. The corresponding device controls also appear under KOReader in Seekquel's integrations settings.
You can control reading time, passages, status changes and finishing at the end. Automatic passage sending has its own switch. Turning it off keeps passages on the device until you request a sync.
With Wi-Fi on demand initially off, make a connection yourself before you request a sync. Device changes take effect locally; a change from Seekquel waits until the reader connects and receives it.
A sync can hold the screen while the network request runs. A weak connection can therefore cause a visible pause. Check Sync status before repeatedly requesting another sync.
Continue from a later place in Seekquel
When a linked book opens online, the add-on checks for a later place logged in Seekquel. It asks before moving, and you can also choose Resume from Seekquel in the menu.
The match uses percentage, so inspect the nearby text after moving between formats. An audiobook timestamp and a printed page cannot specify an exact EPUB paragraph. Moving to the suggested place itself adds no pages or time.
For several devices, read the cross-device guide before expecting two different files to share an exact position.
When reading time does not arrive
First check the file's book match and switch on Send reading time. Then inspect KOReader's own statistics for today's book. If those statistics are missing, start with the reader's recording settings.
If KOReader recorded the minutes, check internet access and the add-on's Sync status. Distinguish a connection failure from a reader with nothing new to send. Record the device model and versions when reporting a problem.
Use the feedback board with the observed result, expected result and affected book. Keep private notes, account keys and pairing codes out of the report.