Liste de contrôle de compatibilité du client Jellyfin pour l’audio, la vidéo et les sous-titres

Eva Wong est la rédactrice technique et bricoleuse résidente chez ZimaSpace. Geek depuis toujours, passionnée par les homelabs et les logiciels open source, elle se spécialise dans la traduction de concepts techniques complexes en guides accessibles et pratiques. Eva croit que l’auto-hébergement doit être amusant, pas intimidant. À travers ses tutoriels, elle donne à la communauté les moyens de démystifier les configurations matérielles, depuis la construction de leur premier NAS jusqu’à la maîtrise des conteneurs Docker.

L’approche la plus sûre consiste à traiter une matrice de médias représentative, qui isole le comportement des conteneurs, de la vidéo, de l’audio, des sous-titres, du HDR et du réseau pour chaque client, comme une succession de points de contrôle observables plutôt que comme une commande unique.

Sur un serveur Jellyfin qui diffuse du contenu vers des téléviseurs, des téléphones, des navigateurs et des boîtiers de streaming, le risque concret est le suivant : un même fichier Jellyfin est lu en lecture directe sur un client, mais est transcodé, perd son audio ou ne parvient pas à afficher ses sous-titres sur un autre. Notez l’identité actuelle et le point de reprise, commencez par le discriminateur le moins invasif, interprétez les résultats de réussite et d’échec avant de modifier une autre variable, puis arrêtez-vous lorsque le stockage devient instable ou que la seule copie récupérable risque d’être exposée. Le processus ci-dessous ne s’achève qu’une fois la charge de travail d’origine exécutée avec succès ou lorsque les éléments recueillis atteignent une limite nécessitant une escalade.

Créer une matrice représentative des clients et des médias

Répertoriez chaque appareil client, son système d’exploitation, l’application Jellyfin ou le navigateur utilisé ainsi que sa version, les capacités d’affichage, la connexion audio et le chemin réseau. Sélectionnez un petit ensemble fixe couvrant le H.264, le HEVC ou l’AV1 selon les besoins, le SDR et le HDR, l’audio stéréo et multicanal, les sous-titres texte et image, les conteneurs courants, ainsi qu’un fichier à haut débit binaire.

Ne déduisez pas la compatibilité du seul panneau du téléviseur. L’application, le moteur de lecture, le trajet HDMI, la sortie du téléviseur, l’ampli-récepteur, le moteur de rendu des sous-titres et la politique de qualité à distance participent tous au chemin de lecture final.

Utilisez le processus ZimaSpace consacré à l’isolation de la lecture sur un seul client comme première étape d’isolation propre au client. Cette liste transforme cette branche concernant un seul téléviseur en une matrice reproductible, au lieu de supposer qu’une même règle de qualité convient à chaque terminal.

Tester la vidéo et le conteneur avant l’audio ou les sous-titres

Commencez chaque fichier représentatif avec la piste audio compatible la plus simple et les sous-titres désactivés. Notez le mode de lecture affiché dans le tableau de bord, la raison du transcodage, l’activité du processeur ou du processeur graphique du serveur, le temps de démarrage, la mise en mémoire tampon, le comportement du HDR et si le client indique une lecture directe, un remux ou une conversion vidéo.

Une explication indépendante des différences de mode de lecture selon les clients montre pourquoi différents clients peuvent imposer une charge très différente au serveur avec le même fichier. Utilisez la raison de lecture comme discriminateur, et non le seul pourcentage d’utilisation du processeur.

Si seul le conteneur est incompatible, un remux peut préserver la qualité vidéo ; si le codec vidéo, le profil, le niveau, la profondeur de bits, le chemin HDR ou le débit binaire n’est pas pris en charge, un transcodage vidéo peut être nécessaire. Conservez le même réseau et le même réglage de qualité pendant l’isolation de cette branche.

Ajouter les chemins audio et les formats de sous-titres un par un

Activez la stéréo, le son surround compressé, le son surround sans perte et le passthrough uniquement lorsque l’ensemble de la chaîne allant du téléviseur à l’ampli-récepteur les prend en charge. Notez si la vidéo reste copiée tandis que l’audio est converti, si les canaux sont correctement mappés et si la connexion directe à l’ampli-récepteur se comporte différemment du canal de retour audio du téléviseur.

Testez ensuite les sous-titres SRT ou un autre format texte avant les formats PGS, ASS ou SSA. Un rapport de la communauté sur un cas de transcodage avec des sous-titres PGS montre comment des sous-titres PGS non pris en charge peuvent provoquer le transcodage d’un fichier par ailleurs compatible ; considérez cela comme une signature de symptôme limitée et confirmez la raison affichée dans le tableau de bord sur votre client.

Si les sous-titres déclenchent un incrustage permanent, comparez les sous-titres désactivés, les sous-titres texte et les sous-titres image sur le même fichier. Ne désactivez pas globalement les sous-titres ou l’accélération matérielle avant d’avoir identifié l’étape incompatible.

Valider les profils sur le véritable chemin réseau

Répétez la matrice sur le réseau local et sur la connexion distante prévue, avec la même politique utilisateur et la même limite de qualité. Un client peut utiliser la lecture directe en local, mais transcoder à distance parce que la bande passante ou les réglages de qualité demandent un débit binaire inférieur ; distinguez donc la politique réseau des capacités du codec.

Redémarrez une fois le client et le serveur, retestez un cas limite réussi et un cas limite en échec, puis enregistrez la matrice avec les versions. Mettez-la à jour après toute mise à niveau du client, du micrologiciel du téléviseur ou de Jellyfin, car la déclaration des capacités et le comportement du lecteur peuvent changer.

N’approuvez un profil client que lorsque les chemins audio, vidéo, de sous-titres et HDR représentatifs se comportent comme indiqué et que le serveur reste dans ses limites de capacité. Pour les échecs propres à un seul client, transmettez les informations exactes sur le média et la raison de lecture au lieu de mettre à niveau le matériel du serveur à partir d’un seul transcodage inexpliqué.

Assistance et conseils

Plus à lire

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.