mirror
/
Sonarr
mirror of https://github.com/Sonarr/Sonarr
1
0
Fork 0
Code Issues Releases Wiki Activity

Updated Completed Download Handling (markdown)

Thirrian 2020-06-08 09:26:45 +02:00
parent 9e2b6f8308
commit ed87143a2e
1 changed files with 2 additions and 49 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

51
Completed-Download-Handling.md

@ -4,7 +4,7 @@
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.
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. 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.
@ -12,54 +12,7 @@ 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 by default will copy the video file, which uses twice the disk space. 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.
- 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:
- Doesn't scan your hard drive every minute for new downloads to complete
- Waits for files to be extracted by your download client and post-processing script run before attempting to move it (should eliminate issues with partially extract files being moved)
- Tracks downloads through post processing state (instead of showing as missing until its imported)
- Gets the file path to the download directly via the api, so the user doesn't have to configure it in Sonarr.
- Better scene name handling. We can attach the actual scene name to database instead of the file name which can be pretty cryptic at times
##### 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.
#### Migrating to Completed Download Handling from Drone Factory
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.
###### Sabnzbd: Enable Completed Download Handling
Steps:
1. Create a new category with different output path and select that category in the Sonarr SABnzbd settings page.
Do **not** adjust the Drone Factory Folder to use the same path.
2. Once that's done you're ready to enable Completed Download Handling.
###### Nzbget: Conflicting Download Client Category
_Your Download Client is configured to use a category which put completed downloads in the Drone Factory._
Steps:
1. Create a new category with different output path and select that category in the Sonarr Nzbget settings page.
Do **not** adjust the Drone Factory Folder to use the same path.
2. Once that's done you're ready to 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._
Steps:
1. Enable Completed Download Handling by toggling the switch on the Sonarr Settings -> Download Client page.
###### All: Download Client on Different Computer
#### 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._