🎬 Plex Prerolls

Générateur et gestionnaire de vidéos pre-roll pour app-plex : insère automatiquement un clip (pub, jingle, message) avant chaque lecture.

📋 Informations Générales

Attribut	Valeur
Nom	Plex Prerolls
Slug	app-plex-prerolls
Description	Outil de gestion centralisée des vidéos pre-roll Plex (cinéma maison, jingle familial, etc.)
Site officiel	https://plex-prerolls.app/
Repository	https://github.com/plex-prerolls/plex-prerolls
Stars	3 ⭐
Licence	MIT
Langage principal	Python (Flask)
Catégorie	Media Streaming
Tags	[catalogue, media-streaming, plex, preroll, video, branding]

📝 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/.mov dans 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 (:rw minimal, 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/

🔗 Pages Liées

cat-media-streaming (catégorie parente)
app-plex — Serveur média cible
app-jellyfin — Serveur média alternatif
app-traefik — Reverse proxy HTTPS
app-authentik — SSO et forward auth
securisation-home-lab — Bonnes pratiques
recettes-docker-compose — Templates

4.2 KiB Raw Blame History