Transcode Doctor für Emby

Transcode Doctor zeigt, ob dein Emby-Server auf der Grafikkarte transcodieren kann, was es verhindert, wenn nicht, und warum jede Wiedergabe überhaupt transcodiert wird.

Was es macht

• Diagnose der Hardwarebeschleunigung mit Embys eigenem ffmpeg: prüft die NVIDIA-Karte und die /dev/dri-Geräte (mit den Berechtigungen des Emby-Prozesses) und führt dann mit jeder Methode kurze Test-Transcodes aus – NVIDIA NVENC, Intel QuickSync und VA-API (Intel / AMD). Jede Methode wird beim Decodieren von H.264, HEVC, HEVC 10-bit, MPEG-2 (TV), VP9 und AV1 und beim Encodieren von H.264 und HEVC getestet, mit der gemessenen Geschwindigkeit. AV1-Encoding wird nicht getestet, weil es Embys ffmpeg nicht testen kann. Die Testclips werden im Cache-Ordner von Emby erzeugt; deine Medien werden nicht angerührt.
• Probleme mit der genauen Lösung: zum Beispiel der fehlende Emby-Benutzer in der Gruppe render (mit dem auszuführenden Befehl), eine NVIDIA-Karte, deren Treiber nicht antwortet, oder ein nicht gefundenes ffmpeg.
• Empfehlung: die Methode, die funktioniert, die Codecs der Karte, eine Schätzung, wie viele 1080p-Transcodes gleichzeitig laufen können, und wo du sie in Emby ankreuzt. Das Plugin ändert nichts an Embys Einstellungen: Emby wählt die erkannten Hardware-Codecs selbst in Settings → Transcoding (Hardwarebeschleunigung „Advanced“, mit den Codecs der Karte angehakt).
• Warum transcodiert wird: die letzten transcodierten Wiedergaben, jeweils mit Embys Gründen in verständlichen Worten erklärt und dem, was man tun kann (zum Beispiel eingebrannte PGS-Untertitel, HDR auf einem SDR-Bildschirm, das Bitratenlimit der App). Bis zu 500 Wiedergaben werden aufbewahrt.
• Warnung beim Rückfall auf die CPU: ein Eintrag im Aktivitätsprotokoll von Emby, wenn ein Video-Transcode auf dem Prozessor läuft, obwohl die letzte Diagnose eine funktionierende Hardware-Methode gefunden hat.
• Auf Englisch und Rumänisch.

Voraussetzungen

• Emby Server 4.10.1 oder neuer (Linux, Windows oder Docker).
• Eine NVIDIA-, Intel- oder AMD-Grafikkarte mit ihrem Treiber: bei NVIDIA der Treiber mit nvidia-smi; bei Intel und AMD ein /dev/dri-Render-Gerät, das der Emby-Benutzer öffnen kann (meist über die Gruppe render). Unter Docker muss das Gerät in den Container durchgereicht werden. Hardware-Transcoding in Emby selbst braucht Emby Premiere.

Häufige Fragen

Warum transcodiert Emby auf der CPU, obwohl mein Server eine GPU hat? Meist hat der Emby-Benutzer keinen Zugriff auf die Karte, der Treiber fehlt, oder die Codecs der Karte sind in Embys Transcoding-Einstellungen nicht angehakt. Transcode Doctor testet die Karte mit Embys eigenem ffmpeg und sagt dir, welcher Fall zutrifft. Siehe die Anleitung.

Ändert es meine Emby-Einstellungen? Nein. Anders als die Jellyfin-Version berichtet es nur: Emby wählt die Hardware-Codecs selbst, und das Panel sagt, wo du sie einstellst.

Was es wohin sendet

• Kein externer Kontakt außer dem Lizenz-Client. Es lädt keine Testdateien herunter: Die Beispielclips (H.264, HEVC, HEVC 10-bit, MPEG-2, VP9, AV1) werden lokal erzeugt mit dem mitgelieferten ffmpeg des Servers, im Cache-Ordner des Servers (transcode-doctor/). Deine Mediendateien werden nicht angerührt.
• Lokale Prozesse: das mitgelieferte ffmpeg des Servers, nvidia-smi (nur wenn eine NVIDIA-Karte vorhanden ist), eine Zugriffsprüfung auf /dev/dri/renderD*.
• Die Diagnose läuft nur, wenn du auf den Button klickst. Die Sitzungsüberwachung (alle 15 s, nur mit Lizenz) liest die Transcoding-Infos der aktiven Wiedergaben; die Warnung „auf CPU zurückgefallen“ (standardmäßig an) schreibt nur in das lokale Aktivitätsprotokoll.
• Das Plugin ändert Embys Transcoding-Einstellungen nicht (es sagt dir, was du ankreuzen musst).
• Dazu der Lizenz-Client, in jedem Plugin gleich: siehe Lizenzierung und Datenschutz in unseren Plugins.

Lokal gespeichert (state/ im Datenordner des Plugins): report.json (letzte Diagnose: ffmpeg-Pfad, GPU, Ergebnisse), history.json (die letzten 500 transcodierten Wiedergaben: Zeit, Benutzer, App, Gerät, Titel, Transcoding-Gründe, Hardware/CPU), synthetische Clips im Cache.

Nie gesendet: nichts davon verlässt den Server.

Kompatibilität mit Clients

• Überwachung und Warnungen laufen serverseitig: 🟢 funktioniert mit jedem Client, der ein Transcoding auslöst.
• Oberfläche: nur Admin-Seite – Emby Web ✅ (visuell geprüft; kein automatisierter End-to-End-Test).
• Getestete Hardware: NVIDIA (NVENC) auf einer echten Quadro M2000 ✅. Intel QSV / VA-API: vom Plugin erkannt und getestet, ❔ nicht auf echter Hardware getestet. AMD AMF, Apple VideoToolbox, Rockchip: nicht unterstützt.
• Die Prüfungen sind auf Linux ausgerichtet (/dev/dri, nvidia-smi, Gruppe render); Windows/macOS: ❔ nicht getestet.

Legende: ✅ verifiziert (End-to-End- oder Test auf dem Gerät) · 🟢 serverseitig, funktioniert mit jedem Client (konstruktionsbedingt, kein clientspezifischer Test) · ➖ nicht zutreffend · ❔ nicht getestet.

Lizenzierung

Eine Lizenz pro Emby-Server. Monatlich, jährlich oder als Lifetime-Lizenz, oder im Emby-Paket enthalten. 30 Tage kostenlos testen. Das Plugin wird unter unserer EULA lizenziert.

Transcode Doctor ist unser eigener Code, von MediaLab Works geschrieben; er enthält keinen Code Dritter.