seasonpackarr is a companion app for autobrr that automagically hardlinks downloaded episodes into a season folder when a season pack is announced, eliminating the need for re-downloading existing episodes.
Warning
This application is currently under active development. If you encounter any bugs, please report them in the dedicated #seasonpackarr channel on the TRaSH-Guides Discord server or create a new issue on GitHub, so I can fix them.
Download the latest release, or download the source code and build it yourself using go build.
wget $(curl -s https://api.github.com/repos/nuxencs/seasonpackarr/releases/latest | grep download | grep linux_x86_64 | cut -d\" -f4)Run with root or sudo. If you do not have root, or are on a shared system, place the binary somewhere in your home
directory like ~/.bin.
tar -C /usr/bin -xzf seasonpackarr*.tar.gzThis will extract seasonpackarr to /usr/bin.
Afterwards you need to make the binary executable by running the following command.
chmod +x /usr/bin/seasonpackarrNote: If the commands fail, prefix them with sudo and run them again.
On Linux-based systems, it is recommended to run seasonpackarr as a sort of service with auto-restarting capabilities, in order to account for potential downtime. The most common way is to do it via systemd.
You will need to create a service file in /etc/systemd/system/ called seasonpackarr@.service.
touch /etc/systemd/system/seasonpackarr@.serviceThen place the following content inside the file (e.g. via nano/vim/ed):
[Unit]
Description=seasonpackarr service for %i
After=syslog.target network-online.target
[Service]
Type=simple
User=%i
Group=%i
ExecStart=/usr/bin/seasonpackarr start --config=/home/%i/.config/seasonpackarr
[Install]
WantedBy=multi-user.target
Start the service. Enable will make it startup on reboot.
sudo systemctl enable -q --now seasonpackarr@$USERMake sure it's running and active.
sudo systemctl status seasonpackarr@$USEROn first run it will create a default config, ~/.config/seasonpackarr/config.yaml that you will need to edit.
After the config is edited you need to restart the service.
sudo systemctl restart seasonpackarr@$USER.serviceDocker images can be found on the right under the "Packages" section.
See docker-compose.yml for an example.
Make sure you use the correct path you have mapped within the container in the config file. After the first start you will need to adjust the created config file to your needs and start the container again.
You can configure a decent part of the features seasonpackarr provides. I will explain the most important ones here in more detail.
Can be enabled in the config by setting smartMode to true. Works together with smartModeThreshold to determine if
a season pack should get grabbed or not. Here's an example that explains it pretty well:
Let's say you have 8 episodes of a season in your client released by RlsGrpA. You also have 12 episodes of the same
season in your client released by RlsGrpB and there are a total of 12 episodes in that season. If you have smart
mode enabled with a threshold set to 0.75, only the season pack from RlsGrpB will get grabbed, because 8/12 = 0.67
which is below the threshold.
Can be enabled in the config by setting parseTorrentFile to true. This option will make sure that the season pack
folder that gets created by seasonpackarr will always have the correct name. One example that will make the benefit
of this clearer:
- Announce name:
Show.S01.1080p.WEB-DL.DDPA5.1.H.264-RlsGrp - Folder name:
Show.S01.1080p.WEB-DL.DDP5.1.H.264-RlsGrp
Using the announce name would create the wrong folder and would lead to all the files in the torrent being downloaded
again. The issue in the given example is the additional A after DDP which is not present in the folder name. By
using the parsed folder name the files will be hardlinked into the exact folder that is being used in the torrent.
You can take a look at the Webhook section to see what you would need to add in your autobrr filter to make use of this feature.
In this section, you can toggle comparing rules. I will explain each of them in more detail here.
-
skipRepackCompare: When set to
true, the comparer skips checking the repack status of the season pack release against the episodes in your client. The episode in the example will only be accepted as a match by seasonpackarr if you enable this option:- Announce name:
Show.S01.1080p.WEB-DL.DDPA5.1.H.264-RlsGrp - Episode name:
Show.S01E01.1080p.WEB-DL.REPACK.DDPA5.1.H.264-RlsGrp
- Announce name:
-
simplifyHdrCompare: If set to
true, this option simplifies the HDR formatsHDR10,HDR10+, andHDR+to justHDR. This increases the likelihood of matching renamed releases that specify a more advanced HDR format in the announce name than in the episode title:- Announce name:
Show.S01.2160p.WEB-DL.DDPA5.1.DV.HDR10+.H.265-RlsGrp - Episode name:
Show.S01E01.2160p.WEB-DL.DDPA5.1.DV.HDR.H.265-RlsGrp
- Announce name:
Keep in mind, these settings are suggestions based on my own use case so feel free to adjust them according to your specific needs.
smartMode: true
smartModeThreshold: 0.75
parseTorrentFile: true
skipRepackCompare: true
simplifyHdrCompare: falseThese will filter out most unwanted season packs and prevent mismatches, while still making sure that renamed season packs and episodes can get matched.
Support for multiple Sonarr and qBittorrent instances with different pre import directories was added with v0.4.0, so you will need to run multiple instances of seasonpackarr and create multiple filters to achieve the same functionality in lower versions. If you are running v0.4.0 or above you just need to set up your filters according to External Filters. The following is a simple example filter that only allows 1080p season packs to be matched.
To import it into autobrr you need to navigate to Filters and click on the arrow next to + Create Filter to see the
option Import filter. Just paste the content below into the text box that appeared and click on Import.
{
"name": "arr-Seasonpackarr",
"version": "1.0",
"data": {
"enabled": true,
"seasons": "1-99",
"episodes": "0",
"resolutions": [
"1080p",
"1080i"
]
}
}In the General tab you will need to adjust the value of Priority to be set higher than all your TV show filters. For
instance, if your Sonarr filter is set at 10 and a TV filter that sends to qBittorrent is at 15, then you should set
the seasonpackarr filter to at least 16. This ensures that it will execute before the others. It's perfectly fine to
have a cross-seed filter positioned above the seasonpackarr filter.
After adding the filter, you need to head to the External tab of the filter, click on Add new and select Webhook
in the Type field. The Endpoint field should look like this, with host and port taken from your config:
http://host:port/api/pack
HTTP Method needs to be set to POST, Expected HTTP status has to be set to 250 and the Data (JSON) field needs
to look like this:
{
"name": "{{ .TorrentName }}",
"clientname": "default"
}Replace the clientname value, in this case default, with the name you gave your desired qBittorrent client in your
config under the clients section. If you don't specify a clientname in the JSON payload, seasonpackarr will try to
use the default client; if you renamed or removed the default client the request will fail.
I strongly suggest enabling API authentication by providing an API token in the config. The following command will generate a token for you that you can copy and paste into your config:
seasonpackarr gen-tokenAfter you've set the API token in your config, you'll need to either include it in the Endpoint field or pass it
along in the HTTP Request Headers of your autobrr request; if not, the request will be rejected. I recommend using
headers to pass the API token, but I'll explain both options here.
- Header: Edit the
HTTP Request Headersfield and replaceapi_tokenwith the token you set in your config.X-API-Token=api_token - Query Parameter: Append
?apikey=api_tokenat the end of yourEndpointfield and replaceapi_tokenwith the token you've set in your config.http://host:port/api/pack?apikey=api_token
The external filter you just created will be disabled by default. To avoid unwanted downloads, make sure to enable it!
Now, you need to decide whether you want to enable torrent parsing. By activating this feature, seasonpackarr will parse
the torrent file for the season pack folder name to ensure the creation of the correct folder. You can enable this
functionality by setting parseTorrentFile to true in your config file.
If you choose to enable this feature, first follow the instructions in the Webhook section, and then proceed to the qBittorrent section. If you leave this feature disabled, you can skip the Webhook section and go straight to the qBittorrent section.
Warning
If you enable that option you need to make sure that the Webhook action is above the qBittorrent action, otherwise the feature won't work correctly.
Navigate to the Actions tab, click on Add new and change the Action type of the newly added action to Webhook.
The Endpoint field should look like this, with host, port and api_token taken from your config:
http://host:port/api/parse?apikey=api_token
Append the API query parameter ?apikey=api_token only if you have enabled API authentication by providing an API token
in your config.
Finally, complete the Payload (JSON) field as shown below. Ensure that the value of clientname is the same as in the External Filter:
{
"name":"{{ .TorrentName }}",
"torrent":"{{ .TorrentDataRawBytes | js }}",
"clientname": "default"
}Navigate to the Actions tab, click on Add new and change the Action type of the newly added action to qBittorrent.
Depending on whether you intend to only send to qBittorrent or also integrate with Sonarr, you'll need to fill out different fields.
- Only qBittorrent: Fill in the
Save Pathfield with the directory where your torrent data resides, for instance/data/torrents, or theCategoryfield with a qBittorrent category that saves to your desired location. - Sonarr Integration: Fill in the
Categoryfield with the category that Sonarr utilizes for all its downloads, such astv-hdortv-uhd.
Last but not least, under Rules, make sure that Skip Hash Check remains disabled. This precaution prevents torrents
added by seasonpackarr from causing errors in your qBittorrent client when some episodes of a season are missing.
Warning
If you enable that option regardless, you will most likely have to deal with errored torrents, which would require you to manually trigger a recheck on them to fix the issue.
Huge credit goes to upgraderr and specifically @KyleSanderson, whose project provided great functions that I could make use of. Additionally, I would also like to mention @zze0s, who was really helpful regarding any question I had as well as providing me with a lot of the structure this project has now. Credits also go to the TVmaze API for providing comprehensive data on the total number of episodes for a show in a specific season. Last but not least, a big thank you to JetBrains for providing me with free licenses to their great tools, in this case GoLand.