Jellyfin am Fernseher ohne Passwort anmelden: QR-Code und Freigabe per Handy

Wenn du Jellyfin für einen Haushalt betreibst, kennst du den unangenehmsten Moment des Abends: Jemand öffnet die App am Fernseher, der Anmeldebildschirm erscheint, und das Passwort muss mit der Fernbedienung eingegeben werden. Pfeiltasten, Bildschirmtastatur, ein falsches Zeichen, von vorn. Das ist der häufigste Grund, warum dich jemand bittet, ihn doch „einfach anzumelden“ auf deinem Server.

Jellyfin bringt bereits sein eigenes Quick Connect mit: Die App am Fernseher zeigt einen 6-stelligen Code, und ein angemeldeter Benutzer bestätigt ihn an anderer Stelle. Der unangenehme Teil ist das Wo – diesen Bildschirm tief in den Jellyfin-Einstellungen auf dem Handy zu finden, ist für die meisten nicht offensichtlich. Quick Connect by MediaLab setzt eine kurze Handyseite mit QR-Code vor diesen Ablauf, dazu einen Code- und QR-Bildschirm für TV-Browser. Diese Anleitung führt durch Installation, Einrichtung und die Hilfe für deine Benutzer, wenn etwas nicht funktioniert.

Was das löst

Das Plugin setzt auf Jellyfins nativem Quick Connect auf und ersetzt es nicht. Die Codes werden von Jellyfin selbst erzeugt und laufen dort ab; das Plugin bestätigt sie nur. Das hat eine praktische Konsequenz, die ich als Self-Hoster mag: Wenn du das Plugin irgendwann entfernst, ist kein Konto ausgesperrt, weil die Passwörter genau so bleiben, wie Jellyfin sie verwaltet. Es gibt bewusst keinen Einmalcode, den man statt eines Passworts eingibt (anders als bei der Emby-Version des Produkts) – jede Anmeldung läuft über Jellyfins eigenes Quick Connect.

Das bekommst du:

• Eine Handyseite (/Connect/Page auf deiner Jellyfin-Adresse) mit QR-Code, die den Quick-Connect-Code jeder Jellyfin-App bestätigt: Android TV, Fire TV, webOS, Tizen, Roku, iOS oder Jellyfin Web.
• Einen Code- und QR-Bildschirm für TV-Browser (/Connect/Screen), der den Code und einen QR-Code zur Handyseite zeigt; nach der Bestätigung meldet er sich selbst bei Jellyfin Web an.
• Einen Admin-Bereich im Jellyfin-Dashboard mit Quick-Connect-Status, Einstellungen und den letzten Bestätigungen.

Voraussetzungen

• Jellyfin Server 12.2 oder neuer (Linux, Windows oder Docker).
• Quick Connect in Jellyfin aktiviert (Dashboard → General). Die Plugin-Seite zeigt den Status und kann es für dich einschalten.
• Ein MediaLab-Works-Konto mit einer Lizenz, die das Plugin abdeckt – ein aktives Abo, eine Lifetime-Lizenz innerhalb ihres Update-Fensters, das Jellyfin-Bundle oder die kostenlose 30-Tage-Testversion.

Schritt 1 – Plugin installieren

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

1. Öffne in deinem MediaLab-Works-Konto Licenses → Jellyfin plugin repository und klicke auf Create address. Kopiere die Adresse – sie enthält ein Token, halte sie also geheim; du kannst sie jederzeit neu erzeugen oder widerrufen.
2. Öffne in Jellyfin Dashboard → Plugins → Repositories, klicke auf +, gib einen Namen an (zum Beispiel MediaLab Works), füge die Adresse ein und speichere.
3. Suche unter Dashboard → Plugins → Catalog nach Quick Connect by MediaLab, klicke auf Install und starte Jellyfin neu.

Aus dem öffentlichen Katalog. https://medialab.works/jellyfin/manifest.json listet jedes veröffentlichte MediaLab-Works-Plugin mit seinem öffentlichen Build. Füge ihn genauso hinzu, wenn du installieren willst, bevor du einen Schlüssel hast; das Plugin fragt dann auf seiner License-Seite nach der Lizenz oder startet die Testversion.

Manuell aus einem Zip. Lade jf-quickconnect_x.y.z.zip unter Account → Licenses herunter (die SHA-256 steht neben dem Button), entpacke es in einen neuen Ordner Quick Connect by MediaLab_x.y.z.0 im Jellyfin-Plugin-Ordner – /var/lib/jellyfin/plugins/ bei einer Linux-Paketinstallation, /config/plugins/ im Config-Volume des offiziellen Docker-Images, %ProgramData%\Jellyfin\Server\plugins\ unter Windows – und starte Jellyfin neu.

Schritt 2 – Lizenz aktivieren

1. Öffne Dashboard → Plugins → Quick Connect by MediaLab und klicke auf License.
2. Füge deinen Lizenzschlüssel ein und klicke auf Activate with key. Das Plugin kontaktiert den Lizenzserver, bindet den Schlüssel an diesen Server und zeigt die Lizenz als Active an.
3. Noch kein Schlüssel? Gib auf derselben Seite deine E-Mail-Adresse ein, um die 30-tägige kostenlose Testversion zu starten, oder kaufe eine Lizenz; das Plugin aktiviert sich selbst, sobald die Zahlung abgeschlossen ist.

Die Lizenz wird einmal täglich und bei jedem Jellyfin-Start geprüft. Ohne Internet funktioniert das Plugin noch 7 Tage nach der letzten erfolgreichen Prüfung. Wenn du den Server wechselst, gibt Move license (release this server) auf derselben Seite den Schlüssel frei.

Schritt 3 – Prüfen, ob Quick Connect aktiv ist

Öffne Quick Connect im Menü des Jellyfin-Dashboards. Das erste Panel zeigt, ob Jellyfins eigenes Quick Connect aktiviert ist. Steht dort, es sei aus, klicke auf Turn on Quick Connect (oder erledige es unter Dashboard → General). Solange es aus ist, können Jellyfin-Apps gar keine Codes anfordern – das ist also das Erste, was du prüfst, wenn ein Benutzer ein Problem meldet.

Schritt 4 – Einstellungen festlegen

Im selben Panel:

• The phone and screen pages are active – dein Hauptschalter für die eigenen Seiten des Plugins.
• Approval from the phone with username + password too – nützlich für Handys, auf denen Jellyfin nicht angemeldet ist. Schalte es aus, wenn Bestätigungen nur von einem Handy mit bestehender Jellyfin-Sitzung kommen sollen.
• Administrator accounts cannot approve through the phone page – standardmäßig aus; sinnvoll einzuschalten, wenn Admin-Konten aus dem Anmeldeweg am TV herausbleiben sollen.

Unter How to use findest du die beiden Adressen auf deinem Server: die Handyseite (/Connect/Page) und die Bildschirmseite (/Connect/Screen). Teile die Adresse der Handyseite mit deinen Benutzern oder lege ihren QR-Code neben den Fernseher. Die vollständige Anleitung steht im Benutzerhandbuch.

Schritt 5 – Deinen Benutzern zeigen, wie es geht

In einer Jellyfin-App am Fernseher (Android TV, Fire TV, webOS, Tizen, Roku und die anderen): Wähle auf dem 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 Handyseite führt.

Auf dem Handy: Scanne den QR-Code oder öffne die Handyseite, gib den Code ein, falls er nicht schon eingetragen ist, und bestätige dann mit einem Tippen als der Jellyfin-Benutzer, der auf dem Handy bereits angemeldet ist, oder mit Benutzername und Passwort. Der Fernseher meldet sich selbst an.

Noch kein Konto? Mit installiertem Registration zeigt die Handyseite einen Link zum Anlegen eines Kontos – praktisch, wenn jemand neu im Haushalt ist und du ihn nicht auch noch durch eine TV-Tastatur führen willst.

Sicherheitshinweise, die du kennen solltest

• Die Codes sind Jellyfins eigene: Jellyfin erzeugt sie, und sie laufen von selbst ab. Das Plugin bestätigt sie nur.
• 10 falsche Versuche (falsche Codes oder falsche Passwörter) von einer Adresse innerhalb von 10 Minuten sperren diese für 10 Minuten.
• Deaktivierte Konten werden abgelehnt, und optional können Administrator-Konten nicht über die Handyseite bestätigen.
• Handy- und Bildschirmseite werden mit einer strikten Content-Security-Policy ausgeliefert und senden keinen Referrer.
• Jede Bestätigung wird mit Benutzer, Adresse und Art der Bestätigung protokolliert; das Panel listet die letzten Bestätigungen.

Zu den Daten: QR-Codes werden auf dem Server erzeugt, und Bildschirm- und Handyseite laden nur die Dateien des Plugins. Ausstehende Codes liegen im Speicher; state/approvals.json behält die letzten 500 Bestätigungen (Zeit, Benutzer, Gerät, App, IP, Methode). Passwörter und Tokens werden nie an Dritte gesendet. Nach der Anmeldung werden Fernseher oder Browser an die vom Admin festgelegte Adresse weitergeleitet (standardmäßig die Web-Oberfläche des Servers), und das Sitzungs-Token wird vor der Weiterleitung im Browser-Speicher abgelegt, nie in die URL geschrieben. Lokale und externe Adressen sind ausschließlich HTTPS.

Tipps und 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, ob die Lizenz des Plugins aktiv ist.

„The code is not valid or has expired.“ Prüfe die Ziffern am Fernseher; Jellyfins Codes laufen nach einer Weile ab. Lass dir von der App einen neuen geben.

„Too many attempts.“ Warte 10 Minuten. Die Sperre gilt pro Adresse, ein gemeinsames NAT kann also mehrere Benutzer gleichzeitig treffen – wenn das oft passiert, prüfe, ob jemand wiederholt den falschen Code eingibt, statt anzunehmen, das Plugin sei defekt.

Lifetime-Lizenz und automatische Updates. Der öffentliche Katalog bietet immer die neueste Version. Ist das Update-Fenster einer Lifetime-Lizenz abgelaufen, sind danach veröffentlichte Versionen nicht lizenziert: Installiert Jellyfins automatische Plugin-Aktualisierung eine solche, stoppt das Plugin mit „version not licensed“, bis du auf seiner License-Seite Roll back to x.y.z verwendest oder einen Update-Pass kaufst. Um das zu vermeiden, nutze dein privates Repository, das nur die Versionen anbietet, die deine Lizenz erlaubt, oder entferne die Auslöser der geplanten Aufgabe Update Plugins unter Dashboard → Scheduled Tasks (das stoppt automatische Updates für alle Plugins).

Nach einem Update ist etwas kaputt. Auf der License-Seite installiert Roll back to x.y.z die vorherige Version; starte Jellyfin danach neu. Das schaltet Jellyfins automatisches Update für das Plugin bis zum nächsten Install update ab, sodass die tägliche Aufgabe die neuere Version nicht zurückbringt.

Client-Abdeckung. Der Ablauf mit Bildschirm und Handy wurde in Chrome mit einem Philips-NETTV-User-Agent emuliert (25/25), aber nicht auf physischen Fernsehern getestet. Das Bestätigen von Codes aus nativen Quick-Connect-Apps wurde über die API mit dem Client „Jellyfin Android TV“ simuliert; echtes Android TV, Swiftfin, Findroid, Kodi/JellyCon, Infuse und Streamyfin wurden nicht getestet. Wenn sich ein bestimmter Client seltsam verhält, ist das nützliches Feedback – sag uns Bescheid.

Fazit

Ein Passwort mit der Fernbedienung einzugeben ist Reibung, die du entfernen kannst, ohne etwas zu schwächen: Die Codes bleiben Jellyfins, die Passwörter bleiben Jellyfins, und das Plugin macht nur den Bestätigungsschritt offensichtlich. Installiere es aus deinem privaten Repository, schalte Quick Connect im Dashboard ein, entscheide, ob Bestätigungen vom Handy auch mit Benutzername + Passwort erlaubt sind, und lege die Adresse der Handyseite dort ab, wo deine Benutzer sie finden. Mehr Details auf der Produktseite, im Changelog für Versions- und Quellcode-Hinweise sowie in unserer Wissensdatenbank und den FAQ für den Rest des Stacks.