Separate Theme Video for Trailers

[WDPR4100 16]

@radeon

Feature Request: Separate Theme Video for Trailers (e.g., theme-trailer.mp4)

Description

Currently, Emby supports a single theme.mp4 (or theme.mkv) file inside a movie or series folder, which plays background music or a backdrop video when viewing the item's details page.

I would love to see an official plugin or native support for a dedicated Trailer Theme Video. This would allow us to separate standard background ambient videos from actual movie trailers, playing a specific trailer intro or preview automatically when browsing a movie.

Proposed Structure Example

Ideally, the system could recognize a specific naming convention or a dedicated subfolder structure like this:

Plaintext

Avatar (2009)/
├── Backdrops/
│   └── theme.mp4          <-- Plays as the standard background video
├── Trailers/
│   └── theme.mp4          <-- Plays specifically when highlighting or previewing trailers
├── Avatar.mkv
└── poster.jpg

[Luke 42710]

@WDPR4100

[WDPR4100 16]

Présentation Générale

Ce script est un module d'automatisation à haute performance conçu pour enrichir visuellement l'interface de votre serveur local Emby. En explorant l'intégralité d'un disque racine (comme V:\), il identifie automatiquement le premier épisode de chaque série pour y extraire, via FFmpeg, deux fichiers d'extras indispensables :

• Un arrière-plan animé stocké dans un sous-dossier backdrops.

• Une bande-annonce accessible via un sous-dossier trailers.

Exemple de la structure cible générée :

Avatar (2009) /
├── backdrops /
│   └── theme.mkv       <-- Vidéo d'ambiance lue en arrière-plan
├── trailers /
│   └── theme.mkv       <-- Extrait vidéo activé lors de l'aperçu du trailer
├── Avatar.mkv
└── poster.jpg

Fonctionnalités Clés

• Ciblage intelligent de la source Pour garantir la pertinence de l'extrait, le script privilégie le premier épisode de la première saison en filtrant les fichiers .mkv contenant les mentions S01, Season 01 ou Saison 1. Si la structure du dossier est différente, il sélectionne par sécurité le tout premier fichier MKV global qu'il trouve.

• Timing calibré pour les génériques (Openings) L'extraction est configurée chirurgicalement pour capturer l'ouverture de vos séries et animés :

• $StartOffset = 5 : Un décalage initial de 5 secondes permet d'esquiver proprement les écrans noirs, logos d'éditeurs silencieux ou avertissements légaux afin de démarrer la vidéo directement au début de l'action.

• $Duration = 90 : Une capture stricte de 90 secondes (1 min 30) est appliquée, correspondant exactement à la durée standard universelle d'un opening.

• Duplication instantanée et sans perte (-c copy) L'atout technique majeur du script réside dans l'absence totale de réencodage. Grâce à l'argument -c copy de FFmpeg, les flux vidéo et audio d'origine sont copiés bit à bit.

• Résultat : L'opération prend moins d'une seconde par fichier, conserve 100 % de la qualité d'image initiale et intègre parfaitement le son d'origine dans le conteneur final theme.mkv.

Logique de Traitement et Flux d'Analyse

Pour chaque dossier de série détecté, le script applique la routine d'optimisation suivante :

• Étape 1 : Diagnostic de présence Le script vérifie la présence simultanée de trailers/theme.mkv et backdrops/theme.mkv. Si les deux existent, la série est immédiatement ignorée pour passer à la suite, garantissant un gain de temps absolu.

• Étape 2 : Traitement du dossier /trailers/ Si le répertoire ou le fichier theme.mkv est manquant, le script génère le dossier et lance l'extraction de la bande-annonce via FFmpeg.

• Étape 3 : Traitement du dossier /backdrops/ Si le répertoire ou le fichier theme.mkv est absent, le script crée le dossier et extrait l'arrière-plan vidéo.

Sécurités et Propreté du Système

• Immunité contre la redondance : L'utilisation de contrôles d'existence rigoureux (Test-Path) protège vos médias existants contre toute réécriture accidentelle ou exécution inutile de FFmpeg.

• Console épurée (Zéro pollution) : La création des répertoires s'effectue de manière totalement transparente à l'aide de New-Item -ItemType Directory. Les flux de messages système superflus ou d'erreurs secondaires sont masqués (| Out-Null et 2>$null), laissant votre console propre et lisible, focalisée uniquement sur la progression du traitement.

THEME.ps1