Bindery v0.1.0

The first release of Bindery — an automated book download manager for Usenet, built as a modern replacement for Readarr.

Features

• Author & Book Management — Add authors via OpenLibrary search, automatically fetch all their books
• Multi-Source Metadata — OpenLibrary (primary) + Google Books (enrichment), no Goodreads scraping
• Usenet Search — Query multiple Newznab indexers (NZBGeek, NZBFinder, NZBPlanet, etc.) simultaneously with relevance filtering
• SABnzbd Integration — Send NZBs with one click, track download progress with live queue overlay
• Import Pipeline — Filename parsing (title, author, ISBN), configurable naming templates, atomic cross-filesystem file moves
• Background Scheduler — Auto-search for wanted books (12h), check downloads (60s), refresh metadata (24h), scan library (6h)
• Book Downloads — Download imported books directly from the web UI
• Modern Web UI — React + TypeScript + Tailwind with dark theme, responsive grid layouts
  • Authors page with search, add, monitor toggle
  • Books page with cover art grid and status filters
  • Wanted page with one-click indexer search and grab
  • Queue page with live progress bars
  • Settings page for indexers and download clients
• Single Binary — Go backend with embedded React frontend, no sidecars needed
• Kubernetes Ready — Helm chart with Traefik IngressRoute, Longhorn PVC, NFS support, ArgoCD manifest
• Multi-Arch Docker — linux/amd64 and linux/arm64 via GitHub Actions CI
• Security — golangci-lint with gosec, govulncheck, Trivy container scanning, distroless runtime image

Quick Start

Docker

docker run -d --name bindery -p 8787:8787 \
  -v /path/to/config:/config \
  -v /path/to/books:/books \
  ghcr.io/vavallee/bindery:v0.1.0

Helm

helm install bindery charts/bindery --set image.tag=v0.1.0

Tech Stack