MediaLab SpeedTest für Emby — Anleitung

Plugin installieren, Lizenz aktivieren, dann die Geschwindigkeit jedes Fernsehers, Telefons oder Browsers messen und das Urteil lesen.

Installation

Du brauchst Emby Server 4.10.1 oder neuer.

Melde dich in deinem MediaLab-Works-Konto an, öffne Lizenzen und lade die Plugin-DLL herunter (verfügbar mit aktivem Abo, mit Lifetime-Lizenz im Update-Zeitraum oder in der kostenlosen 30-Tage-Testphase).
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 Konfigurationsvolume von Emby
- Windows: %AppData%\Emby-Server\programdata\plugins\
Öffne MediaLab SpeedTest im Emby-Menü und aktiviere die Lizenz (unten).

Lizenz

Öffne MediaLab SpeedTest im Emby-Menü und klicke auf Lizenz. Füge deinen Lizenzschlüssel ein und aktiviere ihn, oder gib deine E-Mail-Adresse für die kostenlose 30-Tage-Testphase oder den Kauf an. Das Plugin spricht mit dem Lizenzserver, bindet den Schlüssel an diesen Emby-Server und zeigt die Lizenz als Aktiv.

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

Ohne gültige Lizenz zeigt die Seite nur das Lizenzfeld: Messpunkte und Testschaltflächen stoppen, und MediaLab TV misst intern weiter. Nichts wird gelöscht, die Einstellungen bleiben.

Einstellungen

Die Seite enthält den Test, die Geschwindigkeit pro Gerät und die letzten Messungen; die Einstellungen stehen unten:

Ein / aus: ausgeschaltet stoppen die Messpunkte (MediaLab TV misst dann intern).
Messungen pro Minute, je Benutzer: die Missbrauchsgrenze. Ein Gerät braucht selten mehr als wenige Messungen; halte sie niedrig.
Höchstgröße je Messung: zwischen 1 und 64 MiB. Größer ergibt auf schnellen Leitungen ein stabileres Ergebnis; auf langsamen oder mobilen Verbindungen genügt eine kleine Größe.
Verlauf: wie viele letzte Messungen im Speicher behalten werden.

Nach jeder Änderung speichern. Messungen liegen nur im Speicher, die Liste beginnt nach jedem Emby-Neustart leer, unabhängig vom Verlauf.

Messen

Öffne die Plugin-Seite auf dem Gerät, das du testen willst — TV-Browser, Telefon oder Computer —, angemeldet mit dem Konto dieses Geräts. Die Seite misst den Weg dieses Geräts; auf dem Server geöffnet misst sie den Server selbst.
Klicke auf Start (erst Download, dann Upload, dann Latenz). Lass die Seite offen, bis es fertig ist; während einer Messung sind die Schaltflächen gesperrt.
Lies das Ergebnis:
- Download — entscheidend für die Wiedergabe; rund 25 Mbps reichen für 4K mit hoher Bitrate, 10–15 Mbps für 1080p;
- Upload — entscheidend, wenn das Gerät Daten sendet (bei Wiedergabe selten);
- Latenz — entscheidend für einen flüssigen Start und Spulen; über 100 ms bedeutet meist VPN, langen Weg oder ausgelastetes WLAN.
Das Urteil steht neben dem Ergebnis: langsam (unter 3 Mbps), mittel (3–12), gut (12–40), ausgezeichnet (über 40). Die Karte Geschwindigkeit pro Gerät behält das letzte Ergebnis und den Median der letzten fünf.

Messe erneut, wenn das Bild stockt, um zu sehen, ob das Problem gerade auf dem Weg dieses Geräts liegt.

Mit MediaLab TV

MediaLab TV prüft, ob MediaLab SpeedTest installiert und lizenziert ist:

wenn ja, misst die TV-App das Netzwerk beim Start und während der Wiedergabe, wählt die AUTO-Qualität nach der echten Geschwindigkeit und zeigt das Ergebnis auf dem Bildschirm Netzwerk prüfen;
wenn nicht (fehlt, keine Lizenz oder der Server konnte die Lizenz in den letzten 7 Tagen nicht prüfen), misst die TV-App intern weiter, ohne Fehler und ohne den Zuschauer zu fragen.

Endpunkte (für Administratoren)

Alle Endpunkte verlangen einen angemeldeten Emby-Benutzer; es gibt keinen öffentlichen Endpunkt.

HEAD oder GET …/MediaLabSpeedTest/ping — prüft, ob das Plugin antwortet.
GET …/MediaLabSpeedTest/download?mb=N — sendet N MiB für die Download-Messung (N ist durch die Höchstgröße begrenzt).
POST …/MediaLabSpeedTest/upload — nimmt die Daten der Upload-Messung an.

In Emby lautet das Präfix /emby, eine vollständige Adresse sieht also so aus: https://dein-server/emby/MediaLabSpeedTest/ping.

Wenn etwas nicht geht

Die Seite sagt, die Lizenz sei nicht aktiv: Schlüssel unter Lizenz erneut eingeben oder im Konto prüfen, ob die Lizenz diesen Server abdeckt und nicht abgelaufen ist. Das Plugin muss mindestens alle 7 Tage medialab.works erreichen.
Der Test schlägt sofort fehl: prüfe, ob du angemeldet bist (die Endpunkte lehnen anonyme Anfragen ab) und ob das Plugin in den Einstellungen eingeschaltet ist.
Die Zahlen sind viel niedriger als die Leitung des Servers: teste von einem anderen Gerät im selben WLAN, dann von einem Gerät per Kabel. Ist nur ein Gerät langsam, liegt es an dessen WLAN oder Weg, nicht am Server.
Die TV-App ignoriert es: prüfe, ob die Lizenz speedtest (oder das Paket) abdeckt und ob der Server die Lizenz in den letzten 7 Tagen prüfen konnte.