selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

Codeberg
Plex Prerolls logo

Self-host Plex Prerolls

2026-03-30

Scheduled and auto-generated Plex pre-roll lineups

ReleaseOpen Source
Docker ComposeCompose file & guide
docker-compose up -d
Updated7 months ago
Setup difficultyModerate
Port
8283 (HTTP endpoint for the app: Plex webhook ingestion (/recently-added) and healthcheck (/last-run-within))
Docker
nwithan8/plex_prerolls

What 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

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

How to configure Plex Prerolls

  • PUIDUID of user to run as
  • PGIDGID of user to run as
  • TZTimezone to use for cron schedule
  • scheduleCron expression controlling how often the preroll list is rebuilt (in the run section of config.yaml)
  • dry_runfalseRun without applying changes to Plex

    values: true/false

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.

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…