Missing Trailer Downloader for Plex (MTDP)

I initially bought a Plex Pass because I wanted to have Trailers for my movies and TV Shows.
For a minority of titles, Plex doesn't seem to have trailers however. Especially lesser known and foreign titles.

This script will fill those gaps.

Main Features

• Detects Missing Trailers: Scans your Plex libraries for items that lack trailers. (either Plex Pass or local)
• Filters out specified Genres: You may not want trailers for concerts or 3 minute shorts..
• Automatic Downloading: Uses YT-DLP to fetch the best available trailer from Youtube.
• Organized Storage: Trailers are saved according to Plex guidelines for both Movies and TV Shows.
• Refreshes Metadata: Refreshes metadata of items with new trailer. (Necessary for Plex to 'detect' them)
• Real-time New Item Detection (optional): Watches your Plex server and checks newly added movies and shows the moment they appear.
• webUI: Change settings, keep track and trigger manual downloads

🖥️ Web UI

MTDP is designed to run headless on schedule so it keeps your library updated with trailers.
However you can also access the webUI on http://localhost:2121/
On the Dashboard you'll find general statistics, an overview of the latest downloaded trailers, and a yt-dlp updater.
You can edit your config in the Settings page and check the Log.
The Movies and TV Shows pages allow you to apply filters for missing trailers. Local trailers can be filtered by resolution.
Open a detail page to see the current available trailer or trigger a manual search.

!example

🐋 Installation via Docker

Step 1: Install Docker

1. Download Docker Desktop from docker.com
2. Install and start Docker Desktop on your computer
3. Verify installation: Open a terminal/command prompt and type docker --version - you should see a version number

Step 2: Create Docker Compose File

1. Create a new folder for MTDP on your computer (e.g., C:\MTDP or /home/user/MTDP)
2. Create a new file called docker-compose.yml in that folder
3. Copy and paste this content into the file:

version: '3.8'

services:
  mtdp:
    image: netplexflix/mtdp:latest
    container_name: mtdp
    environment:
      - PUID=1000  # Change to your user ID
      - PGID=1000  # Change to your group ID
      - TZ=America/New_York  # Change to your timezone
      - SCHEDULE_HOURS=24  # Run every X hours (default: 24)
      # - CRON=0 2 * * *  # Optional: cron schedule (overrides SCHEDULE_HOURS)
    ports:
      - "2121:2121"  # Web UI
    volumes:
      - ./config:/config  # Mount your config directory
      - ./logs:/app/Logs  # Optional: persist logs
      - ./cookies:/cookies  # Optional: location of your cookie file
      - /path/to/media:/media  # Mount your media directory (same as Plex sees it)
    restart: unless-stopped

1. Update the timezone in the TZ environment variable to match your location (e.g.: America/New_York, Europe/London, Asia/Tokyo)
2. Update PUID/PGID to match your system user (optional - defaults to 1000:1000)
3. Optional: Use a CRON schedule instead of SCHEDULE_HOURS for more precise timing. Uncomment the CRON line and set a cron expression (e.g., 0 2 * * * for daily at 2am). When CRON is set, it overrides SCHEDULE_HOURS. Uses standard 5-field cron syntax: minute hour day month weekday.

Step 3: Update Media Paths

• You must update the media paths in the existing docker-compose.yml file.
• The media path in the container (/media) must match how Plex sees the files
• Example: On thehost system your Movies are at /mnt/storage/movies Plex sees them at: /media/movies The mount:

volumes:
  - /mnt/storage:/media

[!IMPORTANT] If Plex returns Windows volumes, e.g. P:\movies then remove the colon and use forward slash.
example: - P:\Movies:/P/Movies

Step 4: Create your config

• Create a config directory
• Download config.example.yml, rename it to config.yml and save it in your config folder
• Configure your settings. See ⚙️ Configuration

Step 5: Pull the image

1. Open a terminal/command prompt in your MTDP folder
2. Type this command and press Enter:

   docker-compose pull
   

Step 6: Run MTDP

1. Type this command and press Enter:

   docker-compose up -d
   

UNRAID

Missing Trailer Downloader for Plex is available on the Unraid Community Apps store as MTDP. Click install and apply the default template.

⚙️ Configuration

Edit the config.yml file to set your Plex details and desired variables:

📋 General Settings

🎬 Trailer Settings

🔧 Advanced Settings

⬆️ Upgrading low-resolution trailers

By default (UPGRADE_TRAILERS: 'off') an item that already has a trailer is left untouched. When enabled, MTDP also re-checks existing trailers and, if one is below TRAILER_RESOLUTION_MIN, attempts to downloads a higher-resolution replacement.

Notes:

• 'local_plexpass' requires CHECK_PLEX_PASS_TRAILERS: true, since Plex Pass trailers are only visible through Plex's extras.
• Plex Pass trailers are sourced from Internet Video Archive and generally top out at ~1080p. If you set TRAILER_RESOLUTION_MIN higher than what's available, MTDP makes a single download attempt per item and then records it so it won't retry every run. Raising TRAILER_RESOLUTION_MIN later re-arms the attempt.
• The resolution shown under each poster (and on the detail page) reflects the maximum available resolution for Plex Pass trailers.
• If you use labels (USE_LABELS: true) and change UPGRADE_TRAILERS or TRAILER_RESOLUTION_MIN by editing config.yml directly (not via the Web UI), click "Remove all MTDfP labels" once so previously-processed items get re-evaluated. Saving these settings through the Web UI does this automatically.

📚 Library Configuration

The script supports multiple libraries for both Movies and TV Shows. You can configure multiple libraries with individual genre skip lists.

Multiple Libraries with Genre Filtering

# TV Libraries Configuration
# Configure multiple TV show libraries with individual genre skip lists
# Each library can have different genres_to_skip settings
TV_LIBRARIES:
  - name: 'TV Shows'
    genres_to_skip:
      - 'Talk Show'
      - 'Stand-Up'
      - 'News'
  - name: 'Anime TV'
    genres_to_skip:
      - 'Talk Show'
      - 'Stand-Up'
      - 'News'
      - 'Reality'
  - name: 'Documentaries'
    genres_to_skip:
      - 'Talk Show'
      - 'Stand-Up'

# Movie Libraries Configuration
# Configure multiple movie libraries with individual genre skip lists
# Each library can have different genres_to_skip settings
MOVIE_LIBRARIES:
  - name: 'Movies'
    genres_to_skip:
      - 'Short'
      - 'Stand-Up'
      - 'Concert'
  - name: 'Anime Movies'
    genres_to_skip:
      - 'Short'
      - 'Stand-Up'
      - 'Concert'
  - name: 'Documentaries'
    genres_to_skip:
      - 'Short'
      - 'Stand-Up'

Multiple Libraries without Genre Filtering

# TV Libraries Configuration
# Configure multiple TV show libraries
# Each library will process all genres (no filtering)
TV_LIBRARIES:
  - name: 'TV Shows'
  - name: 'Kids TV Shows'

# Movie Libraries Configuration
# Configure multiple movie libraries
# Each library will process all genres (no filtering)
MOVIE_LIBRARIES:
  - name: 'Movies'
  - name: 'Kids Movies'

🔔 New Item Detection (real-time)

By default MTDP only checks for missing trailers on its schedule. With New Item Detection enabled, MTDP also listens to your Plex server in real time and runs a trailer check for just that item the moment something new is added — so a freshly added movie gets its trailer within a minute or two instead of waiting for the next scheduled scan.

[!TIP] If you'd rather rely entirely on real-time detection, set Schedule Type to Disabled in Settings. MTDP will then never run a full scan on its own (no startup run, no timed runs) — it only checks items as they're added, plus whatever you trigger with Run Now. The two features are independent, so any mix works: a schedule with detection off, detection with the schedule disabled, or both together.

🍪 Using browser cookies for yt-dlp

In case you need to use your browser's cookies, you can pass them along to yt-dlp.
To extract your cookies in Netscape format, you can use an extension:

• Firefox
• Chrome
  Extract the cookies you need and rename the file cookies.txt

For Docker Users:

Add the path to the folder containing your cookies.txt to your docker-compose.yml under volumes::

      - /path/to/cookies:/cookies

For Local Installation

1. Create a cookies folder in the same directory as the MTDP script
2. Export your browser cookies to cookies.txt within this new subfolder

🚀 Usage - Running the Script

Open a Terminal in your script directory and launch the script with:

python MTDfP.py

You’ll be prompted to choose:

• 1: Run Movie library.
• 2: Run TV shows library.
• 3: Scan both consecutively.

Alternatively, pre-set your preferred method in config.yml (LAUNCH_METHOD field) to bypass selection.

[!TIP] Windows users can create a batch file to quickly launch the script.
Type "[path to your python.exe]" "[path to the script]" -r pause" into a text editor

For example:

"C:\Users\User1\AppData\Local\Programs\Python\Python311\python.exe" "P:\Scripts\Missing Trailer Downloader for Plex\MTDfP.py" -r
pause

Save as a .bat file. You can now double click this batch file to directly launch the script.
You can also use this batch file to schedule the script to run daily/weekly/etc.

🤝

❤️ Support the Project

If you like this project, please ⭐ star the repository and share it with the community!