Repository navigation
Troubleshooting
calibre's default toolbar holds built-in actions only, so no plugin appears there on its own, and resetting the toolbars removes any you added. The plugin notices and offers to add its button at startup. If you dismissed that, add it under Preferences → Toolbars & menus → The main toolbar.
Two reasons, both in the tooltip:
-
No PocketBook is connected — the reader must be plugged in and in USB
storage mode, showing up as a drive. The plugin detects a PocketBook by
finding
system/explorer-N/explorer-N.dbon the drive, not by which calibre driver is in use, so any driver that mounts it will do. - Run "Set up columns" first — the plugin has nowhere to put what it reads.
That is the normal result when nothing has changed on either side. The plugin remembers what both sides looked like last time and only proposes real differences — see How syncing works.
If you expected changes, check that the field is ticked under What to keep in step, and that it has a column on the Columns tab.
Usually the remembered state is missing or was cleared, so every difference looks new. The review dialog is the safety net here: look at the direction column before applying.
Books the reader has that calibre did not put there are deliberately left alone; Books on the device not in this library… lists them.
Books that moved on disk since calibre last looked may fall back to a weaker match. Weak matches are listed unticked rather than hidden; Pre-tick changes for on the Sync tab controls where that line sits.
PocketBook can rewrite its database from memory when the USB connection drops. Turn on Eject the device automatically after writing to it, and use Verify the last write… to see exactly which values were reverted and re-apply them. See Backups and safety.
Check the Device tab's capability list first: a firmware without a shelves table has those menu entries greyed out.
Otherwise it is usually the source setting. Only A custom column is two-way; tags, series and templates are read from calibre and never written back. See Collections.
The device probably has the same bad value calibre has. Fix the metadata in calibre first. Fixing author sorting explains how to tell.
Three things, in this order:
- Show device information… from the menu — model, schema version and capability flags. It contains no book titles and no file paths.
- Copy diagnostics to the clipboard, on the Advanced tab.
- What you did, what you expected, and what happened.
For a crash, tick Write diagnostic messages to the log on the Advanced tab,
start calibre with calibre-debug -g, reproduce it, and include the output.
Issue tracker · MobileRead thread
The plugin reads the database schema at connect time and turns off anything the firmware has no table for, so a different model should either work or degrade visibly rather than break. It was developed against an InkPad 3 Color on schema version 39.
If yours is different, please post Show device information… output — it is how the compatibility list gets longer.
Getting started
Reference
Features
Keeping it safe
Published from docs/wiki in the repository.