110 lines
4.2 KiB
Markdown
110 lines
4.2 KiB
Markdown
---
|
|
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
|