Voyez si le transcodage utilise la carte graphique et pourquoi chaque lecture est transcodée : des tests avec le propre ffmpeg d’Emby et une alerte en cas de repli sur le CPU.

Transcode Doctor indique si votre serveur Emby peut transcoder sur la carte graphique, ce qui l’en empêche le cas échéant, et pourquoi chaque lecture est transcodée.

Ce qu’il fait

Diagnostic de l’accélération matérielle avec le propre ffmpeg d’Emby : vérifie la carte NVIDIA et les périphériques /dev/dri (avec les permissions du processus Emby), puis exécute de courts transcodages de test avec chaque méthode — NVIDIA NVENC, Intel QuickSync et VA-API (Intel / AMD). Chaque méthode est testée en décodage H.264, HEVC, HEVC 10 bits, MPEG-2 (TV), VP9 et AV1 et en encodage H.264 et HEVC, avec la vitesse mesurée. L’encodage AV1 n’est pas testé, car le ffmpeg d’Emby ne peut pas le tester. Les clips de test sont générés dans le dossier de cache d’Emby ; vos médias ne sont pas touchés.
Problèmes, avec la solution exacte : par exemple l’utilisateur Emby absent du groupe render (avec la commande à exécuter), une carte NVIDIA dont le pilote ne répond pas, ou ffmpeg introuvable.
Recommandation : la méthode qui fonctionne, les codecs de la carte, une estimation du nombre de transcodages 1080p possibles en même temps, et où les cocher dans Emby. Le plugin ne modifie pas les réglages d’Emby : Emby choisit lui-même les codecs matériels détectés, dans Settings → Transcoding (accélération matérielle «  Advanced », avec les codecs de la carte cochés).
Pourquoi cela transcode : les lectures récemment transcodées, chacune avec les raisons d’Emby expliquées en langage clair et ce qui peut être fait (par exemple des sous-titres PGS incrustés, du HDR sur un écran SDR, la limite de débit de l’application). Jusqu’à 500 lectures sont conservées.
Alerte de repli sur le CPU : une entrée dans le journal d’activité d’Emby quand un transcodage vidéo s’exécute sur le processeur alors que le dernier diagnostic a trouvé une méthode matérielle fonctionnelle.
En anglais et en roumain.

Prérequis

Emby Server 4.10.1 ou plus récent (Linux, Windows ou Docker).
Une carte graphique NVIDIA, Intel ou AMD avec son pilote : pour NVIDIA, le pilote avec 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). Sous Docker, le périphérique doit être transmis au conteneur. Le transcodage matériel dans Emby lui-même nécessite Emby Premiere.

Questions fréquentes

Pourquoi Emby transcode-t-il sur le CPU alors que mon serveur a un GPU ? Souvent, l’utilisateur Emby n’a pas accès à la carte, le pilote est absent ou les codecs de la carte ne sont pas cochés dans les réglages de transcodage d’Emby. Transcode Doctor teste la carte avec le propre ffmpeg d’Emby et vous dit laquelle. Voir le guide.

Modifie-t-il mes réglages Emby ? Non. Contrairement à la version Jellyfin, il se contente de rapporter : Emby choisit lui-même les codecs matériels et le panneau indique où les régler.

Ce qu’il envoie et où

Aucun contact externe en dehors du client de licence. Il ne télécharge aucun fichier de test : les clips d’exemple (H.264, HEVC, HEVC 10 bits, MPEG-2, VP9, AV1) sont générés localement avec le ffmpeg fourni avec le serveur, dans le dossier de cache du serveur (transcode-doctor/). Vos fichiers médias ne sont pas touchés.
Processus locaux : le ffmpeg fourni avec le serveur, nvidia-smi (uniquement si une carte NVIDIA existe), une vérification d’accès sur /dev/dri/renderD*.
Le diagnostic ne s’exécute que lorsque vous cliquez sur le bouton. La surveillance des sessions (toutes les 15 s, sous licence uniquement) lit les informations de transcodage des lectures actives ; l’alerte «  repli sur le CPU » (activée par défaut) n’écrit que dans le journal d’activité local.
Le plugin ne modifie pas les réglages de transcodage d’Emby (il vous dit quoi cocher).
Plus le client de licence, le même dans chaque plugin : voir Licences et confidentialité dans nos plugins.

Stocké localement (state/ dans le dossier de données du plugin) : report.json (dernier diagnostic : chemin de ffmpeg, GPU, résultats), history.json (les 500 dernières lectures transcodées : heure, utilisateur, application, appareil, titre, raisons du transcodage, matériel/CPU), clips synthétiques dans le cache.

Jamais envoyé : rien de tout cela ne quitte le serveur.

Compatibilité avec les clients

La surveillance et les alertes sont côté serveur : 🟢 fonctionne avec tout client qui déclenche un transcodage.
Interface : page d’administration uniquement — Emby Web ✅ (vérifié visuellement ; aucun test automatisé de bout en bout).
Matériel testé : NVIDIA (NVENC) sur une vraie Quadro M2000 ✅. Intel QSV / VA-API : détectés et testés par le plugin, ❔ non testés sur du vrai matériel. AMD AMF, Apple VideoToolbox, Rockchip : non pris en charge.
Les vérifications sont orientées Linux (/dev/dri, nvidia-smi, groupe render) ; Windows/macOS : ❔ non testés.

Légende : ✅ vérifié (test de bout en bout ou sur l’appareil) · 🟢 côté serveur, fonctionne avec tout client (par conception, aucun test par client) · ➖ sans objet · ❔ non testé.

Licences

Une licence par serveur Emby. Mensuel, annuel ou à vie, ou incluse dans le pack Emby. Essai gratuit de 30 jours. Le plugin est distribué sous notre Licence (CLUF).

Transcode Doctor est notre propre code, écrit par MediaLab Works ; il ne contient aucun code tiers.

Transcode Doctor pour Emby