CinemaTrailers4Jellyfins

Help

Downloads trailers for upcoming and recently released movies not in your library from TMDB/YouTube and stores each one inside its own fake-movie folder, ready to be picked up by a Cinema Mode / trailer pre-roll plugin.

A free TMDB API key is required. Get one here →

TMDB
Your TMDB Read Access Token (JWT) or v3 API key from themoviedb.org/settings/api.

Trailer Languages

Only download trailers in the selected languages. Leave everything unchecked to allow all languages.

Trailer Sources

Choose which TMDB lists to pull trailers from. Enable multiple for more variety.

Movies currently in theatres. Refreshes weekly on TMDB.
Movies coming soon to theatres. Great for seeing what's on the horizon.
Most popular movies on TMDB right now, filtered by the date range below.
Highest rated movies on TMDB, filtered by the date range below.

Date Range
Applies to all sources. "Now Playing" and "Upcoming" already have tight date windows set by TMDB, but this provides an additional filter.

Download Settings
Where the fake-movie/trailer folders are created. Add this as a Jellyfin Movies library and scan it so a Cinema Mode / trailer pre-roll plugin can use the trailers.
Maximum number of trailers to download each time the task runs. Default: 20.
How many pages to fetch from each TMDB source (20 movies per page). Default: 3.
Trailers for movies you already own won't be downloaded.
If a folder already exists for a movie, don't re-download it.

Trailer Rotation

Keep your trailer library fresh by automatically removing the oldest entries each time the download task runs.

Maximum number of trailer folders to keep on disk at once. When this limit is exceeded, the oldest are deleted first to make room for new downloads. Set to 0 for unlimited. Default: 50.

Cinema Mode Integration

When enabled, this plugin registers as an IIntroProvider and injects downloaded trailers before movies — compatible with Jellyfin's built-in cinema mode support and clients like Wholphin. The output folder must be added as a Jellyfin Movies library and scanned before trailers appear.

Number of trailers to play before each movie. Set to 0 to disable. Default: 1.
Only pick trailers whose genre overlaps with the movie you are watching. Falls back to any trailer if no match is found.
Never show a trailer rated higher than the movie being played. Falls back to any trailer if no match is found.
Cycle through all available trailers before playing any again. Resets automatically once every trailer has been shown. Default: on.

Advanced
Full path to yt-dlp. Required for 1080p quality. Also needs ffmpeg on the system PATH. Leave blank to use the built-in downloader (720p max, zero extra tools).