Transcode Doctor für Emby — Anleitung

Installation

Du brauchst Emby Server 4.10.1 oder neuer.

1. Melde dich in deinem MediaLab-Works-Konto an, öffne Licenses und lade die Plugin-DLL herunter (verfügbar mit einem aktiven Abonnement, einer Lifetime-Lizenz innerhalb ihres Update-Zeitraums oder während des kostenlosen 30-tägigen Testzeitraums).
2. Kopiere die DLL in den Plugin-Ordner von Emby und starte Emby Server neu:
   • Linux (Paket): /var/lib/emby/plugins/
   • Docker: der Ordner plugins in deinem Emby-Konfigurations-Volume
   • Windows: %AppData%\Emby-Server\programdata\plugins\
3. Öffne Transcode Doctor im Emby-Dashboard-Menü und klicke auf License. Füge deinen Lizenzschlüssel ein und aktiviere ihn, oder gib deine E-Mail-Adresse ein, um den kostenlosen 30-tägigen Test zu starten oder eine Lizenz zu kaufen. Das Plugin kontaktiert den Lizenzserver, bindet den Schlüssel an diesen Emby-Server und zeigt die Lizenz als Active an.

Die Lizenz wird einmal am Tag (und bei jedem Emby-Start) geprüft. Ohne Internet läuft das Plugin noch 7 Tage nach der letzten erfolgreichen Prüfung weiter; danach wird es gestoppt, bis es wieder prüfen kann.

Lizenz

Ohne gültige Lizenz wird das Plugin gestoppt: Es läuft kein Test, und es wird keine Warnung geschrieben; nur die Seite License funktioniert weiter (dort kannst du den Test starten, kaufen, den Schlüssel eingeben oder aktualisieren). Der letzte Bericht und der Verlauf bleiben erhalten. Deine Emby-Einstellungen werden vom Plugin nie geändert, also hängt nichts in Emby davon ab.

Mit gültiger Lizenz kann dieselbe Seite ein Update installieren oder bei Problemen nach einem Update auf die vorherige Version zurücksetzen. Starte Emby danach neu.

Konfiguration

Öffne Transcode Doctor im Emby-Dashboard.

1. Diagnose der Hardwarebeschleunigung: Klicke auf Run the tests. Das Plugin prüft die NVIDIA-Karte und die /dev/dri-Geräte, erzeugt ein paar kurze Testclips mit Embys ffmpeg im Cache-Ordner von Emby und versucht dann jede Methode (NVIDIA NVENC, Intel QuickSync, VA-API) beim Decodieren von H.264, HEVC, HEVC 10-bit, MPEG-2, VP9 und AV1 und beim Encodieren von H.264 und HEVC. Jeder Test dauert höchstens eine Minute; die Tabelle zeigt, was funktioniert und wie schnell.
2. Probleme: Wenn etwas die Beschleunigung blockiert, sagt die Seite, was und wie du es behebst, zum Beispiel der Befehl, der den Emby-Benutzer zur Gruppe render hinzufügt (Emby danach neu starten und die Tests erneut laufen lassen). Unter Docker reichst du das GPU-Gerät in den Container durch.
3. Empfehlung: die Methode, die funktioniert, die Codecs der Karte und ungefähr, wie viele 1080p-Transcodes gleichzeitig laufen können. Um sie zu nutzen, öffne in Emby Settings → Transcoding, stelle die Hardwarebeschleunigung auf Advanced und hak die Codecs der Karte an; Emby wählt die erkannten Hardware-Codecs selbst. Das Plugin ändert diese Einstellungen nicht.

Der tägliche Gebrauch

• Warum transcodiert wird listet die letzten transcodierten Wiedergaben: wann, wer, was, die Gründe in verständlichen Worten mit dem, was man tun kann, und ob die GPU oder die CPU die Arbeit gemacht hat.
• Wenn ein Video-Transcode auf der CPU läuft, obwohl die letzte Diagnose eine funktionierende Hardware-Methode gefunden hat, schreibt das Plugin einen Eintrag in das activity log von Emby. Wenn die Tests bestehen, Wiedergaben aber weiter auf der CPU laufen, prüfe die Codecs in Settings → Transcoding.
• Lass die Tests nach einer Treiber-, Emby- oder Hardware-Änderung erneut laufen.

Fehlerbehebung

• Jeder VA-API-/QuickSync-Test schlägt fehl: Prüfe die Problemliste; meist fehlt der Emby-Benutzer in der Gruppe render, oder das Gerät wird nicht in den Docker-Container durchgereicht.
• Jeder NVENC-Test schlägt fehl: Der NVIDIA-Treiber fehlt, oder nvidia-smi antwortet nicht.
• Keine Hardware-Methode hat die Tests bestanden: Transcoding bleibt auf der CPU.