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.

• 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.

• 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.

• Vimeo fallback.
• Customizeable filenames.
• Codec selection (as well as hardware acceleration).
• Customizeable bitrates.

(note: currently only works in Linux)

• Python3
• ffmpeg
• Radarr
• Sonarr

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.

1. Clone the repository: git clone https://github.com/ShiniGandhi/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.

1. Clone the repository: git clone https://github.com/ShiniGandhi/Backdroppr.git.
2. Navigate to the repo's directory: cd Backdroppr.
3. Build the image: docker build -t shinigandhi/backdroppr:latest . (you can skip if you want to use my image)
4. Edit the docker-compose file.
5. Edit the configuration file.
6. Start the container docker-compose up -d.

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.

When using configuration file, Backdroppr will read config.yaml in the configuration folder to get these runtime parameters:

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"

version: "3"
services:
  backdroppr:
    container_name: backdroppr
    image: shinigandhi/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""
    #   - OUTPUT_DIRS="trailers"
    #   - SLEEP_TIME=3
    #   - LENGTH_RANGE="30,300"
    #   - FILETYPE="webm"
    #   - SKIP_INTROS=True
    #   - THREAD_COUNT="8"
    #   - SUBS=True
      ### Uncomment if needed ###
      # - MOVIEPATH="/vault/Media/Movies"
      # - TVPATH="/vault/Media/TV Shows"
    restart: always
    volumes:
      - ./config:/config #The config file location, Optional if using env variables
      - /vault/Media/TV Shows:/tv #TV show directory re-routing
      - /vault/Media/Movies:/movies #Movie directory re-routing

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