ShelfBridge
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
Variants
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
- Shelf | Asset Tracking Made Simple : r/selfhosted - Reddit (reddit)
- Self hosted asset management system - shelf.nu : r/selfhosted - Reddit (reddit)
Collected 49 days ago - public community threads