Quick Connect für Jellyfin — Anleitung

Installation

Du brauchst Jellyfin Server 12.2 oder neuer und ein MediaLab-Works-Konto mit einer Lizenz, die das Plugin abdeckt (ein aktives Abonnement, eine Lifetime-Lizenz innerhalb ihres Update-Zeitraums, das Jellyfin-Paket oder den kostenlosen 30-tägigen Testzeitraum).

Über dein Plugin-Repository (empfohlen). Jellyfin installiert und aktualisiert das Plugin dann von selbst.

Öffne in deinem MediaLab-Works-Konto Lizenzen → Jellyfin-Plugin-Repository und klicke auf Adresse erstellen. Kopiere sie: Sie ist privat (sie enthält einen Token), teile sie also nicht; du kannst sie jederzeit neu erzeugen oder widerrufen.
Öffne in Jellyfin Dashboard → Erweiterungen → Repositories, klicke auf +, gib einen Namen ein (zum Beispiel MediaLab Works), füge die Adresse ein und speichere.
Finde im Dashboard → Erweiterungen → Katalog den Eintrag Quick Connect by MediaLab, klicke auf Installieren und starte Jellyfin neu.

Das Repository listet nur die Plugins, die deine Lizenzen abdecken, und nur die Versionen, die sie erlauben. Seine Download-Links sind signiert und laufen nach ein paar Stunden ab, deshalb liest Jellyfin immer eine frische Liste.

Über den öffentlichen Katalog. https://medialab.works/jellyfin/manifest.json listet jedes veröffentlichte MediaLab-Works-Plugin mit seinem öffentlichen Build; medialab Server fügt ihn von selbst hinzu. Du kannst ihn auf dieselbe Weise hinzufügen, um ein Plugin zu installieren, bevor du einen Schlüssel hast: Das Plugin fragt dann auf seiner Lizenzseite nach der Lizenz oder startet den Testzeitraum. Bei einer Lifetime-Lizenz, deren Update-Zeitraum endete, bleib bei deinem privaten Repository, das nur die Versionen anbietet, die deine Lizenz erlaubt.

Manuell aus einer Zip-Datei.

Lade in Konto → Lizenzen jf-quickconnect_x.y.z.zip herunter (die SHA-256 der Datei steht neben dem Button).
Entpacke sie in einen neuen Ordner Quick Connect by MediaLab_x.y.z.0 im Jellyfin-Plugin-Ordner:
- Linux (Paket): /var/lib/jellyfin/plugins/
- Docker (offizielles Image): /config/plugins/ im Konfigurations-Volume
- Windows: %ProgramData%\Jellyfin\Server\plugins\
Starte Jellyfin neu.

Lizenzaktivierung

Öffne die Plugin-Seite unter Dashboard → Erweiterungen → Quick Connect by MediaLab und klicke auf License.
Füge deinen Lizenzschlüssel ein und klicke auf Activate with key. Das Plugin kontaktiert den Lizenzserver, bindet den Schlüssel an diesen Jellyfin-Server und zeigt die Lizenz als Active an.
Noch kein Schlüssel? Gib auf derselben Seite deine E-Mail-Adresse ein und starte den kostenlosen 30-tägigen Testzeitraum (Karte erforderlich, heute nichts zu zahlen) oder kaufe eine Lizenz; das Plugin aktiviert sich, sobald die Zahlung erledigt ist.

Die Lizenz wird einmal am Tag und bei jedem Start von Jellyfin geprüft. Ohne Internet funktioniert das Plugin noch 7 Tage nach der letzten erfolgreichen Prüfung weiter. Ohne gültige Lizenz stoppt das Plugin seine Arbeit, und nur seine License-Seite funktioniert weiter (Testzeitraum, Schlüssel, Verlängerung); es wird nichts gelöscht, und alles läuft weiter, sobald die Lizenz wieder gültig ist. Move license (release this server) auf derselben Seite gibt den Schlüssel für einen anderen Server frei.

Updates und Rollback

Aus dem Repository: Jellyfin zeigt neue Versionen unter Dashboard → Erweiterungen an und kann das Plugin automatisch aktualisieren; starte Jellyfin neu, um die neue Version zu laden.
Über die Lizenzseite des Plugins: Mit gültiger Lizenz installiert Install update die neueste Version, die deine Lizenz erlaubt, und Roll back to x.y.z geht zur vorherigen Version zurück (zum Beispiel, wenn nach einem Update etwas nicht mehr funktioniert). Starte Jellyfin nach beidem neu. Beide Pakete werden gegen die Prüfsumme geprüft, die der Lizenzserver veröffentlicht.
Eine Lifetime-Lizenz erhält die Versionen, die während ihres Update-Zeitraums erschienen sind; danach läuft das Plugin mit der letzten Version weiter, die es nutzen darf.
Nach Roll back to x.y.z ist die automatische Aktualisierung von Jellyfin für dieses Plugin ausgeschaltet, bis zum nächsten Install update auf der Lizenzseite, damit die geplante Aufgabe Update Plugins (beim Start und täglich) die neuere Version nicht zurückholt.
Lifetime-Lizenz und automatische Updates. Der öffentliche Jellyfin-Katalog (https://medialab.works/jellyfin/manifest.json) bietet immer die neueste Version an. Wenn der Update-Zeitraum einer Lifetime-Lizenz endete, sind später erschienene Versionen nicht lizenziert: Wenn Jellyfins automatische Plugin-Updates so eine Version installieren, stoppt das Plugin mit „version not licensed", bis du auf seiner Lizenzseite mit Roll back to x.y.z zurückgehst oder einen Update-Pass kaufst. Um das zu vermeiden, lass Jellyfin dieses Plugin nicht automatisch aktualisieren: Füge dein privates Plugin-Repository hinzu, das nur die Versionen anbietet, die deine Lizenz erlaubt, anstelle des öffentlichen Katalogs, oder entferne die Auslöser der geplanten Aufgabe Update Plugins unter Dashboard → Geplante Aufgaben (das stoppt automatische Updates für jedes Plugin).

Quellcode

Der GPL-3.0-Quellcode jeder Version liegt in Konto → Lizenzen (Quellcode) neben dem Download als .tar.gz-Archiv, erzeugt aus dem exakten Commit dieser Version.

Konfiguration

Öffne Quick Connect im Dashboard-Menü von Jellyfin.

Quick Connect in Jellyfin: Das Plugin baut auf Jellyfins eigenem Quick Connect auf. Wenn das Panel sagt, dass es aus ist, klicke auf Turn on Quick Connect (oder schalte es in Dashboard → Allgemein ein); solange es aus ist, können Jellyfin-Apps keine Codes anfordern.
Settings:
- The phone and screen pages are active.
- Approval from the phone with username + password too, für Handys, auf denen Jellyfin nicht angemeldet ist. Schalte es aus, um nur Bestätigungen von einem Handy zu erlauben, das bereits eine Jellyfin-Sitzung hat.
- Administrator accounts cannot approve through the phone page: standardmäßig aus.
How to use zeigt die beiden Adressen auf deinem Server: die Handy-Seite (/Connect/Page) und die Bildschirmseite für TV-Browser (/Connect/Screen). Teile die Adresse der Handy-Seite mit deinen Benutzern, oder hänge ihren QR-Code neben den Fernseher.

Das Plugin fügt bewusst keinen Einmalcode hinzu, der anstelle des Passworts eingetippt wird: Benutzer, die sich darauf verlassen hätten, wären ausgesperrt, falls das Plugin entfernt würde. Die Passwörter bleiben genau so, wie Jellyfin sie verwaltet.

Tägliche Nutzung

In einer Jellyfin-App auf dem Fernseher (Android TV, Fire TV, webOS, Tizen, Roku und die anderen): Wähle im Anmeldebildschirm Quick Connect. Die App zeigt einen 6-stelligen Code.
In einem TV-Browser: Öffne die Bildschirmseite. Sie zeigt den Code und einen QR-Code, der zur Handy-Seite führt.
Auf dem Handy: Scan den QR-Code oder öffne die Handy-Seite, gib den Code ein, falls er nicht schon eingetragen ist, und bestätige mit einem Tipp als der auf dem Handy bereits angemeldete Jellyfin-Benutzer oder mit Benutzername und Passwort. Der Fernseher meldet sich von selbst an.
Noch kein Konto? Mit installiertem Registration by MediaLab zeigt die Handy-Seite einen Link zum Erstellen eines Kontos.
Das Panel listet die letzten Bestätigungen (wann, wer und wie bestätigt).

Fehlerbehebung

„Quick Connect is not available on this server": Schalte Quick Connect in Jellyfin ein (das Panel hat einen Button dafür) und prüfe, dass die Lizenz des Plugins aktiv ist.
„The code is not valid or has expired": Prüfe die Ziffern auf dem Fernseher; Jellyfins Codes laufen nach einer Weile ab. Bitte die App um einen neuen.
„Too many attempts": Warte 10 Minuten; die Sperre gilt für die Adresse, von der die falschen Versuche kamen.
„The account is disabled" oder Administrator-Konten abgelehnt: Das Konto ist in Jellyfin deaktiviert, oder Administratoren dürfen im Plugin nicht bestätigen.