selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

GitHub
bindery logo

Self-host bindery

v1.48.0

Automated ebook and audiobook manager for Usenet

ReleaseOpen SourceMIT
Updated22 hours ago
LanguageGo
Setup difficultyModerate
MobileResponsive
ThemeDark mode
Stars
556
Port
8787 (HTTP server port)
Docker
ghcr.io/vavallee/bindery
Install with Docker
Tour through authors, books, release calendar, and download queueAuthor detail page with monitored books (dark theme)Books library grid view (dark theme)Release calendar of upcoming books (dark theme)Download queue with live status (dark theme)Books view on mobile (dark theme)Authors view on mobile (dark theme)Author detail on mobile (dark theme)

What 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

Bindery

Bindery

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.

CI codecov Release Downloads GitHub Container Registry Docker Hub pulls OpenSSF Scorecard License Discord


Bindery: a tour through authors, books, the release calendar and the download queue

Why Bindery

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.

Bindery: author detail page with monitored books

Quick start

Docker Compose
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
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
Other install methods

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.

Coming from Readarr
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.

How Bindery fits

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
What Bindery does not do yet

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.

Features

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).epub instead 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.opf written 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-check and bindery db-repair for 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/queue for 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.

Books on mobile   

How to install bindery

Install bindery with Docker

Docker Engine
Environment variables
BINDERY_PORT, BINDERY_DB_PATH, BINDERY_DATA_DIR, BINDERY_LIBRARY_DIR, BINDERY_AUDIOBOOK_DIR, BINDERY_DOWNLOAD_DIR, BINDERY_AUDIOBOOK_DOWNLOAD_DIR, BINDERY_URL_BASE, BINDERY_OUTBOUND_PROXY, BINDERY_DOWNLOAD_RETENTION_DAYS, BINDERY_LOG_LEVEL, BINDERY_PUID, BINDERY_PGID, and many more

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

Distroless image, multi-arch (amd64, arm64)

How to configure bindery

  • BINDERY_PORT8787HTTP server port
  • BINDERY_DB_PATHplatform-defaultSQLite database path
  • BINDERY_DATA_DIRplatform-defaultConfig directory (backups, image cache, secrets)
  • BINDERY_LIBRARY_DIR/booksImported ebook destination
  • BINDERY_AUDIOBOOK_DIRinherits libraryImported audiobook destination

bindery releases & version history

@ Every self-hosted release, weekly

One Monday email with the week's stable releases across the directory.

More in Ebook Management

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…