This is a community revival fork of Readarr. The original project was retired due to metadata source issues. This fork addresses those issues and brings Readarr back to production-ready status.
- Replaced broken BookInfo with Open Library integration
- Resilient metadata fetching with retry logic and circuit breakers
- Aggressive caching (30-90 day TTLs) to minimize API dependencies
- Graceful degradation when metadata services are unavailable
- Upgraded to .NET 8 LTS (supported through November 2026)
- Updated all dependencies for security and compatibility
- Improved performance and security posture
- Production-ready Dockerfile with multi-stage builds
- Docker Compose for easy deployment
- Health checks and proper signal handling
- Both SQLite and PostgreSQL support
- Automated housekeeping (33 maintenance tasks)
- Comprehensive health monitoring
- Backup and restore procedures
- Detailed operational documentation
- GitHub Actions for automated builds and tests
- Dependabot for dependency updates
- Security scanning (CodeQL, Trivy, TruffleHog)
- Vulnerability disclosure policy
git clone https://github.com/maddefientist/Readarr.git
cd Readarr
cp .env.example .env
# Edit .env with your settings
docker compose up -dAccess at: http://localhost:8787
- Development Guide - Building and contributing
- Deployment Guide - Docker and production deployment
- Operations Guide - Monitoring, backup, troubleshooting
| Component | Status |
|---|---|
| .NET 8 Upgrade | ✅ Complete |
| Open Library Integration | ✅ Complete |
| Docker Deployment | ✅ Complete |
| CI/CD Pipeline | ✅ Complete |
| Documentation | ✅ Complete |
Note from original Servarr team: The Readarr project was officially retired in June 2025 due to metadata source issues. This community fork addresses those issues.
Readarr is currently in beta testing and is generally still in a work in progress. Features may be broken, incomplete, or cause spontaneous combustion
Readarr is an ebook and audiobook collection manager for Usenet and BitTorrent users. It can monitor multiple RSS feeds for new books from your favorite authors and will grab, sort, and rename them. Note that only one type of a given book is supported. If you want both an audiobook and ebook of a given book you will need multiple instances.
- Can watch for better quality of the ebooks and audiobooks you have and do an automatic upgrade. e.g. from PDF to AZW3
- Support for major platforms: Windows, Linux, macOS, Raspberry Pi, etc.
- Automatically detects new books
- Can scan your existing library and download any missing books
- Automatic failed download handling will try another release if one fails
- Manual search so you can pick any release or to see why a release was not downloaded automatically
- Advanced customization for profiles, such that Readarr will always download the copy you want
- Fully configurable book renaming
- SABnzbd, NZBGet, QBittorrent, Deluge, rTorrent, Transmission, uTorrent, and other download clients are supported and integrated
- Full integration with Calibre (add to library, conversion) (Requires Calibre Content Server)
- And a beautiful UI
Note: GitHub Issues are for Bugs and Feature Requests Only
This project exists thanks to all the people who contribute.
Thank you to all our backers! 🙏 Become a backer
Support this project by becoming a sponsor. Your logo will show up here with a link to your website. Become a sponsor
This project is also supported by DigitalOcean
- GNU GPL v3
- Copyright 2010-2022