Skip to main content

BookFusion Plugin for Calibre

Do you use Calibre to organize your eBook library and want to sync it into BookFusion so you can read across multiple devices while keeping your progress and highlights in sync? The BookFusion Calibre plugin makes this easy.

This guide covers:

Download and Install the Plugin​

Step 1 — Open Calibre Preferences​

From within Calibre, open the Preferences screen and click the Plugins option in the Advanced section at the bottom.

Calibre Preferences

Step 2 — Install the Plugin​

You have two options:

Option A — Install from the plugin directory

  1. On the Plugins screen, click "Get new plugins" at the bottom.

Calibre Preferences screen showing the Plugins option in the Advanced section

  1. In the filter field at the top right, type BookFusion and select the BookFusion plugin from the results and click "Install", then confirm.

Calibre Preferences screen showing user plugins

Option B — Install manually

  1. Download the plugin file manually.
  2. On the Plugins screen, click "Load plugin from file" — it will install automatically.

Calibre Preferences showing plugin

Quick Heads-up!

After installing, you may be prompted to add a BookFusion icon to your toolbar or context menu for quick access. Once confirmed, restart Calibre before proceeding to configuration.

Configuring the Plugin​

Step 1 — Open Plugin Settings​

From the Plugins screen, expand the "User interface action" section, select the BookFusion Plugin, and click "Customize plugin".

Calibre Preferences showing plugin to customize

Step 2 — Enter Your API Key and Preferences​

You'll be prompted to enter:

  • BookFusion API Key (required)
  • Update metadata during sync — recommended to keep this enabled
  • Sync threads — how many books to process simultaneously. If you have a slower internet connection, set this to 1 or 2.

Calibre Preferences showing plugin to customize and enter api key

Step 3 — Get Your API Key​

  1. Go to your BookFusion account settings and navigate to Integrations → Calibre.
  2. Copy the generated key and paste it into the Calibre plugin configuration screen.

BookFusion account to generate api key

Using the Plugin​

Sync Your Entire Library​

For a first-time sync, it's recommended to do a full library sync:

  1. Click the BookFusion icon on your toolbar (or wherever you placed it).

Sync books in calibre

  1. Select "Sync all books".
  2. In the sync dialogue, click "Start".

Sync all books in calibre

Depending on your library size, this may take a while — you can leave it running in the background. If your internet is interrupted mid-sync, simply run "Sync all books" again and it will resume where it left off.

Sync Selected Books Only​

If you've already done a full sync, or only want to push specific titles:

  1. Select the books you want in Calibre.
  2. Click the BookFusion icon and choose to sync only the selected books.

Sync all three books in calibre

Once complete, you'll see a confirmation summary for each book with one of these statuses:

StatusMeaning
uploadedNew book added to your BookFusion library
updatedExisting book synced with new metadata or cover
skippedNo changes detected since last sync
One-way sync

Currently, sync only goes from Calibre → BookFusion, not the other way around. Support for custom columns and automatic virtual bookshelf assignment is also planned for a future update.