Accélération matérielle Emby : votre transcodage utilise-t-il le GPU ou le CPU ?

Le problème que cela résout

Si votre serveur Emby dispose d’une carte graphique mais que les lectures saturent le CPU, il s’agit généralement de l’un de ces trois cas : l’utilisateur Emby ne peut pas ouvrir la carte, le pilote ne répond pas, ou les codecs de la carte ne sont pas cochés dans Emby. Tâtonner coûte des soirées entières. Transcode Doctor répond à la question avec des preuves : il teste NVIDIA NVENC, Intel QuickSync et VA-API (Intel et AMD) avec le ffmpeg d’Emby, indique la vitesse mesurée et donne le correctif exact lorsqu’un élément bloque l’accélération. Il explique aussi, en termes simples, pourquoi chaque lecture récente a été transcodée.

Le plugin se contente de faire un rapport. Il ne modifie jamais vos paramètres Emby, donc rien dans Emby n’en dépend.

Prérequis

• Emby Server 4.10.1 ou version ultérieure (Linux, Windows ou Docker).
• Une carte graphique NVIDIA, Intel ou AMD avec son pilote, accessible par Emby. Pour NVIDIA, le pilote qui fournit nvidia-smi ; pour Intel et AMD, un périphérique de rendu /dev/dri que l’utilisateur Emby peut ouvrir, généralement via le groupe render. Dans Docker, le périphérique doit être transmis au conteneur.
• Le transcodage matériel dans Emby lui-même nécessite Emby Premiere.
• Une licence Transcode Doctor : un essai gratuit de 30 jours suffit pour un premier diagnostic. Voir la page produit.

Étape 1 — Installer le plugin

1. Connectez-vous à votre compte MediaLab Works, ouvrez Licences et téléchargez la DLL du plugin.
2. Copiez la DLL dans le dossier des plugins d’Emby et redémarrez Emby Server :
   • Linux (paquet) : /var/lib/emby/plugins/
   • Docker : le dossier plugins dans le volume de configuration d’Emby
   • Windows : %AppData%\Emby-Server\programdata\plugins\
3. Ouvrez Transcode Doctor dans le menu du tableau de bord Emby et cliquez sur Licence. Collez votre clé de licence et activez-la, ou saisissez votre e-mail pour démarrer l’essai gratuit de 30 jours. Le plugin lie la clé à ce serveur et affiche la licence comme Active.

La licence est vérifiée une fois par jour et à chaque démarrage d’Emby. Sans internet, le plugin continue de fonctionner pendant 7 jours après la dernière vérification réussie.

Étape 2 — Lancer le diagnostic de l’accélération matérielle

Sur la page Transcode Doctor, cliquez sur Lancer les tests. Le plugin :

• vérifie la carte NVIDIA et les périphériques /dev/dri, avec les permissions du processus Emby ;
• génère quelques courts clips de test avec le ffmpeg d’Emby dans le dossier de cache d’Emby (vos médias ne sont pas touchés) ;
• essaie chaque méthode en décodage H.264, HEVC, HEVC 10 bits, MPEG-2 (TV), VP9 et AV1 et en encodage H.264 et HEVC.

Chaque test dure au plus une minute, et le tableau indique ce qui fonctionne et à quelle vitesse. L’encodage AV1 n’est pas testé, car le ffmpeg d’Emby ne permet pas de le tester.

Étape 3 — Lire la liste des problèmes et appliquer le correctif

Si quelque chose bloque l’accélération, la page le nomme et donne le correctif. Les cas courants :

• L’utilisateur Emby n’est pas membre du groupe render. La page affiche la commande à exécuter. Après avoir ajouté l’utilisateur, redémarrez Emby et relancez les tests. C’est la raison habituelle de l’échec de tous les tests VA-API et QuickSync.
• Une carte NVIDIA dont le pilote ne répond pas. Si nvidia-smi ne répond pas, tous les tests NVENC échouent ; corrigez d’abord le pilote.
• ffmpeg introuvable. Le plugin teste avec le ffmpeg fourni avec Emby, donc cela pointe vers l’installation d’Emby elle-même.
• Docker. Le périphérique GPU doit être transmis au conteneur ; le plugin ne voit que ce que voit le processus Emby, rien de plus.

Si aucune méthode matérielle ne passe les tests, le transcodage reste sur le CPU — c’est le résultat honnête, et le rapport vous le dit.

Étape 4 — Cocher la méthode recommandée dans Emby

La section Recommandation vous donne la méthode qui fonctionne, les codecs de la carte, une estimation du nombre de transcodages 1080p simultanés possibles, et l’endroit où les cocher. Le plugin ne modifie pas ces paramètres : ouvrez Paramètres → Transcodage d’Emby, réglez l’accélération matérielle sur Avancé et cochez les codecs de la carte. Emby sélectionne lui-même les codecs matériels détectés.

Si les tests passent mais que les lectures tournent toujours sur le CPU, cette page de paramètres est le premier endroit à vérifier.

Étape 5 — Découvrir pourquoi chaque lecture est transcodée

La vue Pourquoi c’est transcodé liste les lectures transcodées récentes (jusqu’à 500 sont conservées) : quand, qui, quelle application et quel appareil, le titre, les raisons en termes simples avec ce qui peut être fait, et si le GPU ou le CPU a effectué le travail. Raisons typiques citées par la documentation :

• Sous-titres PGS incrustés : le format de sous-titres force un transcodage vidéo même lorsque la vidéo elle-même serait lue en direct.
• HDR sur un écran SDR : le tone mapping doit se faire quelque part.
• Codecs audio : le client ne peut pas décoder la piste, donc l’audio est converti.
• La limite de débit de l’application : un client distant avec une limite basse demande un débit inférieur.

Certaines de ces raisons valent la peine d’être corrigées (une autre piste de sous-titres, un réglage du client), d’autres sont simplement ce que le client a demandé. Dans tous les cas, vous savez maintenant laquelle c’est au lieu de deviner.

Étape 6 — Surveiller le journal d’activité pour les replis sur le CPU

Lorsqu’un transcodage vidéo s’exécute sur le processeur alors que le dernier diagnostic a trouvé une méthode matérielle fonctionnelle, le plugin écrit une entrée dans le journal d’activité d’Emby. L’alerte est activée par défaut et n’écrit qu’en local. Si elle se déclenche alors que vos tests passent, revenez à Paramètres → Transcodage et vérifiez les codecs cochés.

Conseils et dépannage

• Relancez les tests après un changement de pilote, d’Emby ou de matériel. Un rapport antérieur à une mise à niveau ne dit rien de l’état actuel.
• Tous les tests VA-API / QuickSync échouent : consultez la liste des problèmes ; il s’agit généralement du groupe render ou du mappage du périphérique Docker.
• Tous les tests NVENC échouent : le pilote NVIDIA est absent ou nvidia-smi ne répond pas.
• Aucune méthode matérielle n’a passé les tests : le transcodage reste sur le CPU. La recommandation et les raisons par lecture vous aident tout de même à réduire sa fréquence.
• Où sont stockées les données : le dernier rapport et l’historique se trouvent dans le dossier state/ du plugin ; les clips synthétiques sont dans le dossier de cache. Rien ne quitte le serveur, hormis la vérification de licence — voir Licences et confidentialité dans nos plugins.
• Couverture matérielle : NVIDIA (NVENC) a été vérifié sur une véritable Quadro M2000. Intel QSV et VA-API sont détectés et testés par le plugin mais n’ont pas été testés sur du matériel réel. AMD AMF, Apple VideoToolbox et Rockchip ne sont pas pris en charge. Les vérifications sont orientées Linux ; Windows n’a pas été testé.
• Compatibilité client : la surveillance et les alertes sont côté serveur et fonctionnent avec tout client qui déclenche un transcodage. L’interface d’administration est Emby Web.
• Mises à jour : depuis la page Licence, vous pouvez installer une mise à jour ou revenir à la version précédente ; redémarrez Emby dans les deux cas. Voir le journal des modifications.

Pour plus de contexte, consultez notre base de connaissances et notre FAQ ; pour toute autre question, contactez-nous.

Conclusion

Un GPU qu’Emby ne peut pas utiliser est pire que pas de GPU du tout : vous le payez et vous transcodez quand même sur le CPU. Transcode Doctor transforme cela en une vérification courte et reproductible — lancez les tests avec le ffmpeg d’Emby, appliquez le correctif unique indiqué dans la liste des problèmes, cochez les codecs dans Emby, puis lisez les raisons par lecture pour voir ce qui vaut réellement la peine d’être changé. Commencez par le guide d’utilisation et la page produit.