/Backdroppr

An automated system to download trailers.

Primary LanguagePython

Backdroppr

Backdroppr is a tool written in Python that is used to import movies and shows from Radarr and Sonar, download appropriate trailers, remove borders and adding them to your library. This is a fork of https://github.com/ShiniGandhi/Backdroppr.

Features

  • Automatically select the highest resolution available on YouTube (while trying to avoid 360 videos).
  • Download to multiple directories.
  • Automatically detect and crop black borders.
  • Fallback to manual search if no trailer exists in TheMovieDB.
  • Video length filtering to avoid short or long videos.
  • Automatic subtitle download.
  • Automatic intro, outro and intermission skipping in trailers.
  • Option to run the script once, if no sleep time was set.

Known Bugs

  • If no trailer was found on TheMovieDB, the script will manually search for one, but will keep searching again even if it already found and downloaded one. It won't redownload it though.
  • Issue when a video with 5.1 audio is found.
  • Skips the rest of the trailers in TheMovieDB if a link is dead.

Requirements

Docker

How to Install

Backdropper can be used as a standalone program or as a docker container. This guide assumes you already have Docker (if used), Radarr, and Sonarr installed and set up.

Configuration

These variables are used to configure the runtime options of Backdroppr. At least some of them are required to be configured for Backdroppr to run.

Name Description Example Required
radarr_api API key received from Radarr
if not set: disables Radarr.		 4556edb99d442d83b88c6809c42fc78d Yes
radarr_host IP and port in-which Radarr runs
if not set: disables Radarr.		 http://172.0.0.1:7878 Yes
sonarr_api API key received from Sonarr
if not set: disables Sonarr.		 01bb1ebca84e8939f112c414b98c70f7 Yes
sonarr_host IP and port in-which Sonarr runs
if not set: disables Sonarr.		 http://172.0.0.1:8989 Yes
tmdb_api API key from themoviedb 96dd72f9176e688b8967829911a184fb Yes
output_dirs The directory inside the tv show/movie's directory that trailers will be downloaded to.
Multiple values can be set using a comma (,).		 trailers or trailers,backdrops Yes
sleep_time Time in hours that the script will wait until running again.
Can be set to minutes using a decimal point.
If not set, the script will only run once (but make sure you disable restart: always if you do this.		 3 or 0.5 No
length_range Time range in seconds in which the trailer must be. Separated with a comma ,
Optional, but I do recommend setting it, as some entries may have extremely long or short videos.		 30,300 No
filetype File extension used in target file.
Defaults to mp4 (h264) if left empty.
I recommend using webm since it uses vp9, which, while slower to encode is more efficient.		 webm - vp9 codec
mp4 - h264 codec		 No
skip_intros Uses SponsorBlock to detect intros and other junk in the video and skips it.
Doesn't always work. If you're experiencing any issues just disable it for a while.
Defaults to False if not set.		 True or False No
thread_count Number of threads to use when transcoding. Set to all threads if not set. 8 No
subs Whether or not subtitles will be downloaded
vtt if webm and ass if mp4.
Defaults to False if not set.		 True or False No
moviepath Override the path set inside Radarr if not the same as the script's
Useful if Radarr is running inside a container or on a different machine.		 "/vault/Media/Movies" No
tvpath Override the path set inside Sonarr if not the same as the script's
Useful if Sonarr is running inside a container or on a different machine.		 "/vault/Media/TV Shows" No

docker-compose.yml

services:
  backdroppr:
    container_name: backdroppr
    image: voc0der/backdroppr:latest
    ### Optional: Uncomment case-sensitive environment variables to configure backdroppr ###
    environment:
      - RADARR_API="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      - RADARR_HOST=http://localhost:7878
      - SONARR_API="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      - SONARR_HOST=http://localhost:8989
      - TMDB_API=""xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx""
      ### Uncomment if needed ###
      # - OUTPUT_DIRS="trailers"
      # - SLEEP_TIME=3
      # - LENGTH_RANGE="30,300"
      # - FILETYPE="webm"
      # - SKIP_INTROS=True
      # - THREAD_COUNT="8"
      # - SUBS=True
      # - MOVIEPATH="/vault/Media/Movies"
      # - TVPATH="/vault/Media/TV Shows"
    restart: always
    volumes:
      # Uncomment only if using config file:
      #- ./config:/config
      - /vault/Media/TV Shows:/tv
      - /vault/Media/Movies:/movies

Docker Secrets

You may append _FILE to the end of the following variables: RADARR_API, SONARR_API, TMDB_API and provide a valid file path.

Legacy

Alternatively to setting these variables in the environment, when using configuration file, Backdroppr will read config.yaml in the configuration folder to get these runtime parameters:

config.yaml

radarr_api: "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
radarr_host: "http://172.0.0.1:7878"
sonarr_api: "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
sonarr_host: "http://172.0.0.1:8989"
tmdb_api: "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
output_dirs: "trailers"
sleep_time: 3
length_range: "30,300"
### Optional ###
filetype: "webm"
skip_intros: True
thread_count: 8
subs: True
### Uncomment if needed ###
moviepath: "/vault/Media/Movies"
tvpath: "/vault/Media/TV Shows"

Standalone

  1. Clone the repository: git clone https://github.com/voc0der/Backdroppr.git.
  2. Navigate to the repo's directory: cd Backdroppr.
  3. Install python and ffmpeg: sudo apt install python3 ffmpeg -y.
  4. Install python requirements: pip install -r requirements.txt.
  5. Edit the configuration file.
  6. Run the program python3 main.py.

Docker

  1. Clone the repository: git clone https://github.com/voc0der/Backdroppr.git.
  2. Navigate to the repo's directory: cd Backdroppr.
  3. Build the image: docker build -t voc0der/backdroppr:latest .
  4. Edit the docker-compose file.
  5. Edit the configuration file.
  6. Start the container docker-compose up -d.