Backdropper 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.
- Clone the repository:
git clone https://github.com/ShiniGandhi/Backdroppr.git. - Navigate to the repo's directory:
cd Backdroppr. - Install python and ffmpeg:
sudo apt install python3 ffmpeg -y. - Install python requirements:
pip install -r requirements.txt. - Edit the configuration file.
- Run the program
python3 main.py.
- Clone the repository:
git clone https://github.com/ShiniGandhi/Backdroppr.git. - Navigate to the repo's directory:
cd Backdroppr. - Build the image:
docker build -t shinigandhi/backdroppr:latest .(you can skip if you want to use my image) - Edit the docker-compose file.
- Edit the configuration file.
- Start the container
docker-compose up -d.
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"
| 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 Falase |
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 Falase |
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 |
services:
backdroppr:
image: shinigandhi/backdroppr:latest
restart: always #Disable this if you're only running the script once
volumes:
- ./config:/config #Where the config file will be located
- /vault/Media/TV Shows:/tv #TV show directory re-routing
- /vault/Media/Movies:/movies #Movie directory re-routing
