MediaLab SpeedTest für Jellyfin — Anleitung

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

Installation

Du brauchst Jellyfin Server 12.2 oder neuer (oder medialab Server) und ein MediaLab-Works-Konto mit einer Lizenz, die das Plugin abdeckt (aktives Abo, Lifetime-Lizenz im Update-Zeitraum, das Jellyfin-Paket oder die kostenlose 30-Tage-Testphase).

Aus deinem Plugin-Repository (empfohlen). Jellyfin installiert und aktualisiert das Plugin dann selbst.

1. Öffne in deinem MediaLab-Works-Konto Lizenzen → Jellyfin-Plugin-Repository und klicke auf Adresse erstellen. Kopiere sie: sie ist privat (enthält ein Token), teile sie nicht; du kannst sie jederzeit neu erzeugen oder widerrufen.
2. Öffne in Jellyfin Dashboard → Plugins → Repositories, klicke auf +, gib einen Namen (zum Beispiel MediaLab Works) ein, füge die Adresse ein und speichere.
3. Suche in Dashboard → Plugins → Katalog nach MediaLab SpeedTest by MediaLab, klicke auf Installieren und starte Jellyfin neu.

Das Repository listet nur die Plugins, die deine Lizenzen abdecken, und nur die erlaubten Versionen. Die Download-Links sind signiert und laufen nach einigen Stunden ab, Jellyfin liest also immer eine frische Liste.

Manuell, aus einer Zip-Datei.

1. Lade in Konto → Lizenzen jf-speedtest_x.y.z.zip herunter (die SHA-256 steht neben dem Knopf).
2. Entpacke sie in einen neuen Ordner MediaLab SpeedTest by MediaLab_x.y.z.0 im Plugin-Ordner von Jellyfin:
   • Linux (Paket): /var/lib/jellyfin/plugins/
   • Docker (offizielles Image): /config/plugins/ im Konfigurationsvolume
   • Windows: %ProgramData%\Jellyfin\Server\plugins\
3. Starte Jellyfin neu.

Lizenz

Öffne MediaLab SpeedTest im Jellyfin-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 Jellyfin-Server und zeigt die Lizenz als Aktiv.

Die Lizenz wird einmal täglich geprüft (und bei jedem Start von Jellyfin). 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 Jellyfin-Neustart leer, unabhängig vom Verlauf.

Messen

1. Ö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.
2. 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.
3. 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.
4. 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 Jellyfin-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 Jellyfin liegen die Endpunkte direkt unter der Serveradresse, eine vollständige Adresse sieht also so aus: https://dein-server/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.