Transcode Doctor pour Emby — guide

Installation

Il vous faut Emby Server 4.10.1 ou plus récent.

1. Connectez-vous à votre compte MediaLab Works, ouvrez Licenses et téléchargez la DLL du plugin (disponible avec un abonnement actif, une licence à vie dans sa période de mises à jour, ou pendant l’essai gratuit de 30 jours).
2. Copiez la DLL dans le dossier des plugins Emby et redémarrez Emby Server :
   • Linux (paquet) : /var/lib/emby/plugins/
   • Docker : le dossier plugins à l’intérieur de votre volume de configuration Emby
   • Windows : %AppData%\Emby-Server\programdata\plugins\
3. Ouvrez Transcode Doctor dans le menu du tableau de bord Emby et cliquez sur License. Collez votre clé de licence et activez-la, ou saisissez votre e-mail pour démarrer l’essai gratuit de 30 jours ou acheter une licence. Le plugin contacte le serveur de licences, lie la clé à ce serveur Emby 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 ; ensuite, il est arrêté jusqu’à ce qu’il puisse vérifier à nouveau.

Licence

Sans licence valide, le plugin est arrêté : aucun test ne s’exécute, aucune alerte n’est écrite, et seule la page License continue de fonctionner (vous pouvez y démarrer l’essai, acheter, saisir la clé ou faire une mise à jour). Le dernier rapport et l’historique sont conservés. Le plugin ne modifie jamais vos réglages Emby : rien dans Emby ne dépend de lui.

Avec une licence valide, la même page permet d’installer une mise à jour ou de revenir à la version précédente si une mise à jour pose problème. Redémarrez Emby dans les deux cas.

Configuration

Ouvrez Transcode Doctor dans le tableau de bord Emby.

1. Hardware acceleration diagnosis (diagnostic de l’accélération matérielle) : cliquez sur Run the tests. Le plugin vérifie la carte NVIDIA et les périphériques /dev/dri, crée quelques courts clips de test avec le ffmpeg d’Emby dans le dossier de cache d’Emby, puis essaie chaque méthode (NVIDIA NVENC, Intel QuickSync, VA-API) en décodage H.264, HEVC, HEVC 10 bits, MPEG-2, VP9 et AV1 et en encodage H.264 et HEVC. Chaque test dure au plus une minute ; le tableau indique ce qui fonctionne et à quelle vitesse.
2. Problems (problèmes) : si quelque chose bloque l’accélération, la page indique quoi et comment le corriger, par exemple la commande qui ajoute l’utilisateur Emby au groupe render (puis redémarrez Emby et relancez les tests). Sous Docker, transmettez le périphérique GPU au conteneur.
3. Recommendation (recommandation) : la méthode qui fonctionne, les codecs de la carte et environ combien de transcodages 1080p peuvent s’exécuter en même temps. Pour les utiliser, ouvrez Settings → Transcoding dans Emby, réglez l’accélération matérielle sur Advanced et cochez les codecs de la carte ; Emby choisit lui-même les codecs matériels détectés. Le plugin ne modifie pas ces réglages.

Utilisation quotidienne

• Why it transcodes (pourquoi cela transcode) liste les lectures récemment transcodées : quand, qui, quoi, les raisons en langage clair avec ce qui peut être fait, et si le GPU ou le CPU a fait le travail.
• Quand un transcodage vidéo s’exécute sur le CPU 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. Si les tests réussissent mais que les lectures restent sur le CPU, vérifiez les codecs dans Settings → Transcoding.
• Relancez les tests après un changement de pilote, d’Emby ou de matériel.

Dépannage

• Chaque test VA-API / QuickSync échoue : consultez la liste des problèmes ; l’utilisateur Emby n’est généralement pas dans le groupe render ou le périphérique n’est pas transmis au conteneur Docker.
• Chaque test NVENC échoue : 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.