---
title: Plex Prerolls
created: 2026-06-07
updated: 2026-06-07
type: app
tags: [catalogue, media-streaming, plex, preroll, video, branding]
confidence: medium
contested: false
sources:
  - https://selfh.st/apps/?tag=Media+Streaming
  - https://github.com/.../plex-prerolls
---

# 🎬 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é)

```yaml
# 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

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