Plex Just-In-Time

This script attempts to download episodes that are likely going to be watched by plex users in the near future.

Requirements

It specifically requires a setup that utilises:

• Tautulli to get watch history and (optionally) send notifications
• Sonarr to manage episode files/indexers (v4)
• SABnzbd to manage downloads

Installation

• Clone the repo.
• Run pip install -r requirements.txt. Important: This installs code from a personal repo as a stopgap. See notes below for details.
• Copy config.json.example to config.json and updated values as below.
• Run via cron.

Options

• Exclude URL_BASE from Tautulli/Sonarr/SABnzbd if not used.
• Set API keys as appropriate.
• Use cache_time within sonarr to set how long series IDs will be cached. Default is 6 hours.
• Use search_cache to specify how often a file can be searched for across executions. This does not affect SABnzbd queue adjustment.
• Use notifier to specify a Tautulli notification agent if you want to send notifications via Tautulli when an episode is queued. Remove this entry if you don't want to send notifications.
• Set days_to_check to the number of days of viewing history you'd like to process. 2 is a safe number if you're running the script once a day.
• Set episodes_to_check to how many future episodes should be checked/downloaded. eg. If set to 3 and S01E01 is played then episodes 2, 3, and 4 will be checked. This number is entirely going to depend on your plex activity, download speed etc.
• Set check_overflow to how many extra episodes on top of episodes_to_check can be checked if the currently queued episodes would run out before the next script execution.
• Set skip_specials to either true or false depending on whether they should be considered. This can be advantageous if the coverage or accuracy of specials on your provider is subpar.
• Set exec_frequency to how often (in minutes) the script is going to run. This is used alongside check_overflow to check extra episodes if the currently queued episodes would be watched before the next script execution.
• Set uptime_url to report successful script executions to a push based uptime monitoring service like Healthcheacks.io or Uptime Kuma.

Running

Start with -v to see generally what the script is doing -vv if there's an issue. Issues that require your attention will be raised as WARNING+

Notes

• The script queries Sonarr for all series when first running. On larger setups this can take a few seconds. Timing of this query is included in -vv to help inform run frequency and cache decisions.