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.

Movie Trailer Sources

Choose which TMDB lists to pull movie 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.

TV Show Trailer Sources

Choose which TMDB lists to pull TV show trailers from. Enable multiple for more variety. Has no effect if "Max TV show trailers per run" below is set to 0.

TV shows airing today.
TV shows airing in the next 7 days.
Most popular TV shows on TMDB right now, filtered by the date range below.
Highest rated TV shows on TMDB, filtered by the date range below.

Date Range
Applies to all sources (movie release date / TV show first-air date). "Now Playing", "Upcoming", "Airing Today" and "On The Air" 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 movie trailers to download each time the task runs. Set to 0 to not download any movie trailers. Default: 20.
Maximum number of TV show trailers to download each time the task runs. Set to 0 to not download any TV show trailers. Default: 0.
How many pages to fetch from each TMDB source (20 results per page). Default: 3.
Trailers for movies and TV shows you already own won't be downloaded.
If a folder already exists for a movie or TV show, 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.
Only plays before the first episode a user watches each day — if you watch several episodes back-to-back, only the first gets trailers.

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