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

Ein Passwort mit der Fernbedienung einzutippen ist der lästigste Teil, wenn Emby im Haushalt läuft. Es ist langsam, fehleranfällig, und am Ende teilt jemand ein Kontopasswort im Chat, das du dann ändern musst. Quick Connect nimmt dir diesen Schritt ab: Der Bildschirm zeigt einen 6-stelligen Code und einen QR-Code, der Benutzer bestätigt auf dem Handy, und der Bildschirm meldet sich von selbst an. In den offiziellen Emby-Apps, wo es keine Bildschirmseite gibt, kann jeder Benutzer optional einen Einmalcode aktivieren und ihn im Passwortfeld eingeben.

Diese Anleitung führt durch Installation, Einrichtung und den Alltag. Sie ist für Leute geschrieben, die Emby bereits auf einem eigenen Server betreiben, unter Linux, Windows oder in Docker.

Voraussetzungen

• Emby Server 4.10.1 oder neuer. Ältere Versionen werden nicht unterstützt.
• Ein MediaLab Works Konto mit aktiver Lizenz, einer Lifetime-Lizenz innerhalb ihres Update-Zeitraums oder der kostenlosen 30-Tage-Testversion, damit du die Plugin-DLL herunterladen kannst.
• Für die Schaltfläche auf dem Anmeldebildschirm von Emby Web: Schreibzugriff auf Embys dashboard-ui/index.html. Kann Emby diese Datei nicht schreiben, zeigt das Panel den genauen Befehl, den du auf dem Server ausführen musst. Die Handy- und Bildschirmseiten funktionieren auch ohne die Schaltfläche.

Schritt 1: Plugin installieren

1. Melde dich in deinem MediaLab Works Konto an, öffne Licenses und lade die Plugin-DLL herunter.
2. Kopiere die DLL in den Plugin-Ordner von Emby und starte Emby Server neu:
   • Linux (Paket): /var/lib/emby/plugins/
   • Docker: der Ordner plugins in deinem Emby-Konfigurationsvolume
   • Windows: %AppData%\Emby-Server\programdata\plugins\
3. Öffne Quick Connect im Emby-Dashboard-Menü, klicke auf License und füge deinen Lizenzschlüssel ein, um zu aktivieren, oder gib deine E-Mail-Adresse ein, um die Testversion zu starten. Sobald der Schlüssel an diesen Server gebunden ist, zeigt die Seite die Lizenz als Active an.

Die Lizenz wird einmal täglich und bei jedem Emby-Start geprüft. Ohne Internet läuft das Plugin nach der letzten erfolgreichen Prüfung noch 7 Tage weiter; danach stoppt es, bis es wieder prüfen kann. Ist die Lizenz ungültig, sind die Handy- und Bildschirmseiten nicht verfügbar und App-Codes werden nicht angenommen, aber alle können sich weiterhin mit ihrem normalen Passwort anmelden.

Schritt 2: Einstellungen konfigurieren

Öffne Quick Connect im Emby-Dashboard und gehe den Tab Settings durch:

• Phone sign-in is active: aktiviert die Handy- und Bildschirmseiten.
• Approval from the phone with username + password too: lass es an für Handys, auf denen Emby nicht angemeldet ist, oder schalte es aus, damit nur Freigaben von einem Handy mit bestehender Emby-Sitzung erlaubt sind.
• One-time codes for Emby apps: erlaubt jedem Benutzer, App-Codes auf der Handyseite einzuschalten.
• Administrator accounts cannot sign in with a code: standardmäßig aus; überlege, es einzuschalten.
• Screen code validity: standardmäßig 5 Minuten, einstellbar von 1 bis 15.
• New account created from the phone: standardmäßig aus. Es braucht Registration 1.10.5 oder neuer, und mit einer älteren Registration hat es keine Wirkung.

Schritt 3: Schaltfläche auf dem Anmeldebildschirm hinzufügen

Klicke im Tab Button on the sign-in screen auf Apply. Das Plugin schreibt eine Zeile in Embys dashboard-ui/index.html, legt eine Kopie als index.html.before-quickconnect an und fügt die Schaltfläche nach einem Emby-Update wieder hinzu. Gehört die Datei root und kann Emby sie nicht schreiben, zeigt die Seite den genauen Befehl zum Ausführen; Remove nimmt die Schaltfläche wieder heraus.

Schritt 4: Die beiden Adressen notieren

Der Tab How to use zeigt die Adressen auf deinem Server:

• Bildschirmseite: /emby/QuickConnect/Screen
• Handyseite: /emby/QuickConnect/Page

Schritt 5: Am TV-Browser oder Computer anmelden

1. Klicke auf dem Emby-Anmeldebildschirm auf Sign in with your phone, oder öffne die Bildschirmseite. Der Bildschirm zeigt einen 6-stelligen Code und einen QR-Code.
2. Scanne auf dem Handy den QR-Code, oder öffne die Handyseite und tippe den Code ein.
3. Prüfe den Namen des wartenden Geräts und bestätige dann mit einem Tippen als der Emby-Benutzer, der auf dem Handy bereits angemeldet ist, oder nutze Another account mit Benutzername und Passwort.
4. Der Bildschirm meldet sich von selbst an und wird an die vom Admin festgelegte Adresse weitergeleitet (Standard: die Web-Oberfläche des Servers).

Schritt 6: Einmalcodes für die offiziellen Emby-Apps

Auf Fernsehern und Konsolen, wo die offizielle Emby-App der einzige Client ist, gibt es keine Bildschirmseite. Der Einmalcode deckt diesen Fall ab:

1. Öffne auf dem Handy die Handyseite, während du bei Emby angemeldet bist, und schalte einmal codes for my account ein.
2. Klicke auf Show a code, wann immer du einen brauchst.
3. Melde dich in der Emby-App mit deinem Benutzernamen an und tippe den 6-stelligen Code in das Passwortfeld.

Der Code ist 5 Minuten gültig und funktioniert einmal. Das ist pro Benutzer optional, und das normale Passwort funktioniert weiterhin. Wird das Plugin entfernt oder endet die Lizenz, prüft Emby wieder selbst das normale Passwort.

Sicherheitshinweise

• Bildschirmcodes sind zufällig, nur einmal nutzbar, und nur der Bildschirm, der den Code angefordert hat, erhält die Sitzung. Pro Adresse können höchstens 5 Codes gleichzeitig warten.
• 10 falsche Versuche von einer Adresse innerhalb von 10 Minuten sperren diese Adresse für 10 Minuten; ein Einmalcode für Apps wird nach 5 falschen Versuchen ungültig.
• Deaktivierte Konten werden abgelehnt, ebenso Konten ohne Fernzugriff, wenn der Bildschirm außerhalb deines lokalen Netzwerks steht.
• Einmalcodes für Apps werden nur als Hash im Speicher abgelegt: Ein Neustart von Emby macht alle wartenden Codes ungültig.
• Jede Anmeldung per Code wird mit Benutzer, Gerät, App und der Person, die freigegeben hat, protokolliert.
• QR-Codes werden auf dem Server erzeugt; der einzige externe Dienst ist der Lizenz-Client. Sitzungstokens werden vor der Weiterleitung im Browser-Speicher abgelegt und nie in die URL geschrieben.

Tipps und Fehlerbehebung

• Die Schaltfläche erscheint nicht auf dem Anmeldebildschirm: Wende sie im Panel an, führe den angezeigten Befehl aus, wenn Emby die Datei nicht schreiben kann, und lade dann die Anmeldeseite neu. Nach einem Emby-Update setzt das Plugin sie beim Start wieder ein; schlägt das fehl, zeigt das Panel den Fehler.
• „The code is not valid or has expired“: Prüfe die Ziffern auf dem Bildschirm; Codes gelten nur wenige Minuten und funktionieren einmal. Fordere am Bildschirm einen neuen an.
• „Too many attempts“: Warte 10 Minuten; die Sperre gilt für die Adresse, von der die falschen Versuche kamen.
• „The account is not allowed to sign in from outside the local network“: Das Konto hat in Emby keinen Fernzugriff, und der Bildschirm steht außerhalb deines Netzwerks.
• Der App-Code wird abgelehnt: Schalte zuerst die Codes für das Konto ein, nutze einen frischen Code und prüfe, ob Einmalcodes im Panel aktiviert sind.
• Sitzung beenden: Nutze dazu Embys eigene Seite Devices.

Das Admin-Panel listet außerdem die Benutzer mit App-Codes und die letzten Anmeldungen auf, sodass du siehst, wer sich von welchem Gerät und welcher App angemeldet hat und wie die Freigabe erfolgte.

Fazit

Quick Connect macht aus der Anmeldung am Fernseher statt Tippen mit der Fernbedienung ein Scannen und ein Tippen und gibt den offiziellen Apps einen Weg über Einmalcodes, ohne das normale Passwort zu schwächen. Installiere es, stelle die Gültigkeitsdauer der Codes und die Admin-Sperre nach deinem Geschmack ein, wende die Anmelde-Schaltfläche an, und deine Benutzer hören auf, dich nach Passwörtern zu fragen. Die vollständige Anleitung steht im user guide; die Produktseite enthält die Funktionsliste, und das changelog verfolgt Änderungen. Fragen sind willkommen unter contact, und die knowledge base und FAQ decken den Rest unserer Plugins ab.