- Readarr relies on RSS feeds to automate grabbing of releases as they are posted, for both new releases as well as previously released releases being released or re-released. The RSS feed is the latest releases from a site, typically between 50 and 100 releases, though some sites provide more and some less. The RSS feed is comprised of all releases recently available, including releases for requested media you do not follow, if you look at debug logs you will see these releases being processed, which is completely normal.
- Readarr enforces a minimum of 10 minutes on the RSS Sync interval and a maximum of 2 hours. 15 minutes is the minimum recommended by most indexers, though some do allow lower intervals and 2 hours ensures Readarr is checking frequently enough to not miss a release (even though it can page through the RSS feed on many indexers to help with that). Some indexers allow clients to perform an RSS sync more frequently than 10 minutes, in those scenarios we recommend using Readarr's Release-Push API endpoint along with an IRC announce channel to push releases to Readarr for processing which can happen in near real time and with less overhead on the indexer and Readarr as Readarr doesn’t need to request the RSS feed too frequently and process the same releases over and over.
- Readarr does ''not'' regularly search for book files that are missing or have not met their quality goals. Instead, it fairly frequently queries your indexers and trackers for ''all'' the newly posted books, then compares that with its list of books that are missing or need to be upgraded. Any matches are downloaded. This lets Readarr cover a library of ''any size'' with just 24-100 queries per day (RSS interval of 15-60 minutes). If you understand this, you will realize that it only covers the ''future'' though.
- So how do you deal with the present and past? When you're adding a book, you will need to set the correct path, profile and monitoring status then use the Start search for missing book checkbox. If the book hasn't been released yet, you do not need to initiate a search.
- Put another way, Readarr will only find books that are newly uploaded to your indexers. It will not actively try to find books you want that were uploaded in the past.
- If you've already added the book, but now you want to search for it, you have a few choices. You can go to the book's page and use the search button, which will do a search and then automatically pick one. You can use the Search tab and see ''all'' the results, hand picking the one you want. Or you can use the filters of
- If Readarr has been offline for an extended period of time, Readarr will attempt to page back to find the last release it processed in an attempt to avoid missing a release. As long as your indexer supports paging and it hasn't been too long Readarr will be able to process the releases it would have missed and avoid you needing to perform a search for the missed books.
- Preferred Word Score
- Indexer Priority
- Seeds/Peers (If Torrent)
- Book Count
- Age (If Usenet)
¶ What are Lists and what can they do for me?
- Lists are a part of Readarr that allow you to follow a given list creator.
- Let's say that you follow a given list creator on Trakt/TMDb and really like their Marvel Cinematic Universe film section and want to watch every book on their list. You look in your Readarr and realize that you do not have those books. Well instead of searching one by one and adding those lists and then searching your indexers for those books. You can do this all at once with a List. The Lists can be set to import all the books on that curators list as well as be set to automatically assign a quality profile, automatically add, and automatically monitor that book.
CAUTION: If lists are done improperly they will absolutely wreck your library with a bunch of trash you have no intention of watching. So make sure of what you're importing before you click save.
- ie. physically look at the list before you even go to Readarr.
- Readarr uses GoodReads for book and author information and images like cover and author art, banners and backgrounds. Generally, there are a few reasons why you may not be able to add a book:
- GoodReads doesn't like special characters to be used when searching for books through the API (which Readarr uses), so try searching a translated name, and/or without special characters.
- You can also add books and authors by GoodReads ID, ISBN ID, or ASIN ID.
- The book has an issue with GoodReads API data. Unfortunately this is something we probably cannot solve for you.
- The book falls below the settings you've chosen (votes, pages, etc.) to appear in Readarr.
- Readarr has a hardcoded minimum percent match threshold when comparing the to-be-imported file against the book and author. Matches below this threshold will need to be manually imported.
- This is not user configurable.
- Currently this is 80% 1-_bookThreshold
- The development team is considering lowering this to somewhere in the 70%s. If you have false negative matches between 70% and 80% please share them with us on discord.
- Mass Editor
- Select what authors need their folder renamed
- Change Root Folder to the same Root Folder that the authors currently exist in
- Select "Yes move files"
- Use Mass Editor => Select authors you want to delete => Delete
- Readarr uses .NET Core and a new webserver. In order for SignalR to work, the UI buttons to work, database changes to take, and other items. It requires the following addition to the location block for Readarr:
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection $http_connection;
- Make sure you
do not include
proxy_set_header Connection "Upgrade"; as suggested by the nginx documentation.
THIS WILL NOT WORK
- See this ASP.NET Core issue
- If you are using a CDN like Cloudflare ensure websockets are enabled to allow websocket connections.
- Go to Settings and then the General tab and show advanced settings (use the toggle by the save button).
- Under the Updates section change the branch name to
This will not install the bits from that branch immediately, it will happen during the next update.
master - - (Default/Stable): It has been tested by users on the develop and nightly branches and it’s not known to have any major issues. On GitHub, this is the
master branch. Readarr does not yet have a stable release.
develop - - (Beta): This is the testing edge. Released after tested in nightly to ensure no immediate issues. New features and bug fixes released here first. Readarr does not yet have a beta release.
Warning: You may not be able to go back to
master after switching to this branch. On GitHub, this is a snapshot of the
develop branch at a specific point in time.
nightly - - (Alpha/Unstable): The bleeding edge. Released as soon as code is committed and passed all automated tests. Use this branch only if you know what you are doing and are willing to get your hands dirty to recover a failed update. This version is updated immediately.
Warning: You may not be able to go back to
develop after switching to this branch. On GitHub, this is the
- Note: If your install is through Docker append
:nightly to the end of your container tag depending on who makes your builds.
||no stable release yet
||no beta release yet
- Technically, yes. But you absolutely should not. It is a primary philosophy of Docker. Database issues can arise if you upgrade your installation inside to the most recent
nightly, but then update the Docker container itself (possibly downgrading to an older version).
- Go to System and then the Updates tab
- Newer versions that are not yet installed will have an update button next to them, clicking that button will install the update.
- Repull your tag and update your container
You can (almost) always increase your risk.
master can go to
develop can go to
- Check with the development team to see if you can switch from
master for your given build.
- Failure to follow these instructions may result in your Readarr becoming unusable or throwing errors. You have been warned.
- The most common error is something like
Error parsing column 45 (Language=31 - Int64) or other similar database errors around missing columns or tables.
This means your SQLite database that stores most of the information for Readarr is corrupt.
Try the sqlite3
If your sqlite does not have
.recover or you wish a more GUI friendly way then follow our instructions on this wiki.
Try restoring from a backup
This error may show if the database file is not writable by the user/group Readarr is running as.
Another possible cause of you getting an error with your Database is that you're placing your database on a network drive (nfs or smb or something else not local). Simple answer to this is to not do this as SQLite and network drives not typically play nice together and will cause a malformed database eventually. The config folder must be on a local drive**. If you're trying to restore your database you can check out our Backup/Restore guide here.
If you are using mergerFS you need to remove
direct_io as SQLite uses mmap which isn’t supported by
direct_io as explained in the mergerFS docs here
¶ How does Readarr handle foreign books or foreign titles?
Readarr uses both Alt Titles and Translations for parsing and searching. Search will use the Original Title, English Title, and Translated Title from whatever languages you have preferred (in profile and CFs). Parsing should look for a match in all Translations and Alt Titles.
To get a book in a foreign language set your Profile Language to Original (Book's Original Language), a specific language for that profile, or any and use custom formats to determine which language to grab.
Note that this does not include any indexer languages specified as multi.
- Neither Readarr actively search for missing books automatically. Instead, a periodic query of new posts is made to all indexers configured for RSS. When a wanted or cutoff unmet book shows up in that list, it gets downloaded. This means that until a book is posted (or reposted), it won’t get downloaded.
- If you’re adding an author with books that you want now, the best option is to check the “Start search for missing books” box, to the left of the Add Author button. You can also go to the page for an author you’ve added and click the magnifying glass Search button next to the book you want, or use the Wanted view to search for Missing or Cutoff Unmet books.
Sometimes you can get a problem that authors that are imported from your lists, gets imported with the root path set to “C:” or other weird paths.
This is a known issue for when the root path is either not setup during the creation of the list, or if the root path has been deleted after the list was created. Note that this problem can still occur even if the list is
edited and the correct root path is set.
Use the Mass Editor to fix paths of existing authors.
¶ Book Imported, But Source File And Torrent Not Deleted
Check if you have Completed Download Handling - Remove turned on. (This does not work if you are using rtorrent.)
If you are using deluge make sure auto-managed is turned on. And that torrents get paused when they reach specified seeding quota.
¶ I am using a Pi and Raspbian and Readarr will not launch
Raspbian has a version of libseccomp2 that is too old to support running a docker container based on Ubuntu 20.04, which both hotio and LinuxServer use as their base. You either need to use
--privileged, update libseccomp2 from Ubuntu or get a better OS (We recommend Ubuntu 20.04 arm64)
Managed to fix the issue by installing the backport from debian repo. Generally not recommended to use backport in blanket upgrade mode. Installation of a single package may be ok but may also cause issues. So got to understand what you are doing.
Steps to fix:
First ensure you are running Raspbian buster e.g using
Distributor ID: Raspbian
Description: Raspbian GNU/Linux 10 (buster)
¶ Why are lists sync times so long and can I change it?
Lists never were nor are intended to be
add it now they are
hey I want this, add it eventually tools.
You can trigger a list refresh manually, script it and trigger it via the API, or add the books directly to Readarr.
This change was due to not have our server get killed by people updating lists every 10 minutes.
No, nor should you through any SQL hackery. The refresh books task queries the upstream Servarr proxy and checks to see if the metadata for each book (ids, cast, summary, rating, translations, alt titles, etc.) has updated compared to what is currently in Readarr. If necessary, it will then update the applicable books.
A common complaint is the Refresh task causes heavy I/O usage. One setting that can cause issues is "Rescan Author Folder after Refresh". If your disk I/O usage spikes during a Refresh then you may want to change the Rescan setting to
Manual. Do not change this to
Never unless all changes to your library (new books, upgrades, deletions etc) are done through Readarr. If you delete book files manually or a third party program, do not set this to
¶ Can I have BOTH an ebook and an audiobook version of the same book?
- No. With a single Readarr instance, you can have either one or the other, but not both. If you want both, you would need to run two separate instances of Readarr (much like some people run 2 instances of Sonarr or Radarr for 1080p and 4K versions of their media).
- No. In general Calibre offers some further enhancement, such as the ability to auto-convert ebooks to another format specific to your e-reader's capabilities, and also to connect to that e-reader. But if you weren't running Calibre prior to installing Readarr, then it's probably going to be of limited added benefit to you to install it, and it's a very large program.
- In short: the user is running as (if service) or under (if tray app) cannot access the file path on the remote server. This can be for various reasons, but the most common is, is running as a service, which causes one of two things:
- Run Readarr service as another user that has access to that share
- Open the Administrative Tools > Services window on your Windows server.
- Stop the Readarr service.
- Open the Properties > Log On dialog.
- Change the service user account to the target user account.
- Run Readarr.exe using the Startup Folder
- Change your paths to UNC paths (
- Run Readarr.exe via the Startup Folder
To disable authentication (to reset your username or password) you will need need to edit
config.xml which will be inside the Readarr Appdata Directory
- Open config.xml in a text editor
- Find the authentication method line will be
- Change the
AuthenticationMethod line to
- Restart Readarr
- Readarr will now be accessible without a password, you should go the
Settings: General in the UI and set your username and password
Depending on your OS, there are multiple possible ways.
General on some OS'es, there is a checkbox to launch the browser on startup.
- When invoking Readarr, you can add
-nobrowser (*nix) or
/nobrowser (Windows) to the arguments.
- Stop Readarr and edit the config.xml file, and change
- If you experience any weird UI issues like the Library page not listing anything or a certain view or sort not working, try viewing in a Chrome Incognito Window or Firefox Private Window. If it works fine there, clear your browser cache and cookies for your specific ip/domain. For more information, see the Clear Cache Cookies and Local Storage wiki article.
¶ VPNs, Jackett, and the *ARRs
Unless you're in a repressive country like China, Australia or South Africa, your torrent client is typically the only thing that needs to be behind a VPN. Because the VPN endpoint is shared by many users, you can and will experience rate limiting, DDOS protection, and ip bans from various services each software uses.
In other words, putting the *Arrs (Lidarr, Radarr, Readarr, and Sonarr) behind a VPN can and will make the applications unusable in some cases due to the services not being accessible. To be clear it is not a matter if VPNs will cause issues with the *Arrs, but when: image providers will block you and cloudflare is in front of most of arr servers (updates, metadata, etc.) and liable to block you too
In addition, some private trackers ban for browsing from a VPN, which is how Jackett works. In some cases (i.e. certain UK ISPs) it may be needed to use a VPN for public trackers, in which case you should then be putting only Jackett behind the VPN. However, you should not do that if you have private trackers without checking their rules first. Many private trackers will ban you for using or accessing them (i.e. using Jackett) via a VPN.
/all endpoint is convenient, but that is its only benefit. Everything else is potential problems, so adding each tracker individually is recommended.
May 2021 Update: It is likely *Arr support will be phased out for the jackett
/all endpoint in the future due to the fact it only causes issues.
Even Jackett says it should be avoided and should not be used.
/all endpoint has no advantages (besides reduced management overhead), only disadvantages:
- you lose control over indexer specific settings (categories, search modes, etc.)
- mixing search modes (IMDB, query, etc.) might cause low-quality results
- indexer specific categories (>= 100000) cannot be used.
- slow indexers will slow down the overall result
- total results are limited to 1000
Note that using NZBHydra2 as a single aggregate entry has the same issues as Jackett's
Add each indexer seperatedly. This allows for fine tuning of categories on a per indexer basis, which can be a problem with the
/all end point if using the wrong category causes errors on some trackers. In *Arr, each indexer is limited to 1000 results if pagination is supported or 100 if not, which means as you add more and more trackers to Jackett, you're more and more likely to clip results. Finally, if one of the trackers in
/all returns an error, *Arr will disable it and now you do not get any results.
This is expected. Below is how the Torrent Process works.
- Readarr will send a download request to your client, and associate it with a label or category name that you have configured in the download client settings. Examples: movies, tv, series, music, etc.
- Readarr will monitor your download clients active downloads that use that category name. This monitoring occurs via your download client's API.
- Completed files are left in their original location to allow you to seed the file (ratio or time can be adjusted in the download client or from within under the specific download client). When files are imported to your media folder will hardlink the file if supported by your setup or copy if not hardlinks are not supported.
- If the "Completed Download Handling - Remove Completed" option is enabled in Readarr's settings, Readarr will delete the original file and torrent from your download client, but only if the download client reports that seeding is complete and torrent is stopped.
Hardlinks are enabled by default. A hardlink will allow not use any additional disk space. The file system and mounts must be the same for your completed download directory and your media library. If the hardlink creation fails or your setup does not support hardlinks then will fall back and copy the file.