ShelfBridge

Sync your audiobook reading progress from Audiobookshelf to Hardcover automatically.

  • Automation
  • Media Servers
  • Tools & Utilities
Sync your audiobook reading progress from Audiobookshelf to Hardcover automatically.

Platform availability

Available on 1 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

76/100 Good

Maintained
100last commit 23 days ago
Popular
44160 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
85512 MB minimum RAM
Security check
100no serious findings, CI, tests

Availability: platform listings confirmed today, links checked 18 days ago

GitHub stars
160
Open issues
30
Last commit
2026-10-29
Latest release
v1.23.14
License
MIT
Activity
rising

Checked 6 days ago - source: GitHub (rohit-purandare/ShelfBridge)

Resources & Compatibility

Minimum requirements: 512 MB RAM, 100 MB disk.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Replace placeholder tokens before starting In the sample config or Docker setup file, replace the placeholder tokens with your username, server URL, and API tokens (secret keys). If these are missing or wrong, ShelfBridge cannot connect to your book servers. source
  • Use Node.js 22 or 24 for direct installs If you are not using Docker, install Node.js 22 or 24 first because Node.js is the program that runs ShelfBridge. A missing or unsupported version can make the install or start command fail. source
  • Keep a backup of your config file If you use the text config file, keep a safe copy of config/config.yaml because it stores your server addresses and tokens. Losing it means re-entering all your connection details from scratch. source
  • Docker Compose Setup Download the docker-compose.yml from the GitHub repository, set your Audiobookshelf server URL and access tokens plus your Hardcover token, then run docker-compose up -d to launch the container. source

Fetched today - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

Can I run ShelfBridge without Docker?

Yes. For direct installs use Node.js 22 or 24, run npm install, copy the example config to config/config.yaml, and start it with node src/main.js start. Docker is the recommended deployment path.

How do I set up multiple family accounts?

Configure one user per account with its own Audiobookshelf and Hardcover credentials. Use the YAML config when you need different per-user settings or complex family configurations.

Can I exclude podcasts or samples from syncing?

Yes, use the YAML configuration to include or exclude specific libraries. This library filtering is not available with the basic environment-variable setup.

How does ShelfBridge match books that do not have an ASIN or ISBN?

Use the YAML configuration to enable intelligent fuzzy matching by title and author. This advanced matching option is not available in the basic environment-variable setup.

Answers sourced from github.com

Community

Collected 49 days ago - public community threads