Description
Plex supporte nativement les « pre-rolls » : une vidéo qui se lance automatiquement avant chaque film ou épisode. En pratique, cette fonctionnalité est cachée dans l'UI Plex, et la gestion de plusieurs pre-rolls (selon la bibliothèque, l'utilisateur, l'heure) devient vite pénible. Plex Prerolls ajoute une couche d'orchestration.
L'application expose une web UI qui liste les pre-rolls disponibles, permet d'en faire l'upload, de les router par bibliothèque (Films, Séries, Kids, Concert) ou par profil utilisateur, et d'auditer ce qui a été lu. Idéal pour un cinéma maison qui veut un jingle familial, un film d'avertissement avant un contenu mature, ou une animation de marque avant chaque séance.
Points forts : UI dédiée, API Plex propre, support multi-prerolls avec rotation. Limites : projet très jeune (3 ⭐), pas d'éditeur vidéo intégré — il faut produire les clips ailleurs.
Installation
Via Docker (recommandé)
# docker-compose.yml
version: "3.8"
services:
plex-prerolls:
image: ghcr.io/plex-prerolls/plex-prerolls:latest
container_name: plex-prerolls
restart: unless-stopped
ports:
- "7777:7777"
environment:
- PLEX_URL=http://plex.local:32400
- PLEX_TOKEN=*** - TZ=Europe/Paris
volumes:
- ./prerolls:/prerolls
- ./config:/app/config
Installation manuelle
git clone https://github.com/plex-prerolls/plex-prerolls cd plex-prerolls pip install -r requirements.txt flask run --host 0.0.0.0 --port 7777
Configuration
- Connexion Plex : URL + X-Plex-Token (compte admin).
- Upload : drag&drop de fichiers
.mp4/.movdans l'UI, validation codec/HDR automatique. - Routage : affecter un pre-roll à une bibliothèque, à un groupe d'utilisateurs, ou à un horaire.
- Rotation : choisir l'ordre de lecture (aléatoire, séquentiel, pondéré).
- Désactivation : prévoir un bouton pour désactiver temporairement (soirée spécifique).
Alternatives
- Plex Built-in — Possible via
Settings → Extras → Pre-roll video, mais mono-fichier et sans routing. - Muximux / Organizr — Aucun rapport, c'est juste pour les dashboards.
- DIY via cron + Plex API — Faisable mais pénible.
- Traîter via ffmpeg côté serveur — Concaténation manuelle, lourd.
Sécurité
- Le token Plex donne accès admin complet. Variable d'environnement, jamais en clair.
- Placer derrière reverse proxy authentifié si exposition WAN.
- Limiter l'upload à un dossier précis (
:rwminimal, pas le dossier média entier). - Auditer régulièrement les pre-rolls uploadés (vigilance sur du contenu inapproprié en mode cinéma maison familial).
Ressources
- Repository : https://github.com/plex-prerolls/plex-prerolls
- Documentation Plex officielle : https://support.plex.tv/articles/202298903/
- FFmpeg (production clips) : https://ffmpeg.org/

