Retour aux outils
Photos / MédiasIntermédiaireOpen sourceAuto-hébergeable

Plex Prerolls

Générateur et gestionnaire de vidéos pre-roll pour [[app-plex]] : insère automatiquement un clip (pu

MAJ 2026-06-14
Plex Prerolls
Site officiel Code source★ 0

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 ajou

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/