[GUI Plugin] Seekquel Sync

[sabriseekquel]

Seekquel Sync connects a Calibre library to Seekquel, a reading tracker. Shelves, ratings, reviews and reading dates travel in both directions, so the library you keep on your computer and the one you carry on your phone stay the same library.

Calibre 6 and later, on Windows, macOS and Linux. Free on every account, and GPL-3.0-or-later, the same licence as Calibre, which it loads into the process of.

Install
Download the attached zip, then Preferences > Plugins > Load plugin from file, and restart Calibre. A Seekquel button appears in the main toolbar.

Connect
Seekquel > Connect to Seekquel, then Start. Eight characters appear. In Seekquel, open Settings > Integrations > Calibre and enter them. Calibre picks up its key a second or two later and the dialog closes itself.

No account token is pasted anywhere. Calibre is handed a key that can only sync, that you never see, and that you can revoke from the same screen that lists your other devices.

Choose your columns
Seekquel > Settings. Every field is optional, and a column you leave unset is never read and never written.

• Status: text, column shown in the tag browser
• Rating: Calibre's own rating, or a rating column
• Review: long text, like comments
• Date started: date
• Date finished: date
• Progress (%): integers, or a floating point column

Status labels are read loosely, so a column already holding Read, Currently reading, TBR, On hold, DNF or Finished works without being renamed first.

Sync
Send my whole library, or select books first and use Send the selected books. It runs as a background job, so Calibre stays usable and you can stop it. Bring Seekquel up to date here pulls the other way and writes into the columns you mapped.

What it will not do

• It never clears anything. A field Seekquel does not hold leaves your column exactly as you typed it. Most people map two or three columns out of six, so reading an empty answer as a deletion would empty a library the first time anybody synced.
• It never overwrites a review. Whichever side is empty gets filled. Everything else is short enough that losing it costs a retype; paragraphs are not.
• It never un-marks a finished book. Marking a book read in Seekquel posts to a feed, counts towards a goal and can earn a badge. A status column you last touched two years ago is not grounds for taking that back.
• It never invents a book. A book the Seekquel catalogue cannot place is not guessed at and not silently filed as a private copy. It waits for you in the app, where you can look for it, point it at the right book, or set it aside. A real Calibre library holds manuals, RPG rulebooks and conference papers next to the novels, and those are refused correctly.
• Progress does not count as reading. Calibre is a library manager, not a reader, and cannot know when you read those pages. A percentage moves your place in the book and is never credited to a day's reading.

How a book is matched
By ISBN first, and by title and author after that. Downloading metadata in Calibre before the first sync is the single most useful thing you can do. A book the catalogue cannot place is looked up in the same book sources the catalogue itself is built from, bounded per sync and per day. That lookup is the only point at which anything about your books leaves Seekquel, and no rating, review or reading data is ever part of it.

When something is not right
Seekquel > Show the log lists every request the plugin made, what came back and how long it took, plus the books a sync skipped and the reason. The file is plugins/seekquel-sync.log in your Calibre configuration directory, and it trims itself. Please attach it to a bug report.

1.3.0
Fixes a results window that could freeze Calibre. If you installed an earlier version, please update.

Reports and questions welcome here.

[sabriseekquel]

Reserved for test builds.

Released versions are always attached to the first post. Anything posted here is a work in progress and may be replaced without notice.

[BetterRed]

I don't have, nor do I want anything, in the main toolbar. All I have is a menu bar with Preferences.

So when I installed this plugin I added it to the Optional toolbar; it's what I do with all new GUI plugins, while I decide if I want them, and how I will access them… Book list context menu, Favourites menu, All Actions menu, or a Shortcut,



What I got was a main toolbar with Seekquel [Sync], which I didn't ask for, and an optional toolbar with Seekquel [Sync], which I did ask for.



Why no icons? I have Icon size in Prefs-Look & feel set to Off, I also have Use two lines for the text under the icons checked, so would expect to see:

Seekquel
  Sync

I didn't change the configuration.

BR

[sabriseekquel]

Thanks for both of these. They are ours, not calibre's, and both are fixed in 1.4.1, which is up now.

The toolbar one was the plugin writing itself into action-layout-toolbar on first run, regardless of what you had chosen. That is why you got it in both places. The code is gone and it never touches your toolbar layout again. An entry it already added stays where it is, so removing it from the main toolbar now sticks.

Worth noting for anyone updating rather than installing fresh: calibre only offers the placement question on a first install, so an update lands nowhere and has to be added from Preferences, Toolbars and menus by hand.

On the label, you were right to expect two lines. The button text was "Seekquel", a single word, so it had nothing to wrap on. It is "Seekquel Sync" now. The icon itself was loading fine, it is just that Icon size set to Off draws text only, so the label was the whole of what you were seeing.

One correction to the index entry I sent you. The version is 1.4.1, not 1.3.0. 1.4.0 was tagged but never released, so the release page only carried 1.3.0 until today.

Name: Seekquel Sync
Internal name: Seekquel Sync
Author: Seekquel
Version: 1.4.1
Released: 2026-08-25
Minimum calibre version: 6.0.0
Platforms: Windows, OSX, Linux
Description: Sync shelves, ratings, reviews and reading dates with Seekquel, both ways.

I will attach the new zip to the first post shortly.

[rantanplan]

I didn't even realize there's yet another reading stats app.