[GUI Plugin] ShelfBridge - Export your library to Goodreads/StoryGraph, Google Sheets

[kaylaehman]

ShelfBridge exports your Calibre library to reading-tracker and productivity services.

Supported services

• Goodreads / StoryGraph — a CSV in the Goodreads import schema (StoryGraph accepts the same file). No account setup needed.
• Google Sheets — writes your catalog into a Sheet you own. Re-exports are idempotent (the sheet is cleared and rewritten), so scheduled runs never pile up duplicates.
• OneDrive — uploads the CSV via Microsoft Graph (device-code sign-in).

Features

• CSV written UTF-8 with BOM so it opens cleanly in Excel.
• Credentials stored in your OS keychain (Windows Credential Manager / macOS Keychain / libsecret), with a clearly-logged plaintext fallback.
• Automatic retry/backoff that honours rate-limit Retry-After headers.
• Automation: export on library change or on a schedule (15 min through daily).
• Read-only with respect to your Calibre library.

Installation
Download the attached shelf_bridge.zip, then in Calibre: Preferences -> Plugins -> Load plugin from file. Restart when prompted. A ShelfBridge button appears on the toolbar.

Setup
Goodreads/StoryGraph need only an output folder. OneDrive and Google Sheets each need a free, one-time OAuth app — step-by-step instructions are in the README:
https://github.com/kaylaehman/ShelfBridge

Source and releases: https://github.com/kaylaehman/ShelfBridge/releases
Licensed GPL-3.0.

Requirements: Calibre 6.0+ (PyQt5 on 6.x, PyQt6 on 7.x — both supported).

Version history

• 0.1.0 — initial release: Goodreads/StoryGraph CSV, Google Sheets, OneDrive; automation; keychain credential storage.

[Comfy.n]

Sounds like a hot idea but where is config?

[Rellwood]

Is there ANY CHANCE of fixing it to send up multiple read dates?

[kaylaehman]

Update — v0.1.1 is out (attached below, and on GitHub).

@Comfy.n — good catch, and a fair hit: v0.1.0 actually shipped with no working way to open the settings. Fixed in v0.1.1. You can now configure it two ways: Preferences -> Plugins -> ShelfBridge -> Customize plugin, or the toolbar button's Configure Services... menu.

@Rellwood — not yet, but noted. Today each book exports a single Date Read (the most recent). Goodreads' own importer only accepts one date per book anyway, but for the Google Sheets / OneDrive exports I can add an option to emit all read dates — I'll look at it for a future build.

Also new in v0.1.1

• Configurable columns (Google Sheets & OneDrive) — choose which fields become columns, reorder them, and rename the headers, like Calibre's catalog export. Goodreads/StoryGraph keep their fixed import schema.
• Export scope — export your entire library or a single virtual library.
• Credentials now load correctly from the OS keychain when installed as a zip; faster custom-column reads on large libraries.

Grab shelf_bridge.zip below, or from GitHub: https://github.com/kaylaehman/ShelfBridge/releases

Thanks for the early feedback!

[kaylaehman]

Originally Posted by Rellwood

Is there ANY CHANCE of fixing it to send up multiple read dates?

Filed it so you can follow/track it: https://github.com/kaylaehman/ShelfBridge/issues/1

I've also enabled GitHub Issues for ShelfBridge, so feature requests and bug reports can go there: https://github.com/kaylaehman/ShelfB...ues/new/choose — questions and general chat are still welcome here.

[Rellwood]

I don't know how it could be done at this point. Although I have all my start, finish dates in Goodreads appended to their library export via a program I tweaked, I still have no idea how to get them into a format that can be imported. I have so many re-reads that it's prevented me from really updating my Library Thing, HardCover or Story Graph account. It also doesn't help that the books being imported are lacking because the data is missing from ASINs. I have exclusively amazon books and they are all linked and synced with my Calibre and Kindles. This is why I am having trouble moving.

[kaylaehman]

Bug reports & feature requests -> GitHub Issues

Found a bug or have an idea? Please file it on GitHub so it's tracked and doesn't get lost:
https://github.com/kaylaehman/ShelfB...ues/new/choose

Setup help, usage questions, and general discussion are very welcome right here in this thread.

[Comfy.n]

Hmm, I think users are more used to see the plugin toolbar button caption match the plugin name: action_spec = ('Export Catalog'.

But that's fine, I think I made this choice on some plugins. Config is now fine, too.

If you want to publish it in the Index, let me know! More info here: Index of plugins.

[kaylaehman]

@Comfy.n — yes please, I'd love to get it into the Index! Thank you for the offer. I'll go through the steps in the Index thread — just let me know if you need anything specific from me.

And good call on the toolbar caption: I've changed it from "Export Catalog" to "ShelfBridge" to match the plugin name (it's committed and will be in the next build). Glad the config side is sorted now too — thanks for flagging both.

[kaylaehman]

v0.1.2 is up (attached) — the toolbar button now reads "ShelfBridge" instead of "Export Catalog", per your suggestion @Comfy.n. Thanks again!

For the Index, here's the entry info:

• Name: ShelfBridge
• Thread: https://www.mobileread.com/forums/sh...d.php?t=374017
• Description: Export your Calibre library to a Goodreads/StoryGraph CSV, a Google Sheet, or Microsoft OneDrive — with configurable columns and whole-library or virtual-library scope.
• Donate: GitHub Sponsors — https://github.com/sponsors/kaylaehman

(Version / author / calibre version / platforms are all in the plugin itself.)

One snag: the v0.1.2 zip is attached to this post, but my edit window on the first post has long expired, so I can't swap the attachment there. Could a moderator please attach this v0.1.2 zip to the first post (replacing the older one) so the Plugin Updater serves the current version? Happy to do whatever's easiest — thanks!

[Comfy.n]

Originally Posted by kaylaehman

One snag: the v0.1.2 zip is attached to this post, but my edit window on the first post has long expired, so I can't swap the attachment there. Could a moderator please attach this v0.1.2 zip to the first post (replacing the older one) so the Plugin Updater serves the current version? Happy to do whatever's easiest — thanks!

Done. You're welcome!

IIRC, the new member restrictions are lifted after 10 posts or a given length of time as a member.

[kaylaehman]

Got it. Thank you!