Emby Hardwarebeschleunigung prüfen: Transkodiert die GPU oder die CPU?

Das Problem, das dieses Plugin löst

Wenn dein Emby-Server eine Grafikkarte hat, die Wiedergaben aber weiterhin die CPU auslasten, liegt meist eines von drei Dingen vor: Der Emby-Benutzer kann nicht auf die Karte zugreifen, der Treiber antwortet nicht, oder die Codecs der Karte sind in Emby nicht angekreuzt. Herumraten kostet Abende. Transcode Doctor beantwortet die Frage mit Belegen: Es testet NVIDIA NVENC, Intel QuickSync und VA-API (Intel und AMD) mit Embys eigenem ffmpeg, meldet die gemessene Geschwindigkeit und nennt dir die genaue Lösung, wenn etwas die Beschleunigung blockiert. Außerdem erklärt es in einfachen Worten, warum jede der letzten Wiedergaben überhaupt transcodiert wurde.

Das Plugin berichtet nur. Es ändert nie deine Emby-Einstellungen, daher hängt in Emby nichts von ihm ab.

Voraussetzungen

• Emby Server 4.10.1 oder neuer (Linux, Windows oder Docker).
• Eine NVIDIA-, Intel- oder AMD-Grafikkarte mit ihrem Treiber, die für Emby erreichbar ist. Bei NVIDIA der Treiber, der nvidia-smi bereitstellt; bei Intel und AMD ein /dev/dri-Render-Gerät, das der Emby-Benutzer öffnen kann, üblicherweise über die Gruppe render. In Docker muss das Gerät in den Container durchgereicht werden.
• Hardware-Transcoding in Emby selbst erfordert Emby Premiere.
• Eine Transcode-Doctor-Lizenz: Eine kostenlose 30-Tage-Testversion reicht für eine erste Diagnose. Siehe die Produktseite.

Schritt 1 — Plugin installieren

1. Melde dich in deinem MediaLab-Works-Konto an, öffne Licenses und lade die Plugin-DLL herunter.
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 im Emby-Konfigurationsvolume
   • 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 die kostenlose 30-Tage-Testversion zu starten. Das Plugin bindet den Schlüssel an diesen Server und zeigt die Lizenz als Active an.

Die Lizenz wird einmal täglich und bei jedem Emby-Start geprüft. Ohne Internet funktioniert das Plugin nach der letzten erfolgreichen Prüfung noch 7 Tage weiter.

Schritt 2 — Hardwarebeschleunigung diagnostizieren

Klicke auf der Seite von Transcode Doctor auf Run the tests. Das Plugin:

• prüft die NVIDIA-Karte und die /dev/dri-Geräte mit den Berechtigungen des Emby-Prozesses;
• erzeugt ein paar kurze Testclips mit Embys ffmpeg im Cache-Ordner von Emby (deine Medien werden nicht angefasst);
• versucht jede Methode beim Decodieren von H.264, HEVC, HEVC 10-bit, MPEG-2 (TV), VP9 und AV1 und beim Encodieren von H.264 und HEVC.

Jeder Test dauert höchstens eine Minute, und die Tabelle zeigt, was funktioniert und wie schnell. AV1-Encoding wird nicht getestet, weil Embys ffmpeg das nicht testen kann.

Schritt 3 — Problemliste lesen und die Lösung anwenden

Wenn etwas die Beschleunigung blockiert, nennt die Seite es und gibt die Lösung. Die häufigen Fälle:

• Der Emby-Benutzer fehlt in der Gruppe render. Die Seite zeigt den auszuführenden Befehl. Nach dem Hinzufügen des Benutzers startest du Emby neu und führst die Tests erneut aus. Das ist der übliche Grund, warum jeder VA-API- und QuickSync-Test fehlschlägt.
• Eine NVIDIA-Karte, deren Treiber nicht antwortet. Wenn nvidia-smi nicht antwortet, schlägt jeder NVENC-Test fehl; behebe zuerst den Treiber.
• ffmpeg nicht gefunden. Das Plugin testet mit dem mitgelieferten ffmpeg von Emby, daher deutet das auf die Emby-Installation selbst hin.
• Docker. Das GPU-Gerät muss in den Container durchgereicht werden; das Plugin sieht nur, was der Emby-Prozess sieht, nicht mehr.

Wenn keine Hardware-Methode die Tests besteht, bleibt das Transcoding auf der CPU — das ist das ehrliche Ergebnis, und der Bericht sagt dir das so.

Schritt 4 — Empfohlene Methode in Emby ankreuzen

Der Abschnitt Recommendation nennt dir die funktionierende Methode, die Codecs der Karte, eine Schätzung, wie viele 1080p-Transcodings gleichzeitig laufen können, und wo du sie ankreuzt. Das Plugin ändert diese Einstellungen nicht: Öffne in Emby Settings → Transcoding, stelle die Hardwarebeschleunigung auf Advanced und kreuze die Codecs der Karte an. Emby wählt die erkannten Hardware-Codecs selbst aus.

Wenn die Tests bestehen, die Wiedergaben aber trotzdem auf der CPU laufen, ist diese Einstellungsseite die erste Stelle zum Nachsehen.

Schritt 5 — Herausfinden, warum jede Wiedergabe transcodiert

Die Ansicht Why it transcodes listet die letzten transcodierten Wiedergaben auf (bis zu 500 werden gespeichert): wann, wer, welche App und welches Gerät, der Titel, die Gründe in einfachen Worten mit dem, was man tun kann, und ob die GPU oder die CPU die Arbeit erledigt hat. Typische Gründe, die die Dokumentation nennt:

• Eingebrannte PGS-Untertitel: Das Untertitelformat erzwingt ein Video-Transcoding, selbst wenn das Video selbst direkt abgespielt würde.
• HDR auf einem SDR-Bildschirm: Das Tone Mapping muss irgendwo passieren.
• Audiocodecs: Der Client kann die Tonspur nicht decodieren, also wird das Audio umgewandelt.
• Das Bitratenlimit der App: Ein entfernter Client mit niedrigem Limit fordert eine niedrigere Bitrate an.

Manches davon lohnt sich zu beheben (eine andere Untertitelspur, eine Client-Einstellung), manches ist einfach das, was der Client angefordert hat. So oder so weißt du jetzt, welcher Fall vorliegt, statt zu raten.

Schritt 6 — Aktivitätsprotokoll auf CPU-Rückfälle prüfen

Wenn ein Video-Transcoding auf dem Prozessor läuft, obwohl die letzte Diagnose eine funktionierende Hardware-Methode gefunden hat, schreibt das Plugin einen Eintrag ins Aktivitätsprotokoll von Emby. Die Warnung ist standardmäßig aktiv und schreibt nur lokal. Wenn sie auslöst, während deine Tests bestehen, geh zurück zu Settings → Transcoding und prüfe die angekreuzten Codecs.

Tipps und Fehlerbehebung

• Führe die Tests nach einer Änderung an Treiber, Emby oder Hardware erneut aus. Ein Bericht von vor einem Upgrade sagt nichts über den aktuellen Zustand.
• Jeder VA-API- / QuickSync-Test schlägt fehl: Prüfe die Problemliste; meist ist es die Gruppe render oder das Docker-Gerätemapping.
• Jeder NVENC-Test schlägt fehl: Der NVIDIA-Treiber fehlt oder nvidia-smi antwortet nicht.
• Keine Hardware-Methode bestanden: Das Transcoding bleibt auf der CPU. Die Empfehlung und die Gründe pro Wiedergabe helfen dir trotzdem, die Häufigkeit zu verringern.
• Wo die Daten liegen: Der letzte Bericht und der Verlauf liegen im Ordner state/ des Plugins; die synthetischen Clips liegen im Cache-Ordner. Nichts verlässt den Server außer der Lizenzprüfung — siehe Lizenzierung und Datenschutz in unseren Plugins.
• Hardware-Abdeckung: NVIDIA (NVENC) wurde auf einer echten Quadro M2000 verifiziert. Intel QSV und VA-API werden vom Plugin erkannt und getestet, aber nicht auf echter Hardware getestet. AMD AMF, Apple VideoToolbox und Rockchip werden nicht unterstützt. Die Prüfungen sind auf Linux ausgerichtet; Windows wurde nicht getestet.
• Client-Kompatibilität: Das Ansehen und die Warnungen laufen serverseitig und funktionieren mit jedem Client, der ein Transcoding auslöst. Die Admin-Oberfläche ist Emby Web.
• Updates: Auf der Seite License kannst du ein Update installieren oder auf die vorherige Version zurückrollen; starte Emby danach jeweils neu. Siehe das Changelog.

Mehr Hintergrund findest du in unserer Wissensdatenbank und den FAQ; für alles andere kontaktiere uns.

Fazit

Eine GPU, die Emby nicht nutzen kann, ist schlimmer als keine GPU: Du bezahlst dafür und transcodierst trotzdem auf der CPU. Transcode Doctor macht daraus eine kurze, wiederholbare Prüfung — führe die Tests mit Embys eigenem ffmpeg aus, wende die eine Lösung an, die die Problemliste nennt, kreuze die Codecs in Emby an und lies dann die Gründe pro Wiedergabe, um zu sehen, was sich wirklich zu ändern lohnt. Beginne mit der Bedienungsanleitung und der Produktseite.