-

La gestion d’un serveur multimédia requiert une configuration minutieuse pour garantir une diffusion fluide des flux vidéo et une restitution fidèle de l’image. Bien que Jellyfin soit une solution open-source performante lorsqu’elle est déployée via un conteneur Docker, certaines limitations liées à la charge du serveur lors du transcodage et à la prise en charge des formats HDR (High Dynamic Range) par le client natif peuvent altérer l’expérience de visionnage. Cet article détaille les procédures techniques permettant d’activer l’accélération matérielle (GPU) sur votre instance Jellyfin et de configurer des lecteurs tiers avancés, tels que Kodi ou VLC, afin de contourner ces limitations et d’exploiter pleinement les capacités de votre infrastructure matérielle.

💡 Comprendre les mécanismes de lecture : Transcodage et Remultiplexage

Lorsqu’un client (comme une télévision connectée) requête une vidéo auprès du serveur Jellyfin, il transmet également ses capacités de décodage. Le serveur analyse le fichier source et détermine l’action appropriée :

La lecture directe (Direct Play) : Le client prend en charge l’ensemble des codecs (audio et vidéo) ainsi que le format du conteneur. Le fichier est transmis tel quel, sans solliciter les ressources du serveur.
Le remultiplexage (Remuxing) : Le client supporte les codecs audio et vidéo, mais pas le conteneur (par exemple, il lit le MP4 mais pas le MKV en raison de la gestion des sous-titres). Le serveur réorganise l’encapsulation du fichier à la volée. Cette opération consomme très peu de ressources CPU.
Le transcodage (Transcoding) : Le client est incapable de lire le format compressé (ex: H.265/HEVC). Le serveur doit alors décompresser le flux et le recompresser dans un format compatible avant de l’envoyer. C’est l’opération la plus lourde, susceptible de saturer le processeur central (CPU) si plusieurs flux sont traités simultanément.

⚙️ Configuration de l’accélération matérielle GPU sous Docker

Pour éviter de surcharger le processeur central lors d’un transcodage inévitable, il est impératif de déléguer cette tâche au processeur graphique (GPU) ou à la puce graphique intégrée (iGPU, courante sur les mini-PC Intel ou AMD).

Accédez à l’interface de gestion de vos conteneurs (par exemple, Portainer).
Éditez le fichier de configuration docker-compose.yml (ou la Stack correspondante) de votre instance Jellyfin.
Ajoutez la directive permettant de mapper le périphérique matériel de l’hôte vers le conteneur. Pour les iGPU standards, il convient généralement d’ajouter la ligne exposant la carte graphique (ex: /dev/dri:/dev/dri sous la section devices).
Sauvegardez la configuration et redéployez le conteneur Jellyfin pour appliquer les modifications.

🛠️ Paramétrage du décodage matériel dans l’interface Jellyfin

Une fois le matériel exposé au conteneur, il faut indiquer à l’application Jellyfin comment l’utiliser.

Connectez-vous à l’interface web de Jellyfin avec un compte administrateur.
Naviguez dans le Tableau de bord (Dashboard), puis sélectionnez l’onglet Lecture (Playback).
Dans la section Transcodage, sélectionnez votre type d’accélération matérielle dans le menu déroulant (par exemple, Intel QuickSync, AMD AMF, ou VAAPI selon votre architecture).
Sélection des codecs pris en charge : Cochez uniquement les formats de décodage que votre puce graphique est physiquement capable de traiter (ex: HEVC/H.265). Il est recommandé de vérifier les spécifications de votre processeur (via une documentation technique ou un outil d’intelligence artificielle) pour éviter de cocher des formats non supportés, comme l’AV1 sur des puces d’ancienne génération, ce qui provoquerait des erreurs de lecture.
Enregistrez les paramètres en bas de page et redémarrez le serveur Jellyfin.

📊 Vérification des données de lecture et diagnostic

Pour valider l’efficacité de vos configurations, Jellyfin intègre un outil de diagnostic en temps réel :

Lancez la lecture d’une vidéo depuis l’interface web.
Cliquez sur l’icône en forme de roue crantée (Paramètres du lecteur) située dans la barre de contrôle.
Sélectionnez Données de lecture (Playback Info).
Une fenêtre superposée s’affiche, indiquant la méthode de diffusion en cours (ex: « Lecture directe » ou « Transcodage »), les codecs vidéo (ex: HEVC) et audio (ex: AAC) utilisés, ainsi que la cause du transcodage le cas échéant.

🚀 Intégration de Kodi comme client Jellyfin optimisé

Le client officiel Jellyfin peut présenter des défaillances lors de la lecture de contenus HDR10 ou Dolby Vision, affichant une image terne sur les téléviseurs compatibles. L’utilisation du lecteur Kodi, reconnu pour sa robustesse, offre une alternative performante tout en conservant la gestion centralisée du serveur.

Installez l’application Kodi sur votre appareil (via le store d’applications de votre Android TV, par exemple).
Dans Kodi, naviguez vers Système > Système > Extensions (Add-ons) et activez l’option Sources inconnues.
Retournez dans les paramètres, ouvrez le Gestionnaire de fichiers et choisissez Ajouter une source. Saisissez l’URL du dépôt officiel de l’extension Jellyfin pour Kodi et nommez-la.
Allez dans le menu Extensions > Installer depuis un fichier Zip, et sélectionnez la source fraîchement ajoutée pour installer le dépôt.
Sélectionnez ensuite Installer depuis un dépôt > Kodi Jellyfin Addons > Extensions Vidéos.
Vous aurez le choix entre deux extensions. Optez pour la version synchronisant les métadonnées localement (le client natif synchronise les jaquettes et résumés pour une navigation plus fluide sur le client).
Une fois installée, une invite vous demandera de configurer le serveur. Saisissez l’adresse IP de votre serveur suivie du port par défaut (8096), puis authentifiez-vous.
Action côté serveur : Retournez sur le tableau de bord de votre serveur Jellyfin, allez dans la section Extensions (Plugins), recherchez et installez l’extension Kodi Sync Queue. Celle-ci garantit la synchronisation optimale des statuts de lecture entre le serveur et Kodi.

📱 Utilisation d’un lecteur externe (VLC) depuis le client Jellyfin

Si vous préférez conserver l’interface fluide du client Jellyfin tout en bénéficiant d’une restitution HDR correcte, il est possible de configurer l’application pour déléguer la lecture vidéo à un lecteur tiers spécialisé, tel que VLC.

Installez VLC media player depuis le magasin d’applications de votre appareil.
Ouvrez l’application cliente Jellyfin sur votre télévision.
Accédez aux paramètres (roue crantée) en haut à droite.
Naviguez vers la section Lecture, puis descendez jusqu’aux Préférences de lecture avancées.
Sélectionnez l’option Utiliser un lecteur externe.
Lors du prochain lancement d’un film, le système vous proposera d’utiliser VLC (ou le lancera automatiquement s’il est le seul lecteur tiers installé). VLC prendra en charge la restitution des formats HDR10 et Dolby Vision, rétablissant ainsi la plage dynamique et la luminosité prévues pour le contenu.

En conclusion, la maîtrise des paramètres de transcodage et l’utilisation judicieuse de l’accélération matérielle garantissent la stabilité de votre serveur Jellyfin. Parallèlement, le contournement des limitations logicielles du client natif via des outils éprouvés comme Kodi ou VLC permet d’assurer une compatibilité totale avec les standards d’affichage modernes, offrant ainsi une expérience multimédia de qualité supérieure, sans compromis sur la centralisation de vos données.