What is Readarr? Readarr is a free, open-source digital literature collection manager built for data hoarders. It automatically monitors RSS feeds to discover new releases from specified authors, retrieves the files from Usenet or P2P networks, and organizes the archival data into a clean, structured library.
If you have already set up Sonarr and Radarr, you know how incredibly powerful the “Arr” automation stack is.
You simply request a digital asset, and the software automatically searches the internet, retrieves the file, renames it, and sends it to your media server. But what if you are a data hoarder who collects more than just video files? What if you want to build a massive, high-quality archive of digital publications and public domain texts?
You do not have to retrieve those manually. The exact same automation magic exists for literature. In this guide, we will explain what Readarr is, how it organizes metadata, and how to install it on your home NAS.
Table of Contents
What Readarr Does
Readarr functions as an automated digital literature collection manager. It acts as an API synchronization hub for your personal book archive.
You define which authors or titles you want to archive, set quality profiles for preferred formats (like EPUB, MOBI, or PDF), and Readarr handles the rest automatically. It continuously monitors RSS feeds from connected indexers and acts when a matching release appears. Files land in a staging folder, get verified against your quality rules, and then move into your organized library directory.
How It Tracks Authors, Releases, and Library Gaps
When you add an author to Readarr, the software compares their known bibliography against what you already have. Any missing titles appear as monitored gaps that Readarr actively searches for during RSS cycles or manual searches.
This gap-filling feature is particularly useful for building out collections of public domain authors or archiving complete bibliographies. It does not require you to manually hunt for each title individually.
Why Users Pair It With Public Domain Workflows
Home lab users and data hoarders often use Readarr alongside public domain indexers to automate the acquisition of legally free literature, out-of-copyright works, and openly licensed texts.
Pairing Readarr with a structured folder system creates a self-contained digital preservation pipeline. The library stays organized without constant manual input, which fits well into low-maintenance archival setups.
How Readarr Works With Indexers and Download Clients
Readarr does not download anything directly. It acts as a coordinator between indexers that surface available releases and download clients that retrieve them.
The Role of Indexers and RSS Monitoring
Indexers are the sources Readarr queries to find available releases. They publish RSS feeds that Readarr reads on a schedule, looking for titles or authors you have flagged as monitored.
Readarr also supports integration with indexer managers like Prowlarr and Jackett, which act as a single interface for managing multiple indexers. This reduces the configuration overhead when you are working with several sources simultaneously.
Usenet Setup With SABnzbd and NZBGet
For Usenet-based workflows, Readarr supports SABnzbd and NZBGet as download clients. You connect them through their respective API keys inside Readarr’s settings panel.
Readarr sends NZB files to the client, monitors the assigned download category, and imports the result when the download completes. This pairs cleanly with encrypted Usenet access and a no-logs VPN for a more private archival setup.
Install Readarr on a Home Server
Installing Readarr on a home server involves a few consistent steps regardless of method: setting correct file permissions and pointing the application at your library directories.
Docker Deployment With linuxserver/readarr
Because Readarr is a self-hosted web application, it is designed to be installed via Docker.
The linuxserver/readarr Docker image is the most common containerized deployment path. A basic Docker Compose entry maps your config volume, library path, and download directory into the container. Port 8787 is the default, and the container restarts automatically on reboot when configured correctly.
If you are running a custom DIY server (see our Unraid vs TrueNAS guide), you can easily install the Readarr Docker container using the built-in app store.
Key Features for Organizing Book Libraries
Readarr’s library management tools center on automation: it monitors for gaps, renames files into structured folders, and integrates with third-party software to handle metadata and format conversion.
Automatic Monitoring and Search Profiles
Readarr lets you create quality profiles that define which file formats you want, in order of preference. For digital literature, that might mean preferring EPUB over PDF. For audio files, you might prioritize FLAC or M4B.
When a release matches your format and quality rules, Readarr downloads it automatically. If a better version appears later, it can upgrade the existing file without manual input.
Book Renaming and Folder Structure Control
One of Readarr’s most practical features for data hoarders is its renaming system. You define a naming template using tokens for author name, title, year, and format, and Readarr applies that structure to every file it imports.
This produces a clean, consistent folder hierarchy that stays organized as your library grows. It also makes the library easier to ingest into other tools and media servers like Audiobookshelf.
Calibre Integration and Metadata Handling
Readarr includes full integration with Calibre, the open-source management tool. When connected, Readarr can send imported files directly to a Calibre library and trigger format conversions automatically.
Calibre also handles metadata enrichment, cover images, and format normalization. This combination makes Readarr and Calibre a functional two-part pipeline for building a well-tagged, multi-format digital archive.
Project Status, Risks, and What Changed
Readarr relied on a third-party metadata source to identify authors and editions. Over time, that metadata layer became unreliable and difficult to maintain.
Readarr Retirement and the Servarr Team Announcement
The Servarr team announced that repairing or replacing the metadata infrastructure was not feasible given available resources. A community effort to migrate to Open Library as an alternative metadata source stalled. This ultimately led to the project’s retirement.
What Retirement Means for New Users
Retirement means no new features, no bug fixes, and no security patches from the original team. Existing installations may continue to function for some time, but they will accumulate unresolved issues over time.
For new users building a home lab archive, starting fresh with a retired tool introduces risk. However, community forks (like pennydreadful/bookshelf) have emerged as active continuation efforts.
Frequently Asked Questions
What types of files can Readarr manage and track?
Readarr supports digital literature in formats like EPUB, MOBI, and PDF, as well as audio files in formats such as MP3, FLAC, and M4B. It tracks by author or individual title, monitoring indexers for new releases that match your configured quality profiles.
How does it integrate with download clients and indexers?
Readarr connects to download clients and Usenet indexers through their respective APIs. It sends matched releases to clients like SABnzbd or NZBGet, then monitors the assigned download category and imports the completed files into your library automatically.
Which metadata sources does it use, and how accurate are they?
Readarr used a third-party metadata source to identify authors and editions. That metadata layer became unreliable over time, and a planned transition to Open Library did not complete, which was a primary factor in the project’s retirement.
How do you connect it to a library manager like Calibre?
Inside Readarr’s settings panel, there is a dedicated Calibre integration section where you point it at your running Calibre instance. Once connected, Readarr sends imported files directly to the Calibre library and can trigger format conversions based on your preferences.