Self-host bindery
v1.48.0Automated ebook and audiobook manager for Usenet
- Stars
- 556
- Port
- 8787 (HTTP server port)
ghcr.io/vavallee/binderyWhat is bindery?
Bindery is a self-hosted, open-source tool that automates ebook and audiobook acquisition from Usenet and torrents. It watches authors you follow, queries Newznab and Torznab indexers in parallel, hands off downloads to clients like SABnzbd or qBittorrent, and files the results into a searchable library. Unlike Readarr, it relies on several documented public metadata APIs — OpenLibrary, Google Books, Hardcover, DNB, Audnex, Audible, plus optional Norwegian and French national libraries — so no single upstream outage can disable the app. A one-step import brings over a Readarr database (authors, indexers, download clients, blocklist). The stack is a single Go binary with an embedded React frontend, SQLite for storage, and no external database or sidecars. You can run it via distroless Docker images, Docker Compose, a Helm chart, or pre-built binaries for Linux, macOS, and Windows (including ARM down to a Pi Zero). The web UI has light/dark themes, works well on mobile, and serves an OPDS 1.2 catalogue for readers like KOReader. Auth options include local passwords, API keys, OIDC (Google, GitHub, Authelia, Keycloak), and forward-auth proxy (Authelia, Authentik, oauth2-proxy). Notifications go out through generic webhooks to services like Apprise, ntfy, Home Assistant, Discord, or Slack.
Should you self-host bindery?
bindery scores 59/100 on selfhost.directory (how scoring works) and ranks #3 of 19 in Ebook Management. It has 556 GitHub stars, +16 in the last 30 days.
It shipped 32 stable releases in the past year. The latest, v1.48.0, came out on 7 November 2026. New versions land roughly every 2 days.
Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is MIT-licensed and written mostly in Go.
Its closest alternative on selfhost.directory is Mediarium (60/100, 306 stars). It scores higher overall, so compare the two before you pick. See bindery vs Mediarium side by side.
Features
- Author aliases
- Author monitoring
- Download client diagnostics
- Download client integration
- Dual-format library
- Library adoption
- Library scan with fuzzy matching
- Metadata re-binding
- Multiple library roots
- Newznab and Torznab indexers
- Readarr database import
- Release calendar
- Series Support
- Smart search matching
- Unattended release discovery
bindery README
Ebooks and audiobooks, followed, fetched, checked and filed. One app, one binary.
Bindery follows the authors you read, searches your Usenet and torrent indexers, grabs the best release, checks it is the right book, and files it where your reading and listening apps expect it.
If you used Readarr, you know the loop: follow an author, let the app search, grab, import and rename. Readarr was retired in June 2025 because, in the maintainers' words, "the project's metadata has become unusable". Bindery is a fresh, MIT licensed implementation of that loop, built in Go, with both ebooks and audiobooks as first class citizens and with metadata from open sources you can switch between.
What it does well:
- Ebooks and audiobooks on the same book. One title holds an ebook and an audiobook in separate slots, each with its own search, quality profile, download folder and library root. Send ebooks to Calibre or Calibre-Web Automated and audiobooks to Audiobookshelf from one instance, instead of running two.
- Follows authors and keeps trying. Monitored authors are checked for new books on a schedule you choose, wanted books are searched automatically, failed downloads are retried, and a release the filters set aside can still be grabbed by hand with the reason shown.
- Checks what it imports. Before a file joins your library, Bindery reads it: an EPUB, Kindle file or audiobook whose embedded title, author or language says it is the wrong book is refused, its release is blocklisted, and the search runs again.
- Built to share. Give family and friends a requester account that can browse and ask for books but cannot download or change anything. Approve requests from a queue, auto approve trusted accounts, cap pending requests, and sign people in with OIDC or your reverse proxy.
- Brings your library with you. Import a Readarr database, a Goodreads CSV, a Calibre library or an Audiobookshelf server, then adopt files already on disk in place, with suggested matches and Undo.
- Open metadata you control. OpenLibrary, Hardcover, Google Books, the German, Norwegian and French national libraries, plus Audnex and Audible for audiobooks. Pick your primary, switch any enricher off, and lock fields you have corrected. No scraping.
- Boring to run, easy to verify. A single Go binary with the UI embedded and SQLite inside. Distroless image, Helm chart, binaries for Linux, macOS and Windows, and signed releases with build provenance you can check with
gh attestation verify.
services: bindery: image: ghcr.io/vavallee/bindery:latest container_name: bindery user: "1000:1000" # the uid:gid that owns your books and downloads ports: - 8787:8787 volumes: - ./config:/config - /media/books:/books - /media/downloads:/downloads environment: - BINDERY_LOG_LEVEL=info restart: unless-stopped
Open http://localhost:8787, create the admin account on the first run page, add an indexer and a download client in Settings, and add your first author.
The image is distroless and cannot switch users at runtime, so user: is how you set the UID that writes your library. BINDERY_PUID and BINDERY_PGID only assert that it came out right.
docker run -d \ --name bindery \ -p 8787:8787 \ -v /path/to/config:/config \ -v /path/to/books:/books \ -v /path/to/downloads:/downloads \ ghcr.io/vavallee/bindery:latest
The container image is built for amd64 and arm64. Release binaries cover Linux (amd64, arm64, armv7 and armv6, so a Raspberry Pi Zero works), macOS and Windows. Kubernetes users get a Helm chart in charts/bindery/, and Unraid has a Community Applications template. All of it, with UID and GID setup, path remapping and upgrade notes, is in docs/DEPLOYMENT.md. New to the *arr style of app? docs/QUICKSTART.md goes from zero to a first download.
bindery migrate readarr /path/to/readarr.db
Your authors, indexers, download clients and blocklist come across in one step. Authors are looked up again against Bindery's metadata providers, since Readarr's own backend is gone. Your files stay where they are: point a library scan at them and Bindery matches what it can and lists the rest on the Import page for you to adopt. Prefer the UI? Settings, Import. Full guide: Migrating from Readarr.
Book automation has become a busy and friendly space since Readarr's retirement, and Bindery is one of several good options. The tables describe each project by what its own README says it does, as of November 2026. If something here is out of date or unfair to a project, please open an issue and it will be fixed.
Managers that follow authors and fetch books for you
| Ebooks | Audiobooks | Requests from other users | Status | |
|---|---|---|---|---|
| Bindery | Yes | Yes, on the same book as the ebook | Yes, requester role with approvals | Active |
| Chaptarr | Yes | Yes, in the same instance, narrator aware, MP3 to M4B conversion | Not stated | Beta |
| LazyLibrarian | Yes, plus magazines and comics | Yes | User accounts | Active, long running |
| Bookshelf | Yes | Yes, one format per instance | No | Active Readarr revival |
| Readarr Redux | Yes | Yes, one format per instance | No | Active Readarr continuation |
| ReadMeABook | Secondary | Yes, its focus, with series watching | Yes | Active |
| Livrarr | Yes | Yes, plus a built in reader and player | Single user for now | Alpha |
| Readarr | Yes | Yes, one format per instance | No | Retired June 2025 |
If you want to keep running Readarr itself, Readarr Redux and Bookshelf are the closest continuations. If you need audio conversion today, Chaptarr does it in app. If you want both formats of a book handled together, household requests, and open metadata in a single small binary, that is what Bindery is built for.
Tools that pair well with Bindery
| What it does | How it works with Bindery | |
|---|---|---|
| Audiobookshelf | Audiobook server and player with mobile apps and progress sync | Bindery imports an existing Audiobookshelf library and asks it to rescan after every audiobook import |
| Calibre | Desktop ebook manager and converter | Each import is registered through calibredb or the Bindery Bridge plugin, even with Calibre on another machine |
| Calibre-Web Automated | Web library and reader with Kobo and KOReader sync | Bindery copies each ebook into its ingest folder |
| Grimmory | Web library for ebooks, comics and audiobooks | Bindery pushes imports to its BookDrop inbox (preview) |
| Kavita, Komga | Reading servers | Point them at Bindery's ebook folder |
| Shelfmark | On demand search and download across many sources | A different shape: Shelfmark for one off finds, Bindery for the authors you follow |
| AudioBookRequest | Request front end for audiobooks | Bindery's request API can file a request on a user's behalf |
| Storyteller | Read along books from an ebook and audiobook you own | Bindery can fetch both formats of the same title for it |
| KOReader, Moon+ Reader and other OPDS apps | Reading apps | Browse, search and download from Bindery's OPDS catalogue |
Being upfront saves everyone time. These are tracked, and the roadmap says what is next:
- Upgrading a book you already own to a better format when one appears (#2420). Today an imported book is not searched again.
- A monitored series finding its own new books (#2523). Monitored authors find new books; Fill gaps on a series is a manual action.
- Grouping editions and translations of one work under a single book (#1358).
- Audio conversion, M4B merging and chapter editing. Audiobookshelf's M4B encoder covers this well.
- A built in reader or player, or reading progress sync. Audiobookshelf, Calibre-Web Automated, Kavita and Komga do this, and Bindery feeds them.
- Shadow libraries, IRC, Soulseek and magazines are out of scope; see the roadmap's standing answers.
Following authors and finding books
- Author monitoring with per install and per author modes (all, future, latest, none, or only the series you pick), per book monitor toggles, and a wanted to imported workflow with live download progress.
- Unattended release discovery: monitored authors are checked for new books daily, weekly or monthly. It ships off; turn it on in Settings, General, New release discovery.
- Series pages with positions, gap detection against Hardcover, Fill gaps, and adding a whole Hardcover series in one step.
- Hardcover list sync on an interval, Goodreads CSV import, and a Discover page with recommendations from your library: next in series, new from monitored authors, genre similarity and your Hardcover wishlist.
- A release calendar of upcoming books.
Search and downloads
- Newznab and Torznab indexers queried in parallel and ranked by your format order, edition tags (RETAIL, UNABRIDGED, ABRIDGED), year, grabs, size and ISBN match. Prowlarr can sync its indexers into Bindery, with seed ratio and seed time per indexer.
- SABnzbd, NZBGet, qBittorrent, Transmission, Deluge and rTorrent or ruTorrent, with SSL and URL base support. Pin an indexer to a download client, and remove a torrent once it is imported and seeded.
- Diagnose on each download client checks the connection, the category, where grabs land, the path remap, read access, and whether imports can hardlink, then names the first thing to fix. No shell needed, which matters in a distroless image.
- Automatic search on an interval and on add, interactive search per book, and a global pause. Quality profiles per media type, language filter, custom formats, delay profiles, freeleech only indexers, a blocklist, and a per indexer daily query limit with polite back off when an indexer refuses.
- Failed downloads can be retried one at a time or all at once. Releases the filters set aside stay visible in interactive search with the reason, and you can still grab them.
- Multi book packs are recognised and not auto grabbed; manual import splits one across several books.
Importing and organising
- Completed downloads are placed in your library with your naming template. Import modes: Auto (hardlink when it can so torrents keep seeding, otherwise copy; Usenet is moved), Move, Copy, Hardlink, or External to hand off to another tool. Moves across filesystems are copied, verified and then removed. A second book that renders to a taken file name lands beside it as
Name (2).epubinstead of overwriting anything. - Content checks before import: the embedded title, author and language of EPUB, Kindle and audio files are compared with the book, and a wrong book is refused, blocklisted and searched again.
- Naming tokens including
{Author},{SortAuthor},{Title},{Year},{Series},{SeriesNumber},{Genre},{Lang},{Narrator}and{ASIN}, with conditional literals and zero padding. Reorganize renames an existing library to a new template. - Several ebook formats of one book are kept side by side, and EPUB is served first in downloads and OPDS.
- Library adoption: a scan matches files already on disk, and whatever it cannot match waits on the Import page with suggested matches, an Add author choice and Undo. Files are registered where they are and never moved. When a folder path names a series and position, such as
Discworld/08 - Guards! Guards!, you can put the book in that series as you adopt it. - Import from a folder for one off imports, with a folder browser over your library and download folders, and a metadata search to create a book when nothing in the catalogue fits.
- Manual metadata edits with field locks that survive refresh, Fix match for a file attached to the wrong book, Re-bind to a different provider record, author aliases, and a duplicate review.
- Optional Calibre style
metadata.opfwritten next to each book.
Sharing and running it
- Local accounts (argon2id), per account API keys, OIDC with any provider (setup guides for Google, GitHub through Dex, Authelia, Authentik and Keycloak), and forward auth from Authelia, Authentik or oauth2-proxy.
- Multi user: admins manage indexers, clients and users; each user gets their own monitored authors and downloads. Per user library isolation is turned on with
BINDERY_ENFORCE_TENANCY; see docs/multi-user.md. - Requests: a requester account browses read only and asks for books or authors. Admins approve from a queue and the added books belong to the person who asked. Accounts can auto approve with a daily quota, pending requests are capped (25 by default), and request front ends can file on a user's behalf.
- Webhook notifications for grabs, imports, failures, new books found, new requests and health changes, ready for Apprise, ntfy, Home Assistant, Discord or Slack.
- Backups on demand, restore from the UI, a database integrity check, and
bindery db-checkandbindery db-repairfor an instance that will not start. - History records where each import came from: the release, indexer, download client and the exact files placed.
- A log viewer with a runtime debug switch, log download for bug reports, and an *arr compatible queue at
/api/queuefor tools like Harpoon.
Interface
- React 19 and TypeScript, light and dark themes, a mobile friendly layout, and installable as an app on phones and desktops.
- Library search in the header with an Add to library dialog that takes a title, author, ISBN or ASIN.
- Sorting, filtering and pagination on every list, with preferences remembered.
- Translations: English and Norwegian (Bokmål) complete, Swedish mostly, and Korean, French, German, Dutch, Spanish, Indonesian and Filipino in progress. Translators welcome.
- An OPDS 1.2 catalogue with search at
/opds/for KOReader, Moon+ Reader and other reading apps, signed in with your Bindery account or API key.
More in Ebook Management
BookHavenBookHaven is a self-hosted, open-source EPUB reader that scans your local ebook library for reading and management in a responsive web UI with OPDS support.
BookHeaven.ServerSelf-hosted ebook library manager with modern responsive UI, OPDS support, KOReader sync, metadata handling, progress tracking, font management, and multiple profiles.
bookshelfSelf-hosted, open-source ebook and audiobook manager that monitors RSS feeds, grabs new releases, and organizes them using Goodreads or Hardcover metadata.
BookshelfSelf-hosted ebook library for EPUBs/PDFs with OPDS catalog for e-readers, browser readers, and multi-reader profiles. Runs on Cloudflare R2 or local filesystem.
Calibrecalibre is a free, open-source e-book manager for organizing, converting, and reading e-books. Supports all major formats with a built-in Content server for web access.
Calibre Web AutomatedSelf-hosted ebook library with automated ingest, conversion, metadata, and KOReader sync. Combines Calibre-Web UI with Calibre power.
ChaptarrSelf-hosted audiobook and eBook manager forked from Readarr with narrator-aware metadata, dual libraries, and *arr integrations.
ComiGoSelf-hosted, open-source comic/manga reader supporting CBZ, CBR, EPUB, PDF with web UI, PWA offline reading, progress sync, and Docker deployment.
dir2opdsA lightweight OPDS 1.2 ebook server you host yourself that turns a folder into a digital library. Serves EPUB, PDF, MOBI, AZW3, and FB2 to OPDS readers or a web browser.
eloranEloran is a self-hosted, open-source comics and ebook web library in Rust with folder-based library view, reading progress tracking, bookmarks, and multi-user support.
GrimoireA self-hosted web app for organizing and reading your tabletop RPG PDF collection with full-text search, maps, tokens, audio, and campaign management.
InkWeaverInkWeaver is a self-hosted manga download manager with desktop GUI and CLI. Organizes downloads with metadata, cover art, and export formats (CBZ, PDF).











0 comments