Self-host Plex Prerolls
2026-03-30Scheduled and auto-generated Plex pre-roll lineups
docker-compose up -d- Port
- 8283 (HTTP endpoint for the app: Plex webhook ingestion (/recently-added) and healthcheck (/last-run-within))
nwithan8/plex_prerollsWhat is Plex Prerolls?
Plex Prerolls is a Python-based service for Plex owners who want cinema-style intro videos that rotate over time. On each run (a cron-style schedule taken from its config.yaml) it decides which entries are currently active — always-on lists, date/time ranges that accept wildcards for recurring events, week-of-year and month-of-year schedules, and floating holidays resolved through the Python holidays library — and feeds the matching video paths to Plex. Extra knobs include weighting entries so some play more often, suppressing the always section for specific schedules, randomly picking a subset with count, and expanding directories of files into Plex-visible remote paths with glob patterns. It can also auto-build trailer-like prerolls for newly added library items by reacting to Plex webhooks and gathering trailer and soundtrack assets from YouTube; that feature needs a Plex Pass subscription, a YouTube cookies file for yt-dlp, and hosting the container next to Plex Media Server. Self-hosting is via Docker or the provided docker-compose file, publishing port 8283 for its webhook and healthcheck endpoints. It is Plex-only: the FAQ points Jellyfin and Emby users to those platforms' own intro plugins.
Plex Prerolls alternatives
NeXrollSelf-hosted, open-source preroll manager adding cinema-style preshows to Plex, Jellyfin, and Emby with visual sequences, scheduling, and Radarr/Sonarr trailers.CompareNeXroll with Plex Prerolls
dynamiXdynamiX automates Plex collection pinning by time blocks and seasons, plus manages seasonal pre-roll videos. Self-hosted via Docker or Python with PWA UI on port 1166.ComparedynamiX with Plex Prerolls
trailarrTrailarr is a self-hosted, open-source app that auto-downloads and manages trailers for movie/TV libraries, integrating with Radarr, Sonarr, Plex, Emby, and Jellyfin.Comparetrailarr with Plex Prerolls
Upcoming-Movies-TV-Shows-for-KometaSelf-hosted tool creating Kometa overlays by checking Radarr/Sonarr for upcoming movies and TV shows, downloading trailers or creating placeholders.CompareUpcoming-Movies-TV-Shows-for-Kometa with Plex Prerolls
AutoPlexxAutoPlexx is a self-hosted, open-source Docker Compose stack for a complete Plex Media Server with request handling, library automation, VPN torrent downloads, monitoringCompareAutoPlexx with Plex Prerolls
ytsyncSelf-hosted open-source tool that automatically downloads YouTube videos on a schedule with Plex/Jellyfin integration and Docker deployment.Compareytsync with Plex Prerolls
jellyplex-watchedSelf-hosted, open-source tool that syncs watched history, in-progress playback, and view dates across Plex, Jellyfin, and Emby servers.Comparejellyplex-watched with Plex Prerolls
ChannelTubeSelf-hosted YouTube channel downloader using yt-dlp with scheduled syncs, format options, and Plex/Jellyfin integration.CompareChannelTube with Plex Prerolls
Should you self-host Plex Prerolls?
Plex Prerolls scores 50/100 on selfhost.directory (how scoring works) and ranks #1 of 2 in Plex.
There was no stable release in the past 12 months, so check the repository's recent activity before you rely on it.
Setup is moderate: expect some configuration beyond a single command. An official Docker image is available.
Its closest alternative on selfhost.directory is pasta (44/100, 447 stars). Plex Prerolls scores higher overall. See Plex Prerolls vs pasta side by side.
Features
- Auto-generated preroll videos
- Date range scheduling
- Dry Run Mode
- Floating holiday schedules
- Healthcheck endpoint
- Path Globbing
- Per-schedule override of always entries
- Random subset selection
- Recently-added media prerollsRequires Plex Pass webhooks and a YouTube cookies file for yt-dlp
- Scheduled pre-roll rotation
- Weekly and monthly scheduling
- Weighted selection
How to install Plex Prerolls
Install Plex Prerolls with Docker
docker run -d \
--name=plex_prerolls \
-p 8283:8283 \
-e PUID=1000 \
-e PGID=1000 \
-e TZ=Etc/UTC \
-v /path/to/config:/ \
-v /path/to/logs:/logs \
-v /path/to/preroll/files:/files \
-v /path/to/auto-generated/rolls/temp:/renders \
-v /path/to/auto-generated/rolls/parent:/auto_rolls \
--restart unless-stopped \
nwithan8/plex_prerolls:latest
FAQ
Can this work with Emby?
No — Emby's Cinema Intros plugin has a similar video-list option, but there is currently no way to update that setting through Emby's API, so the process cannot be automated.
Can this work with Jellyfin?
Not directly — the author recommends Jellyfin's own Intros plugin, which already replicates the rule- and schedule-based preroll functionality.
More in Plex
CleanarrCleanarr is a self-hosted, open-source web UI that helps Plex users find and delete duplicate media files and sample files from their Plex libraries.
deleterrDeleterr is a self-hosted, open-source tool that automatically cleans up Plex libraries by deleting unwatched or old content with smart exclusions and a grace period.
KitanaKitana is a self-hosted, open-source web frontend that exposes Plex plugin interfaces via Plex.TV authentication, making them manageable from mobile devices.
OmbiSelf-hosted, open-source media request tool: Plex, Emby and Jellyfin users request movies, TV and music, which get approved and handed to Sonarr or Radarr.
pastaSelf-hosted, browser-based Plex helper to batch-change audio and subtitle tracks for whole TV shows or single episodes, with Docker image and Unraid template.
0 comments