Mirrors/Sonarr
1
0
Fork 0
mirror of https://github.com/Sonarr/Sonarr.git synced 2024-11-22 18:52:50 +01:00
Code Issues Releases Wiki Activity

Made this into a more general CDH info page. Put the migration scenarios at the bottom.

Nelluk 2015-10-26 13:50:47 -04:00
parent 14cd7637c9
commit 29f8c15f41
1 changed files with 23 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

31
Migrating-to-Completed-Download-Handling.md → Completed-Download-Handling.md

@ -1,4 +1,19 @@
## Completed Download Handling vs Drone Factory **Completed Download Handling** is how Sonarr imports media from your download client to your series folders. It replaced an older system called the **Drone Factory** in early 2015. Most setups should exclusively use Completed Download Handling.
#### How Completed Download Handling Works
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. The default is 'tv'.
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. It also should not be the same as your Drone Factory folder, if you still use that system. Something like *C:\Downloads\Completed\TV* works well.
4. Sonarr will scan that completed file location for video files. It will parse the video file name to match it to a show, season, and episode. If it can do that, it will rename the file according to your specifications, and move it to the TV Series 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 Series folder Sonarr will attempt to hardlink the file so that it is not using additional space on your disk. If the hardlink cannot be accomplished, Sonarr will copy the file and there will be two versions.
- 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.
#### Completed Download Handling vs Drone Factory
##### Pros: ##### Pros:
@ -11,12 +26,12 @@
##### Cons: ##### Cons:
- Requires Sonarr and your download client to be on the same machine or the remote file system mounted locally and remapped in Sonarr with Remote Path Mapping. - Requires Sonarr and your download client to be on the same machine or the remote file system mounted locally and remapped in Sonarr with Remote Path Mapping.
## Migration Scenarios #### Migrating to Completed Download Handling from Drone Factory
Depending on your current configuration you may have to deal with one of the following scenarios. Depending on your current configuration you may have to deal with one of the following scenarios.
The health check link will attempt to direct you to the scenario specific for your configuration. The health check link will attempt to direct you to the scenario specific for your configuration.
#### Sabnzbd: Enable Completed Download Handling ###### Sabnzbd: Enable Completed Download Handling
Steps: Steps:
@ -25,7 +40,7 @@ Steps:
2. Once that's done you're ready to enable Completed Download Handling. 2. Once that's done you're ready to enable Completed Download Handling.
#### Nzbget: Conflicting Download Client Category ###### Nzbget: Conflicting Download Client Category
_Your Download Client is configured to use a category which put completed downloads in the Drone Factory._ _Your Download Client is configured to use a category which put completed downloads in the Drone Factory._
@ -36,7 +51,7 @@ Steps:
2. Once that's done you're ready to enable Completed Download Handling. 2. Once that's done you're ready to enable Completed Download Handling.
#### Nzbget: Enable Completed Download Handling ###### Nzbget: Enable Completed Download Handling
_Sonarr didn't detect any potential conflicts with your configuration. So you should be ready to enable Completed Download Handling._ _Sonarr didn't detect any potential conflicts with your configuration. So you should be ready to enable Completed Download Handling._
@ -44,7 +59,7 @@ Steps:
1. Enable Completed Download Handling by toggling the switch on the Sonarr Settings -> Download Client page. 1. Enable Completed Download Handling by toggling the switch on the Sonarr Settings -> Download Client page.
#### Unsupported: Download Client on Different Computer ###### Unsupported: Download Client on Different Computer
_As mentioned earlier, Completed Download Handling gets the file path to the download directly from the Download Client. Such a path is inaccessible from different computers and would prevent Completed Download Handling from importing the download._ _As mentioned earlier, Completed Download Handling gets the file path to the download directly from the Download Client. Such a path is inaccessible from different computers and would prevent Completed Download Handling from importing the download._
@ -52,7 +67,7 @@ The best solution to this problem is to run Sonarr and your Download Client on t
_There are some advanced options to work around this limitation, but those will not be discussed here_ _There are some advanced options to work around this limitation, but those will not be discussed here_
## Keeping Completed Download Handling disabled ##### Keeping Completed Download Handling disabled
If you absolutely want to keep using the Drone Factory: If you absolutely want to keep using the Drone Factory:
@ -61,7 +76,7 @@ If you absolutely want to keep using the Drone Factory:
This will permanently remove the warning. This will permanently remove the warning.
## Advanced Configuration/Migration Options ##### Advanced Configuration/Migration Options
The above scenarios were written to avoid complex choices. If you're a Power User you might want to have a couple of different options: The above scenarios were written to avoid complex choices. If you're a Power User you might want to have a couple of different options: