# ShelfBridge

ShelfBridge is a self-hosted automation app. Sync your audiobook reading progress from Audiobookshelf to Hardcover automatically. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/3306/shelfbridge

## Description

Sync your audiobook reading progress from Audiobookshelf to Hardcover automatically.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

76/100 (Good), based on 5 of 5 factors.
- Maintained: 100 (last commit 23 days ago)
- Popular: 44 (160 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Light to run: 85 (512 MB minimum RAM)
- Security check: 100 (no serious findings, CI, tests)

## Links

- Unraid: https://ca.unraid.net/apps/shelfbridge-0t56nof1slhis3?q=ShelfBridge
- GitHub: https://github.com/rohit-purandare/ShelfBridge

## 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.

---
Source: Our Local Host (https://ourlocalhost.com/app/3306/shelfbridge), the self-hosted and open-source app directory.
