Works great and looks even better doing it.

Notifications and fully customizable quality profiles.

Multiple Author and Book views.

Frequent updates. See what's new without leaving the comfort of the app.

Summary

Readarr is a ebook collection manager for Usenet and BitTorrent users. It can monitor multiple RSS feeds for new books from your favorite authors and will interface with clients and indexers to grab, sort, and rename them.

Features

Calendar

See all your upcoming albums in one convenient location.

Manual Search

Find all the releases, choose the one you want and send it right to your download client.

Calibre Integration

Automatically integrates with Calibre library.

Import Lists

Import lists from other supported services like Goodreads and LazyLibrarian.

Download

Introduction

Readarr is supported natively on Windows. Readarr can be installed on Windows as Windows Service or system tray application.

A Windows Service runs even when the user is not logged in, but special case must be taken since Windows Services cannot access network drives (\\server\share or X:\ mapped drives) without special configuration steps.
It's therefore advisable to install Readarr as a system tray application if the user does not need to log out, the option to do so is provided during the installer.

Readarr v0.8 no longer supports Windows XP. At this time Windows 7 should still work, but we will not maintain Windows 7 support. Note that KB2533623 and Microsoft Visual C++ 2015 Redistributable Update 3 are needed to run .net core apps on Windows 7
1 Install Readarr

Download the Windows Installer with the following link and execute it.

Download Windows x64 Installer Download Windows x86 Installer
2 View Readarr

Browse to http://localhost:8787 to start using Readarr.

Manual Install

It is possible to install Readarr manually using the x64 .zip download. However in that case you must manually deal with dependencies, installation and permissions.

Introduction

The Arch Linux User Repository offers a readarr package that can be installed manually or using your favorite AUR helper.

1 Install Readarr

An aur helper can install readarr and its dependencies easily, or follow the AUR Installing Packages wiki for manual installation.

For example, to use yay to install the readarr package:

yay -S readarr

2 Start Readarr
sudo systemctl daemon-reload
sudo systemctl enable --now readarr
3 View Readarr

Browse to http://localhost:8787 to start using Readarr.

(Replace 'localhost' with your server IP if you're connecting remotely)
Manual Install

It is possible to install Readarr manually from upstream using the .tar.gz download. However in that case you must manually deal with dependencies, installation and permissions.

Docker container

You can follow the Docker guide to install Readarr as a Docker container instead.

Installation

The community has put together an Installation Guide to help you install this on Debian or Ubuntu.

Please contact us if you wish to port Readarr v3 for any other distribution that the ones already listed.
Readarr v0.2 was supported by various third-parties on other platforms and we prefer to coordinate the port of v3.

Generic .tar.gz downloads are available for linux, but dependencies, installation and permissions will need to be done manually.

Introduction

The easiest way to install Readarr on macOS is to use the App archive with the steps described below.

1 Download App package
Download macOS App
2 Install App

Open the archive and drag the Readarr icon to your Application folder.

Readarr is not compatible with OSX versions < 10.13 due to netcore compatability.
3 Start Readarr

Open Readarr.app in your Application folder.

During startup it may ask you to install the Mono Runtime if an appropriate version is not already installed.
4 View Readarr

Browse to http://localhost:8787 to start using Readarr.

Manual Install

It is possible to install Readarr manually using the .tar.gz download. However in that case you must manually deal with dependencies, installation and permissions.

Docker container

You can follow the Docker guide to install Readarr as a Docker container instead.

A package and installation instructions are provided by SynoCommunity at: https://synocommunity.com/package/Readarr. Please note that the SynoCommunity typically has signifcant lag in providing updated packages, thus you may want to check out Docker.
The Readarr v0.7 Qnap port was maintained by the Qnap forum community.
Please contact us if you wish to maintain a v0.8 package so that we can include the appropriate install instructions.
Please contact us if you wish to port Readarr for any other nas that the ones already listed.

A generic download is available for linux, but dependencies, installation, and permissions will need to be done manually.

Download Linux .tar.gz
Introduction

The Readarr team does not offer an official Docker image. However, a number of third parties have created and maintain their own.
These instructions provide generic guidance that should apply to any Readarr Docker image.

1 Avoid common pitfalls
Volumes and Paths

There are two common problems with Docker volumes: Paths that differ between the Readarr and download client container and paths that prevent fast moves and hard links.
The first is a problem because the download client will report a download's path as /torrents/My.Book/, but in the Readarr container that might be at /downloads/My.Book/. The second is a performance issue and causes problems for seeding torrents. Both problems can be solved with well planned, consistent paths.

Most Docker images suggest paths like /books and /downloads. This causes slow moves and doesn't allow hard links because they are considered two different file systems inside the container. Some also recommend paths for the download client container that are different from the Readarr container, like /torrents.
The best solution is to use a single, common volume inside the containers, such as /data. Your books would be in /data/Books, torrents in /data/downloads/torrents and/or usenet downloads in /data/downloads/usenet.

If this advice is not followed, you may have to configure a Remote Path Mapping in the Readarr web UI (Settings › Download Clients).

Ownership and Permissions

Permissions and ownership of files is one of the most common problems for Readarr users, both inside and outside Docker. Most images have environment variables that can be used to override the default user, group and umask, you should decide this before setting up all of your containers. The recommendation is to use a common group for all related containers so that each container can use the shared group permissions to read and write files on the mounted volumes.
Keep in mind that Readarr will need read and write to the download folders as well as the final folders.

For a more detailed explanation of these issues, see The Best Docker Setup and Docker Guide wiki article.

2 Install Readarr

To install and use these Docker images, you'll need to keep the above in mind while following their documentation. There are many ways to manage Docker images and containers too, so installation and maintenance of them will depend on the route you choose.

  • ghcr.io/hotio/readarr:release

    hotio doesn't specify any default volumes, besides /config. Images are automatically updated multiple times in an hour if upstream changes are found. Hotio also builds our Pull Requests which may be useful for testing. Read the instructions on how to install the image.

  • ghcr.io/linuxserver/readarr:latest

    linuxserver.io is one of the most prolific and popular Docker image maintainers. They also maintain images for most of the popular download clients as well. LinuxServer specifies a couple of optional default volumes such as /books and /downloads. The default volumes are not optimal nor recommended. Our recommendation is to use a single volume for the data, as mentioned above.

Installation

The Readarr team provides builds for BSD.
Additional details can be found on Frank's GH Link

Please contact us if you wish to port Readarr for any other platform that the ones already listed.

Support