Sonarr

Table of Contents

Note: this is the Legacy v2 Wiki. The new V3 Wiki can be found at the Servarr Wiki.
Terminology
The Import Process
Remote Path Mapping
Rename Options

Note: this is the Legacy v2 Wiki. The new V3 Wiki can be found at the Servarr Wiki.

Terminology

Completed Download Handling: Retrieves completed downloads from your download client and imports them, more information: Completed-Download-Handling

Completed Download Folder: This is the folder where your download client places completed downloads (best if it only contains TV shows)

Completed TV Download Folder: Completed folder that only contains TV shows

Drone Factory: Deprecated This needs to be the same as the Completed Download Folder (you should never use a folder that contains sorted and renamed episodes)

Sorted TV Folder: Final folder that contains your sorted and renamed episodes (in their respective series folders)

The Import Process

Sonarr does a number of checks to verify that the download is acceptable for importing, including:

Sample file check (run time is longer than 90 seconds)
Upgrade for existing episode file (if any)
Not being unpack by the download client (UNPACK in SABnzbd)
Enough free space exists at the destination

Once a file has passed all those checks it is imported, if there is an existing file it is deleted, otherwise the episode file is moved and renamed (according to your naming rules). Once the file has been moved it removes the source folder as long as it is less than 70MB in size). If no files are imported nothing is deleted.

Remote Path Mapping

Combines with Complete Download Handling to tell Sonarr to use a different path for importing files from your download client, useful when Sonarr and your download client are on different machines.

Host must match the host set for the download client within Sonarr (Settings -> Download Clients)

Remote Path path as reported by your download client

Local Path path Sonarr can access. Sonarr will not mount any files directly, they must be synced over or the remote path mounted in some way (SMB, NFS, sshfs, etc). If you sync the files from a remote location ensure that the files are not visible and/or treated as video files (change the extension)

Rename Options

{MediaInfo Audio}
{MediaInfo AudioChannels}
{MediaInfo AudioCodec}
{MediaInfo Full}
{MediaInfo Simple}
{MediaInfo Video}
{MediaInfo VideoBitDepth}
{MediaInfo VideoCodec}
{MediaInfo VideoDynamicRange}
{Series CleanTitle}
{Series Title}
{Series TitleThe}
{TVDB ID}
{TVMaze ID}
{IMDB ID}
{Original Filename}
{Original Title}
{Quality Full}
{Quality Proper}
{Quality Real}
{Quality Title}
{Release Group}

Getting Started

Troubleshooting

Additional Configuration

More Information

Development

Contributing

API