Skip to content

ShelfBridge v0.1.0

Latest
Latest

Choose a tag to compare

View all tags
@kaylaehman kaylaehman released this 18 Jun 02:05
v0.1.0
4763b12

ShelfBridge v0.1.0 — export your Calibre library to reading-tracker and productivity services.

Services

  • Goodreads / StoryGraph — CSV in the Goodreads import schema (no setup beyond an output folder)
  • Google Sheets — writes your catalog into a Sheet you own; idempotent re-export (clear + rewrite)
  • OneDrive — uploads the CSV via Microsoft Graph

Highlights

  • Secure credentials in the OS keychain (Windows Credential Manager / macOS Keychain / libsecret), with a logged plaintext fallback
  • Automatic retry/backoff with Retry-After handling for API calls
  • Automation: export on library change or on a schedule
  • Read-only with respect to your Calibre library

Install

Download shelf_bridge.zip below, then in Calibre: Preferences → Plugins → Load plugin from file, or:

calibre-customize -a shelf_bridge.zip

Requires Calibre 6.0+ (PyQt5 on 6.x, PyQt6 on 7.x+).

Setup

OneDrive and Google Sheets each need a free OAuth app (one-time) — see the Setting up Google Sheets and Setting up OneDrive sections of the README. Goodreads/StoryGraph need no credentials.

Verified on Calibre 9.9 / PyQt6 / Python 3.14: plugin loads, config dialog opens, keyring active, CSV export confirmed end to end.

Assets 3
Loading