Sonarr Settings

From Servarr

Sonarr Settings

Please note that this information is only for Sonarr V3.


Media Management

Note: Some of these settings are only visible through 'show advanced' settings which is on the top bar under the search bar


Naming

  • Rename Episodes - If this is toggled off (no check in the box) Sonarr will use the existing file name if renaming is disabled
  • Replace Illegal Characters - If this is toggled off (no check in the box) Sonarr will replace illegal characters.
Example: \ # / $ * < > just to name a few
Standard Episode Format

Here you will select the naming convention for your episodes

  • Dropdown Box (upper right corner)
    • Left Box - Space Handling
      • Space ( ) - Use spaces in naming (Default)
      • Period (.) - Use periods in lieu of spaces in naming
      • Underscore (_) - Use underscores in lieu of spaces in naming
      • Dash (-) - Use dashes in lieu of spaces in naming
    • Right Box - Case Handling
      • Default Case - Make title upper and lower Case (~camelcase) (Default)
      • Upper Case - Make title all upper case
      • Lower Case - Make title all lower case
Series Naming
Input Result
{Series Title} Series Name!
{Series CleanTitleYear} Series Title 2020
{Series TitleFirstCharacter} S
{Series CleanTitle} Series Title
{Series TitleThe} Series Title, The
{Series TitleYear} Series Title (2020)
Series IDs
Input Result
{ImdbId} tt12345
{Tmdbid} 123456
{TvMazeId} 54321
Seasons
Input Result
{season:0} 1
{season:00} 01
Episode
Input Result
{episode:0} 1
{episode:00} 01
Air Date
Input Result
{Air-Date} 2020-09-03
{Air Date} 2020 09 03
Episode Title
Input Result
{Episode Title} Episode Title
{Episode CleanTitle} Episode Title
Quality
Input Result
{Quality Full} HDTV 720p Proper
{Quality Title} HDTV 720p
Media Info
Input Result
{MediaInfo Simple} x264 DTS
{MediaInfo VideoCodec} x264
{MediaInfo AudioChannels} 5.1
{MediaInfo SubtitleLanguages} [EN]
{MediaInfo VideoBitDepth} 8
{MediaInfo Full} x264 DTS [EN+DE] *
{MediaInfo AudioCodec} DTS
{MediaInfo AudioLanguages} [EN+DE]
{MediaInfo VideoCodec} x264
{MediaInfo VideoDynamicRange} HDR

* MediaInfo Full/AudioLanguages/SubtitleLanguages support a :EN+DE suffix allowing you to filter the languages included in the filename. Use -DE to exclude specific languages. Appending + (eg :EN+) will output [EN]/[EN+--]/[--] depending on excluded languages. For example {MediaInfo Full:EN+DE}.

Other
Input Result
{Release Group} Rls Grp
{Preferred Words} iNTERNAL
Original
Input Result
{Original Title} Series.Title.S01E01.HDTV.x264.EVOLVE
{Original Filename} Series.title.s01e01hdtv.x264.EVOLVE
Daily Episode Format

Here you will select the naming convention for episodes that air daily

See Standard Episode Format

Anime Episode Format

Here you will select the naming convention for Anime series
Note: Typically anime is aired in an absolute order or also known as production order. Usually this is shown as e001, e002...e104, e105 ect. When a series is set to use Anime this setting will pull the absolute order from TheTVDB which is usually one season. an example of this can be seen HERE

All other settings are as above in the Standard Episode Format section

Absolute Episode Number
Input Result
{absolute:0} 1
{absolute:00} 01
{absolute:000} 001


Anime naming scheme

Renaming your files, of course, depends on your personal preference. Many users though wonder about how they can make their anime work with Kodi or Plex. While usual tv gets released by the scene in a perfectly parsable way for your htpc, anime does not. The solution is simple though, just rename your anime to tvdb-style.

{Series.CleanTitle}.S{season:00}E{episode:00}.{absolute:000}.{Quality.Full}-{Release.Group}

The above renaming scheme is an example that will let your anime have almost the same style as episodes of regular tv. Let’s analyze and see why this naming scheme is good for you.

{Series.CleanTitle}.S{season:00}E{episode:00}.{absolute:000}.{Quality.Full}-{Release.Group}

This is the part that the Kodi/Plex scraper is interested in. It will be able to parse it like any regular tv show.


{Series.CleanTitle}.S{season:00}E{episode:00}.{absolute:000}.{Quality.Full}-{Release.Group}

This part isn’t really obvious. Why would you need the absolute number in there? It’s for forward compatibility. If you ever want to rename your anime to another style or if tvdb changes seasons and you want to fix the resulting wrong season/episode number, you would do it based on this absolute number. Having this will save you many headaches in the future.


{Series.CleanTitle}.S{season:00}E{episode:00}.{absolute:000}.{Quality.Full}-{Release.Group}

This part is for forward compatibility also. If something goes wrong with your library or you lose your database, you want Sonarr to be able to rescrape the quality of your files.


{Series.CleanTitle}.S{season:00}E{episode:00}.{absolute:000}.{Quality.Full}-{Release.Group}

The same goes for group. If you have a file, with the group in the end like this, Sonarr will be able to detect the group when this show is in your library. Feel free to modify this naming scheme to your personal preference or take comfort in knowing that the scheme, as described here, is well tested.

One more note. If you ever want to rename your files to exactly their original state, you can use AniDB O’Matic for that. It’s a tool that hooks directly into the info on anidb and parses your files by hash. It can then rename to the original name as stored at anidb. Be warned though. The hashing may take a very long time.


Anime Manual Import Issue

Per the forum post here , Sonarr currently has trouble parsing absolute episode numbers over 100, since it then treats the first digit as a season with the following two digits as the episode number. The current workaround for this issue is to add any release group name in brackets at the beginning of the file name.

Example: * Bad absolute file name: Show.234.Episode.Name.mkv * Modified file name: [DND] Show.234.Episode.Name.mkv


Folders

Only visible with advanced toggled

  • Create Empty Media folders - This will create an empty folder during disk scan
  • Delete Empty Folders - This will remove any empty folders during disk scan

Importing

  • Skip Free Space Check - Use when Sonarr is unable to detect free space from your series root folder
Only visible with advanced toggled
  • Minimum Free Space - Toggling this will prevent import if it would leave less than this amount of disk space available
Only visible with advanced toggled
  • Use Hardlinks instead of Copy - Use Hardlinks when trying to copy files from torrents that are still being seeded (for more information on this click HERE)
Only visible with advanced toggled
  • Import Extra Files - Import matching extra files (subtitles, nfo, etc) after importing a file


File Management

  • Ignore Deleted Episodes - Episodes deleted from disk are automatically unmonitored in Sonarr
  • Download Proper & Repacks - Should Sonarr automatically upgrade to propers when available? (see link for explanation on Proper and Repack)
    • Prefer and Upgrade - will prefer proper/repack if one is available (gives it a higher rating)
    • Do not upgrade automatically - This will not allow it to upgrade automatically but will still be rated accordingly.
    • Do not prefer - Use 'Do not Prefer' to sort by preferred word score over propers/repacks, essentially putting the proper/repack lower on the list
  • Analyse video files - Extract file information such as resolution, runtime and codec information from files. This requires Sonarr to read parts of the file which may cause high disk or network activity during scans.
  • Rescan Series Folder after Refresh
    • Always - This will rescan series folder based upon Tasks Schedule
    • After Manual Refresh - You will have to manually rescanning the disk
    • Never - Just as it says, NEVER
  • Change File Date
    • None - Sonarr will not change the date that shows in your given file browser
    • Sonarr - Local Release - The date the video was aired locally
    • Sonarr - UTC Release date - The date the video was released based upon the UTC
  • Recycling Bin - Designate a location for deleted files to go to (just in case you want to retrieve them before the bin is taken out)
  • Recycling Bin Cleanup - This is how old a given file can be before it is deleted permanently


Permissions

  • Set Permissions - This will allow Sonarr to set the given file permission when a given file is imported or renamed
  • File chmod folder - This is the permission level that Sonarr will set for a given file on import or rename (more information HERE)
    • The drop down box has a preset list of very commonly used permissions that can be used.
  • chmod Group - This only works if the user running Sonarr is the owner of the file. It's better to ensure the download client uses the same group as Sonarr.

Root Folders

  • Path - This shows the path to your media
  • Free Space - This is the free space being reported to Sonarr from the system
  • Unmapped Folders - These are folders that do not have a Series associated to it
  • The X at the end - This will remove this given root path
  • Add folder - This allows you to select a root path for a place to either place new downloads into this folder or to allow Sonarr to scan existing media

Profiles


Quality Profiles

  • Here you'll be allowed to set profiles for which you can have for the quality of series you're looking to download.
  • When selecting an existing profile or adding an additional profile a new window will appear
    Note: The quality with the blue box will be the quality that is set for Upgrade Until (basically the cutoff)
    • Name - Here you'll select a UNIQUE name for the profile to which you are creating
    • Upgrades allowed - If you tell Sonarr to download a Web 1080p as it is the first release of a specific episode then later somebody is able to upload a Bluray-1080p then with this selected Sonarr will automatically upgrade to the better quality
      Note: This is only if you have Bluray-1080p higher than Web 1080p within the Qualities section
    • Qualities - For definitions for qualities please click here
    • Edit Groups - Some qualities are grouped together to reduce the size of the list as well grouping like releases, Prime example of this is WebDL and WebRip as these are very similar and typically have similar bitrates. When editing the groups you can change the preference within each of the groups.
      • Qualities higher in the list are more preferred. Qualities within the same group are equal. Only checked qualities are wanted
        Note: By default the qualities are set from lowest (bottom) to highest (top)


Language Profiles

  • Here you'll be allowed to set profiles for which you can have for the language of series you're looking to download.
    • Name - Select a unique name for this given profile
    • Upgrades allowed - If you tell Sonarr download a Chinese version as it is the first release of a specific series then later somebody is able to upload an English version then with this selected Sonarr will automatically upgrade to the better quality
      Note: This is only valid if English is higher in the language list than Chinese and both are selected
    • Languages - Languages higher in the list are more preferred. Only checked languages are wanted


Delay Profiles

  • Delay profiles allow you to reduce the number of releases that will be downloaded for an Episode, by adding a delay while Sonarr will continue to watch for releases that better match your preferences.
    • Protocol - This will either be Usenet or Torrent depending on which download protocol you're using
    • Usenet Delay - Set by the number of minutes you'll want to wait before the download to start
    • Torrent Delay - Set by the number of minutes you'll want to wait before the download to start
    • Tags - This is where you'll select any relevant tags that you'll be using for this scheme
  • Wrench icon - This will allow you to edit the delay profile
  • Plus icon - Create a new profile

Example: Some media will receive half a dozen different releases of varying quality in the hours after a release, and without delay profiles Sonarr might try to download all of them. With delay profiles, Sonarr can be configured to ignore the first few hours of releases.

Delay profiles are also helpful if you want to emphasize one protocol (Usenet or BitTorrent) over the other. (See Example 3)

How Delay Profiles Work

The timer begins as soon as Sonarr detects an Episode has a release available. This release will show up in your Queue with a clock icon to indicate that it is under a delay.

During the delay period, any new releases that become available will be noted by Sonarr. When the delay timer expires, Sonarr will download the single release which best matches your quality preferences.

The timer period can be different for Usenet and Torrents. Each profile can be associated with one or more tags to allow you to customize which shows have which profiles. A delay profile with no tag is considered the default and applies to all shows that do not have a specific tag.

Examples

For each example, assume the user has the follow quality profile active: HDTV 720p and above are allowed WebDL 720p is the quality cutoff * WebDL 1080p is the highest ranked quality

Example 1:

In this simple example, the profile is set with a 120 minute (two hour) delay for both Usenet and Torrent.

At 11:00pm the first release for an Episode is detected by Sonarr and the 120 minute clock begins. At 1:00am, Sonarr will evaluate any releases it has found in the past two hours, and download the best one, which is WebDL 720p.

At 3:00am another release is found, which is WebDL 720p. Another 120 minute clock begins. At 5:00am the best-available release is downloaded. Since the cutoff is now reached, the Episode no longer monitored and Sonarr will stop looking for new releases.

At any point, if a WebDL 1080p release is found, it will be downloaded immediately because it is the highest-ranking quality. If there is a delay timer currently active it will be cancelled.

Example 2:

This example has different timers for Usenet and Torrents. Assume a 120 minute timer for Usenet and a 180 minute timer for BitTorrent.

At 11:00pm the first release for an Episode is detected by Sonarr and both timers begin. At 1:00am, Sonarr will evaluate any releases, and if there are any acceptable Usenet releases, the best one will be downloaded and both timers will end. If not, Sonarr will wait until 2:00am and download the best release, regardless of which source it came from.

Example 3:

A common use for delay profiles is to emphasize one protocol over another. For example, you might only want to download a BitTorrent release if nothing has been uploaded to Usenet after a certain amount of time.

You could set a 60 minute timer for BitTorrent, and a 0 minute timer for Usenet.

If the first release that is detected is from Usenet, Sonarr will download it immediately.

If the first release is from BitTorrent, Sonarr will set a 60 minute timer. If any qualifying Usenet release is detected during that timer, the BitTorrent release will be ignored and the Usenet release will be grabbed.

Release Profiles

  • Not all releases are created equal, each release group has their own way of packaging and encoding their material. Here you'll be able to select the preferred releases you're looking for
  • Enable Profile - Toggling this given profile on or off
  • Must Contain - The release must contain at least one of these terms (case insensitive)
  • Must Not Contain - The release will be rejected if it contains one or more of terms (case insensitive)
  • Preferred:
    • Here you can select a given term and give it a score.
    • Example: Let's say you're looking for releases with a specific grouping of words. Let's say you want to tell Sonarr that you want Repacks or Propers over regular releases. Here you'll put the word Repack in one of the fields and give it a value (say 100) but, you're also looking for DTS-HD audio so you'll put that in there and also give it a score (say 100 again). When Sonarr goes through and looks at all the releases from the RSS feed and it comes across a release that has both Repack and DTS-HD that will give it a score of 200. Which is much higher than all the others that don't have either of those words. This tells Sonarr that this has a higher score and it will be the first file picked for download.
  • Include Preferred when Renaming - When utilizing the {Preferred Words} tag in the naming scheme
  • Indexer - Specify what indexer the profile applies to.
    This is useful if you only want specific releases from a given indexer/tracker
  • Tags - With giving this release profile a tag you'll be able to tag a given series to have it play by the rules set here. If you leave this field blank these rules will apply to all series


Quality


Quality Table Meanings

  • Title - The name of the Quality in the GUI (configurable)
  • Max - The maximum Megabytes per Minute (MB/min) a quality can have.
  • Megabytes Per Minute - Self Explanatory
  • Min - The minimum Megabytes per Minute (MB/min) a quality can have.
  • Preferred - The preferred Megabytes per Minute (MB/min) a quality can have.
  • Quality - The scene quality name (hardcoded)
  • Size Limit - Self Explanatory


Qualities Defined

  • Unknown - Self Explanatory
  • SDTV - Post air rips from an analog source (usually cable television or OTA standard definition). The image quality is generally good (for the resolution) and they are usually encoded in DivX/XviD or MP4.
  • WEBDL-480p - WEB-DL (P2P) refers to a file losslessly ripped from a streaming service, such as Netflix, Amazon Video, Hulu, Crunchyroll, Discovery GO, BBC iPlayer, etc., or downloaded via an online distribution website such as iTunes. The quality is quite good, since they are not reencoded. The video (H.264 or H.265) and audio (AC3/AAC) streams are usually extracted from the iTunes or Amazon Video and remuxed into a MKV container without sacrificing quality. An advantage with these releases is that, like BD/DVDRips, they usually have no onscreen network logos. These are nearly as good as a Blu-ray source but can suffer from audio lag or visual artifacts from the adaptive bitrate of streaming services. If a ripper's internet connection drops to a point where the bitrate lowers, the source bitrate could change dynamically, causing variations in picture quality. Most releases that suffer from an extreme amount of visual artifacts are NUKED and a PROPER is generally released to fix any wild variations in adaptive bitrate. This will be in 480p (SD) quality.
  • WEBRip-480p - In a WEB-Rip (P2P), the file is often extracted using the HLS or RTMP/E protocols and remuxed from a TS, MP4 or FLV container to MKV. This will be in 480p (SD) quality.
  • DVD - A re-encode of the final released DVD9. If possible this is released PRE retail. It should be excellent quality (for the resolution). DVDrips are usually released in DivX/XviD or MP4.
  • Bluray-480p - A re-encode of the final released Blu-ray, downscaled to 480p resolution (720x480 @ 16:9, any other Aspect Ratio may be a different resolution). If possible this is released PRE retail. It should be excellent quality for the resolution. Bitrates may vary, but these are generally encoded to DivX, XviD, or AVC and offer the tradeoff of a small perceived quality reduction over the original source while drastically reducing filesize. These are generally MKV or MP4, but some DivX/XviD are around as well which use AVI.
  • HDTV-720p - A re-encode of the final released Blu-ray, but broadcast over HD cable or satellite (1280x720 @ 16:9, any other aspect ratio may be a different resolution). It may be modified for runtime or content depending on the network it came from. This is released usually several months after a retail release, but sometimes upscaled versions of a Standard Definition film are released on cable channels such as STARZ or HBO, and they would be the only HD copies of that specific film available. These are generally MKV or MP4.
  • HDTV-1080p - A re-encode of the final released Blu-ray, but broadcast over HD cable or satellite (1920x1080 @ 16:9, any other aspect ratio may be a different resolution). It may be modified for runtime or content depending on the network it came from. This is released usually several months after a retail release, but sometimes upscaled versions of a Standard Definition film are released on cable channels such as STARZ or HBO, and they would be the only HD copies of that specific film available. These are generally MKV or MP4 container.


  • WEBRip-720p - In a WEB-Rip (P2P), the file is often extracted using the HLS or RTMP/E protocols and remuxed from a TS, MP4 or FLV container to MKV. This will be in 720p quality.
  • Bluray-720p - A re-encode of the final released Blu-ray, downscaled to 720p resolution (1280x720 @ 16:9, any other aspect ratio may be a different resolution). If possible this is released PRE retail. It should be excellent quality for the resolution. Bitrates may vary, but these are generally encoded to AVC or HEVC and offer the tradeoff of a small perceived quality reduction over the original source while drastically reducing filesize. These are generally MKV or MP4 container.
  • WEBDL-1080p - WEB-DL (P2P) refers to a file losslessly ripped from a streaming service, such as Netflix, Amazon Video, Hulu, Crunchyroll, Discovery GO, BBC iPlayer, etc., or downloaded via an online distribution website such as iTunes. The quality is quite good, since they are not reencoded. The video (H.264 or H.265) and audio (AC3/AAC) streams are usually extracted from the iTunes or Amazon Video and remuxed into a MKV container without sacrificing quality. An advantage with these releases is that, like BD/DVDRips, they usually have no onscreen network logos. These are nearly as good as a Blu-ray source but can suffer from audio lag or visual artifacts from the adaptive bitrate of streaming services. If a ripper's internet connection drops to a point where the bitrate lowers, the source bitrate could change dynamically, causing variations in picture quality. Most releases that suffer from an extreme amount of visual artifacts are NUKED and a PROPER is generally released to fix any wild variations in adaptive bitrate. This will be in 1080p quality.
  • WEBRip-1080p - In a WEB-Rip (P2P), the file is often extracted using the HLS or RTMP/E protocols and remuxed from a TS, MP4 or FLV container to MKV. This will be in 1080p quality.
  • Bluray-1080p - A re-encode of the final released Blu-ray, at its native 1080p resolution (1920x1080 @ 16:9, any other aspect ratio may be a different resolution). If possible this is released PRE retail. It should be excellent quality and the same resolution as the source. Bitrates may vary, but these are generally encoded to AVC or HEVC and offer the tradeoff of a small perceived quality reduction over the original source while slightly reducing filesize. These are generally MKV or MP4 container.
  • Remux-1080p - A remux is a rip of a Blu-ray or HD DVD disc to another container format or just stripping the disc of menus and bonus material while keeping the contents of its audio and video streams intact (also keeping the current codecs), guaranteeing the exact 1:1 movie quality as on original disc. This is at 1080p quality.
  • HDTV-2160p - TVRip is a capture source from an capture card. HDTV stands for captured source from HD television. With an HDTV source, the quality can sometimes even surpass DVD. Movies in this format are starting to grow in popularity. Some advertisement and commercial banner can be seen on some releases during playback. This is at 2160p (4K) quality.
  • WEBDL-2160p - WEB-DL (P2P) refers to a file losslessly ripped from a streaming service, such as Netflix, Amazon Video, Hulu, Crunchyroll, Discovery GO, BBC iPlayer, etc., or downloaded via an online distribution website such as iTunes. The quality is quite good, since they are not reencoded. The video (H.264 or H.265) and audio (AC3/AAC) streams are usually extracted from the iTunes or Amazon Video and remuxed into a MKV container without sacrificing quality. An advantage with these releases is that, like BD/DVDRips, they usually have no onscreen network logos. These are nearly as good as a Blu-ray source but can suffer from audio lag or visual artifacts from the adaptive bitrate of streaming services. If a ripper's internet connection drops to a point where the bitrate lowers, the source bitrate could change dynamically, causing variations in picture quality. Most releases that suffer from an extreme amount of visual artifacts are NUKED and a PROPER is generally released to fix any wild variations in adaptive bitrate. This will be in 2160p (4K) quality.
  • WEBRip-2160p - In a WEB-Rip (P2P), the file is often extracted using the HLS or RTMP/E protocols and remuxed from a TS, MP4 or FLV container to MKV. This will be in 2160p (4k) quality.
  • Bluray-2160p - A re-encode of the final released Blu-ray, at its native 21600p resolution (3840x2160 @ 16:9, any other aspect ratio may be a different resolution). 4K versions of films that are released in generally HEVC codec and could be either 8-bit or 10-bit color reproduction or from an HDR source. slightly reducing filesize. These are generally MKV or MP4 container.
  • Remux-2160p - A remux is a rip of a Blu-ray or HD DVD disc to another container format or just stripping the disc of menus and bonus material while keeping the contents of its audio and video streams intact (also keeping the current codecs), guaranteeing the exact 1:1 movie quality as on original disc. This is at 2160p (4K) quality.

Indexers


Once you're here you'll be adding the indexer/tracker that you'll be using to actually download any of your files. If you're curious on how Sonarr works with your indexer/tracker click HERE


Indexers

Once you've clicked the + button to add a new indexer you'll be presented with a new window with many different options. For the purposes of this wiki Sonarr considers both Usenet Indexers and Torrent Trackers as "Indexers".

There are two sections here: Usenet and Torrents. Based upon what download client you'll be using you'll want to select the type of indexer you'll be going with.

More information on Indexers and Trackers can be found HERE

Usenet:

  • Newsznab - Here you'll find presets of popular usenet indexers (that are pre-filled out, all you'll need is your API key which is provided by the usenet indexer of your choice) along with the ability to create a custom Indexer
  • An excellent software that works with usenet and intigrates quite well with Sonarr is NZBhydra2
    • Regardless of if you select a pre filled out indexer or a custom indexer setup you'll be presented with a new window to input all your settings
    • Name - This is where you'll select a unique name - typically you'd want to put the indexer name that you're using
    • Enable RSS - Enable this indexer for monitoring the RSS feed for new future releases
    • Enable Automatic Search - Enable this indexer for when you trigger an automatic search (the magnifying glasas icon)
    • Enable Interactive Search - Enable this indexer for when you trigger an interactive search, by click thing the little man icon
    • URL - Typically this will be your indexer's website, consult your indexer if this is not the case
    • API Path (advanced option) - Path to the api, usually /api
    • Multilanguage - What languages are normally in a multi release on this indexer?
      • This is very useful when looking for a movie that is typically released in multiple languages, Example: Anime
    • API Key - This will be provided to you by your indexer
    • Categories (advanced option) - Comma Separated list of the numerical categories to be scanned. Prefilled catagores should sufice unless you know what you're doing
    • Additional Parameters - Any additional parameters that are needed in order to make your Usenet indexer operate
    • Remove year from search string - Should Sonarr remove the year after the title when searching this indexer? This option can cause issues if there are multiple releases of the same name in different years
    • Indexer Priority - If Sonarr comes across a release that is identical which indexer would you like Sonarr to pull from?

Torrents:

  • As with Usenet there are an assortment of prefilled out Torrent tracker information. If you are not a member of any of these these specific trackers they will not do you any good.
  • One of the best and simplist ways to utalize Torrent trackers with Sonarr is to utalize a second program called Jackett. This software pairs well with Sonarr as a search indexer that houses all your information and sends it to Sonarr.
  • Torznab - This option will set you up with a Jackett preset, if you utalize multiple trackers you'll need to have each entry have a unique name
    • Name - This is where you'll select a unique name - typically you'd want to put the tracker name that you're using
    • Enable RSS - Enable this indexer for monitoring the RSS feed for new future releases
    • Enable Automatic Search - Enable this indexer for when you trigger an automatic search (the magnifying glasas icon)
    • Enable Interactive Search - Enable this indexer for when you trigger an interactive search, by click thing the little man icon
    • URL - If you're utalizing Jackett this will be the URL for your Jackett installation
      • Typicall this will be http://localhost:9117 if it is on the same physical machine as Sonarr
    • API Path (advanced option) - Path to the api, usually /api
    • API Key - This will be provided to you by your provider
      • If using Jackett, this will be located in the upper right hand corner of the webpage
    • Categories (advanced option) - Comma Separated list of the numerical categories to be scanned. Prefilled catagores should sufice unless you know what you're doing
    • Remove year from search string - Should Sonarr remove the year after the title when searching this indexer? This option can cause issues if there are multiple releases of the same name in different years
    • Seed Ratio - In the community of torrents you SHOULD give as much as you recieve, most communities expect you to seed to a ratio of 1 (meaning you have given back as much as you've taken). This setting will override any global setting within your download client.
    • Seed Time - In most torrenting communties they will give you the minimum amount of time any torrent should be seeded. If you do not meet this minimum seed time you'll recieve a Hit and Run (HNR). This setting is set in minutes. This setting will override any global setting within your download client. Time Calculator days to minutes
    • Required Flags - Here you'll select how you'd like for this indexer to behave. Say you want this indexer to only download Freeleech torrents, this is where you'll force that behavior
    • Indexer Priority - If Sonarr comes across a release that is identical which indexer would you like Sonarr to pull from?
Supported Indexers
  • Usenet
    • Newznab
      • Newznab is a standardized API used by many usenet indexing sites.
      • Many presets are available, but most require an API key to be accessible.
    • Omgwtfnzbs
      • This indexer also supports newznab and is available as one of the above presets.
      • Website: https://omgwtfnzbs.me/
    • Fanzub
      • Website: http://fanzub.com/
      • Indexer for Japanese media (Anime) exclusively.
      • NOTE: The original Fanzub site was decommissioned March 1st, 2015. Several alternatives sites implementing the same api may be available.
  • Torrents
    • BroadcastheNet
    • Filelist
    • HDBits
    • IPTorrents
    • Nyaa
      • Website: http://www.nyaa.se/
      • Torrent Indexer for Japanese media (Anime) exclusively.
      • NEWS May 06, 2017 According https://torrents.me/site/nyaa/ nyaa has been taken down by the author voluntarily without official statement. The site is permanently inaccessible.
      • A new site has been created at http://www.nyaa.si/ (Needs update, can be fixed manually). But it’s api differ slightly from the one nyaa.se used.
    • Rarbg
    • Torrent RSS Feed
      • Generic torrent RSS feed parser.
      • NOTE: The RSS feed must contain a pubdate. The release size is recommended as well.
      • Private tracker
    • Torrentleech
    • Torznab
      • Known indexers: Anime Tosho and Nyaa Pantsu as well as Jackett.
      • Torznab is a wordplay on Torrent and Newznab. It uses the same structure and syntax as the Newznab API specification, but exposing torrent-specific attributes and .torrent files. Thus supports a recent rss feed AND backlog searching capabilities. The specification is not maintained and supported by the Newznab organization. (The same api specification is shared with nZEDb)
      • At this point it’s unlikely your favorite tracker supports this. We’ll update this post once we become aware of other trackers supporting it. Additionally you can use Jackett. It acts as a Torznab proxy adding Toznab support for more than 100 torrent trackers, but uses website scraping instead of APIs.
      • Important/Disclaimer: Many torrent trackers thrive on the community and may have rules in place that mandate site visits, karma, votes, comments and all. Please review your tracker rules and etiquette, keep your community alive.
      • We’re not responsible if your account is banned for disobeying rules or accruing HnRs/low-ratio.
    • We’re not responsible if your account is banned for disobeying rules or accruing HnRs/low-ratio.
  • Supported Features
Indexer Recent Feed Standard Season Daily Anime Specials
Usenet
Newznab Yes Yes Yes Yes Yes Basic
Fanzub Yes - - - Yes -
Omgwtfnzbs Yes Yes Yes Yes - Basic
Torrent
Torznab Yes Yes Yes Yes Unknown Unknown
TorrentRss Yes - - - - -
BitMeTv Yes - - - - -
BroadcastheNet Yes Yes Yes Yes - Basic
HDBits Yes Yes Yes Yes Unknown -
IPTorrents Yes - - - - -
Nyaa Yes - - - Yes Basic
Rarbg Yes Yes Yes Yes - -
Torrentleech Yes - - - - -


Options

  • Minimum Age - Usenet only: Minimum age in minutes of NZBs before they are grabbed. Use this to give new releases time to propagate to your usenet provider.
  • Retention - Usenet only: Set to zero to set for unlimited retention
  • Maximum Size - Maximum size for a release to be grabbed in MB. Set to zero to set to unlimited
  • RSS Sync interval - Interval in minutes. Set to zero to disable (this will stop all automatic release grabbing) Minimum: 10 minutes Maximum: 120 minutes


If Sonarr has been offline for an extended period of time, Sonarr 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 Sonarr will be able to process the releases it would have missed and avoid you needing to perform a search for the missed episodes.

Download Clients


Overview

Downloading and importing is where most people experience issues. From a high level perspective, the software needs to be able to communicate with your download client and have access to the files it downloads. There is a large variety of supported download clients and an even bigger variety of setups. This means that while there are some common setups there isn't one right setup and everyone's setup can be a little different. But there are many wrong setups.

Download Clients

  • Usenet
    1. Sonarr 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, ect.
    2. Sonarr will monitor your download clients active downloads that use that category name. It monitors this via your download client's API.
    3. When the download is completed, Sonarr will know the final file location as reported by your download client. This file location can be almost anywhere, as long as it is somewhere separate from your media folder and accessible by Sonarr
    4. Sonarr will scan that completed file location for files that Sonarr can use. It will parse the file name to match it against the requested media. If it can do that, it will rename the file according to your specifications, and move it to the specified media location.
    5. Leftover files from the download will be sent to your trash or recycling.
  • BitTorrent - If you're downloading using a BitTorrent client, the process is slightly different:
    1. 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 Sonarr under the specific download client). When files are imported to your media folder by default Sonarr will copy the file, which uses twice the disk space.
    2. An advanced option to hardlink can be enabled (Settings > Media Management > Importing) which will attempt to hardlink the media to your Series folder. A hardlink will allow not use any additional disk space. If the hardlink creation fails, Sonarr will fall back to the default behavior and copy the file.
    3. If the "Completed Download Handling - Remove" option is enabled in Sonarr's settings, Sonarr} will delete the original file and torrent from your client, but only if the client reports that seeding is complete and torrent is stopped.
    • Sabnzbd
    • Nzbget
    • NZBVortex
    • Pneumatic
      • Website: None at this time
      • Streaming Add-on for XBMC.
    • DownloadStation
    • UsenetBlackhole
      • Puts NZB into a folder to be picked up by an external tool. Will watch another folder to check for completed downloads.
    • Deluge
    • TorrentBlackhole
      • Puts .torrent files into a folder, to be picked up by an external tool. Will watch another folder to check for completed downloads.
    • Transmission
    • uTorrent
      • Version 3.0 or newer required. Requires Web UI (located in Preferences -> Advanced) enabled.
      • Website: uTorrent
    • rTorrent
      • Requires rTorrent version 0.9.0 or newer compiled with XML-RPC support, and a SCGI to HTTP proxy (usually Lighttpd, Nginx, or Apache; ruTorrent can also provide this on on the URL plugins/rpc/rpc.php). Look for ruTorrent instructions for how to set up rTorrent.
      • Website: rTorrent
    • qBittorrent
      • Requires qBittorrent 3.2.4 or higher.
      • Website: qBittorrent
    • Vuze
      • Requires Vuze 5.0.0.0 or higher
      • Website: Vuze
    • DownloadStation
    • Hadouken
    • Compatibility
      • Sonarr is only able to set the seed ratio/time on clients that support setting this value via their API when the torrent is added. See the table below for client compatibility.
Client Ratio Time
Deluge Yes -
Hadouken - -
qBittorrent Yes Yes
rTorrent - -
Torrent Blackhole - -
Download Station - -
Transmission Yes Idle Limit [1]
uTorrent Yes Yes
Vuze Yes Yes

[1] Transmission internally has an Idle Time check, but Sonarr compares it with the seeding time if the idle limit is set on a per-torrent basis. This is done as workaround to Transmission’s api limitations.

Completed Download Handling

Completed Download Handling is how Sonarr imports media from your download client to your series folders. Many common issues are related to bad Docker paths and/or other Docker permissions issues.

  • Enable - Automatically import completed downloads from the download client
  • Remove - Remove completed downloads when finished (usenet) or stopped/complete (torrents)

Remove Completed Downloads

  1. Sonarr 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.
  2. Sonarr will monitor your download clients active downloads that use that category name. It monitors this via your download client's API.
  3. When the download is completed, Sonarr will know the final file location as reported by your download client. This file location can be almost anywhere, as long as it is somewhere separate from your media folder.
  4. Sonarr will scan that completed file location for video files. It will parse the video file name to match it to an episode. If it can do that, it will rename the file according to your specifications, and move it to the assigned library folder.
  5. Leftover files from the download will be sent to your trash or recycling.

If you download using a BitTorrent client, the process is slightly different:

  • Completed files are left in their original location to allow you to seed. When files are imported to your assigned library folder Sonarr will attempt to hardlink the file or fall back to copy (use double space) if hard links are not supported.
  • If the "Completed Download Handling - Remove" option is enabled in settings, Sonarr will delete the original file and torrent from your client, but only if the client reports that seeding is complete and torrent is stopped.


Failed Download Handling

Failed Download Handling is compatible with SABnzbd and NZBGet.

There are a couple components that make up the failed download handling process:

  1. Check Downloader:
    • Queue - Check your downloader's queue for password-protected (encrypted) releases
    • History - Check your downloader's history for failure (eg. not enough to repair, or extraction failed)
    • When Sonarr finds a failed download it starts processing them and does a few things:
    1. Adds a failed event to Sonarr's history
    2. Removes the failed download from Download Client to free space and clear downloaded files (optional)
    3. Starts searching for a replacement file (optional)
  2. Blacklisting Allows automatic skipping of nzbs when they fail, this means that nzb will not be automatically downloaded by Sonarr ever again (You can still force the download via a manual search).

There are 2 advanced options (on 'Download Client' settings page) that control the behavior of failed downloading in Sonarr, at this time, they are all on by default.

  • Redownload - Controls whether or not Sonarr will search for the same file after a failure
  • Remove - Whether or not the download should automatically be removed from Download Client when the failure is detected

Remote Path Mappings

Remote Path Mapping acts as a dumb find Remote Path and replace with Local Path This is primarily used for either merged local/remote setups using mergerfs or similar or is used for when the application and download client are not on the same server.

One of our amazing community members have created an excellent guide to help you out if you think remotte path mapping is what will work for you here


Import Lists


Lists

Import lists are a part of Sonarr 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 ArrowVerse Collection section and want to watch every show on their list. You look in your Sonarr and realize that you don't have those series. Well instead of searching one by one and adding those items and then searching your indexers for those series. You can do this all at once with a List. The Lists can be set to import all the series on that curator's list as well as be set to automatically assign a quality profile, automatically add, and automatically monitor that series.

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 Sonarr.

  • Here you can select the + button to open a new pop up window
    • From this new window you are presented with many different options to set up your list from many different list providers. As stated before be careful when doing lists. It is highly recommended to not select the Search on add button before you're absolutely sure the list you select/setup is adding the series that you're looking for.
    • Once you've selected the list provider that you're looking to pull from (such as IMDb, IMDb, Trakt) You'll be presented with a new window.
      • Most of the lists settings are fairly self explanatory, some lists require you to authenticate with the provider such as Trakt (requiring you to have an account with Trakt.tv


List Exclusions

  • Import List Exclusion - This allows you to prune your list of movies you don't want to see again. An example of this is if your list just so happens to contain a movie that is in a foreign language and it is not likely for you to ever find this movie in your native language and do not want to watch it with subtitles. You can exclude a movie from being added in the future. However, in the list exclusion section you can add it back to the list so that when the list runs again it will be readded to your library.


Connect


Connections

Connections are how you want Sonarr to communicate with the outside world.

  • By pressing the + button you'll be presented with a new window which will allow you to configure many different endpoints
    • There are many different endpoints
      • Boxcar
      • Custom scripts - This allows you to make a custom script for when a particular action happens this script will run
      • Discord - By far one of the most common ways to push notifications of actions happening on your Sonarr
      • Email - Simply send yourself or somebody you want to annoy with emails. If you're using Gmail and have 2-factor authentication enabled you need to use an App Specific password: https://support.google.com/accounts/answer/185833
      • Emby
      • Gotify
      • Join
      • Kodi - Kodi spawned from the love of media. It is an entertainment hub that brings all your digital media together into a beautiful and user friendly package. It is 100% free and open source, very customisable and runs on a wide variety of devices. It is supported by a dedicated team of volunteers and a huge community.
        • By adding Kodi as a connection you can update Kodi's library when a new episode has been added to Sonarr
      • Plex Home Theater
      • Plex Media Center
      • Plex Media Server - The server for your self hosted Plex system, Enabling this is much like Kodi will allow you to push an update to your plex server notifying it that a new/upgraded episode is available
      • Prowl
      • Pushbullet
      • Pushover
      • Sendgrid
      • Slack
      • Synology Indexer
      • Telegram
      • Trakt
      • Twitter
  • Connection Triggers
    • On Grab - Be notified when episodes are available for download and has been sent to a download client
    • On Import - Be notified when episodes are successfully imported
    • On Upgrade - Be notified when episodes are upgraded to a better quality
    • On Rename - Be notified when episodes are renamed
    • On Health Issue - Be notified on health check failures
    • Include Health Warnings - Be notified on health warnings in addition to errors.


Metadata


Metadata

Here you can select the type of meta data that will be consumed by your media player

  • Kodi will be one of the most commonly used options here if that is the software that is being used. This will allow Sonarr to create a NFO file as well as associated movie posters to be scraped into your player


Tags


  • The tag section is for Sonarr is simply used to see what tags you have used and what seriess have that tag associated to it.
  • Tags can be useful to limit certain aspects of Sonarr to a specific series

General


Host

  • Binding Address - Valid IP4 address or '*' for all interfaces
  • Port Number - The port number that you are wanting to use to access the webUI for Sonarr
    • Note: If using Docker do not touch
  • URL Base - For reverse proxy support, default is empty
    • Note: If using a reverse proxy (IE: mydomain.com/sonarr) you would enter '/sonarr' for URL Base.
  • Enable SSL - If you have SSL credentials and would like to secure communication to and from your Sonarr enable this option.
    • Note: do not mess with unless you know what you're doing

Security

  • Authentication - How would you like to authenticate to access your Sonarr instance
    • None - You have no authentication to access your Sonarr
      • Typically if you're the only user of your network, do not have anybody on your network that would care to access your Sonarr or your Sonarr is not exposed to the web
    • Basic (Browser pop-up) - This option when accessing your Sonarr will show a small pop-up allowing you to input a Username and Password
    • Forms (Login Page) - This option will have a familiar looking login screen much like other websites have to allow you to log onto your Sonarr
  • API Key - This is how other programs would communicate or have Sonarr communicate to other programs. This key if given to the wrong person with access could do all kinds of things to your library. This is why in the logs the API key is redacted
  • Certificate Validation - Change how strict HTTPS certification validation is

Proxy

  • Proxy - This option allows you to run the information your Sonarr pulls and searches for through a proxy. This can be useful if you're in a country that does not allow the downloading of Torrent files

Logging

  • Log level - Probably one of the most useful troubleshooting tools
    • Info - This is the most basic way that Sonarr gathers information this will include very minimal amount of information in the logs.
      • This log file contains fatal, error, warn and info entries.
    • Debug - Debug will include all the information that Info includes plus more information that can be useful.
      • This log files contains fatal, error, warn, info and debug entries
    • Trace - The most advance and detailed logging on Sonarr, Trace will include all the information gathered by Info and Debug and more. This is the most common type of log that is going to be asked for when trouble shooting on Discord or Reddit. If you're needing help please select your log to Trace and redo the task that was giving you problems to capture the log.
      • This log files contains fatal, error, warn, info, debug and trace entries.

Analytics

  • Analytics - Send anonymous usage and error information to Sonarr's servers (SkyHook). This includes information on your browser, which Sonarr WebUI pages you use, error reporting as well as OS and runtime version. We will use this information to prioritize features and bug fixes.

Updates

  • Branch - This is the branch of Sonarr that you are running on. Please see Github for available branches and version information
    • master (Default/Stable): It has been tested by users on nightly branch and it's not known to have any major issues. This is currently v2. This version is effectively end of life and no longer receiving updates.
    • develop (Former Nightly/Beta) : This was the bleeding edge, when development was being done on v2. It is released as soon as code is committed and passes all automated tests. This build may have not been used by us or other users yet. There is no guarantee that it will even run in some cases.
    • phantom-develop (Nightly/Beta): This is beta. This is currently v3. Once you upgrade to v3 you cannot go back to v2.
  • Automatic - Automatically download and install updates. You will still be able to install from System: Updates
  • Mechanism - Use Sonarr built-in updater or a script
    • Built-in - Use Sonarr's own updater
    • Script - Have Sonarr run the update script
    • Docker - Do not update Sonarr from inside the Docker, instead pull a brand new image with the new update
    • Apt - Set by the Debian/Ubuntu package when updating is managed exclusively via Apt
  • Script - Visible only when Mechanism is set to Script - Path to update script
  • Update Process - Sonarr will download the update file, verify its integrity and extract it to a temporary location and call the chosen method. The update process will be be run under the same user that Sonarr is run under, it will need permissions to update the Sonarr files as well as stop/start Sonarr.
    • Built-in - The built-in method will backup Sonarr files and settings, stop Sonarr, update the installation and Start Sonarr, if your system will not handle the stopping of Sonarr and will attempt to restart it automatically it may be best to use a script instead. In the event of failure the previous version of Sonarr will be restarted.
    • Script - The script should handle the the same as the built-in updater, if you need to handle stopping and starting services (upstart/launchd/etc) you will need to do that here.


Backups

The backup section allows you to tell Sonarr how you would like for it to handle backups

  • Folder - This allows you to select the backup location
    • In docker you will be limited to what you allow the container to see
  • Interval - How often would you like Sonarr to make a backup
  • Retention - How long would you like Sonarr to hold on to each backup. After a new backup is made the oldest backup will be removed


UI

Calendar

In this section you can manipulate some features of the calendar

  • First Day of Week - Here you can select what you think the first day of the week should be.
  • Week Column Header - Here you can select the header for the columns


Dates

  • Short Date Format - How do you want Sonarr to display short dates?
  • Long Date Format - How do you want Sonarr to display long format dates?
  • Time Format - Do you want a 12hr or 24hr format?
  • Show Relative Dates - Do you want Sonarr to show relative (Today/Yesterday/etc) or absolute dates?

Style

  • Enable Color-Impaired Mode - Altered style to allow color-impaired users to better distinguish color coded information