Quick Connect für Emby — Anleitung

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 bei einem aktiven Abonnement, einer Lifetime-Lizenz innerhalb ihres Update-Zeitraums oder während des kostenlosen 30-tägigen Testzeitraums).
Kopiere die DLL in den Emby-Plugins-Ordner und starte Emby Server neu:
- Linux (Paket): /var/lib/emby/plugins/
- Docker: der Ordner plugins in deinem Emby-Konfigurations-Volume
- Windows: %AppData%\Emby-Server\programdata\plugins\
Öffne Quick Connect im Emby-Dashboard-Menü und klicke auf License. Füge deinen Lizenzschlüssel ein und aktiviere ihn, oder gib deine E-Mail-Adresse ein, um den kostenlosen 30-tägigen Testzeitraum zu starten oder eine Lizenz zu kaufen. Das Plugin kontaktiert den Lizenzserver, bindet den Schlüssel an diesen Emby-Server und zeigt die Lizenz als Active an.

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

Lizenz

Ohne gültige Lizenz wird Quick Connect gestoppt: Die Handy- und Bildschirmseiten sind nicht verfügbar, kein Code wird ausgestellt und die Einmal-Codes für Apps werden nicht akzeptiert. Benutzer, die App-Codes aktiviert hatten, melden sich einfach mit ihrem normalen Passwort an, das Emby wie üblich prüft. Nur die Seite License funktioniert weiter (dort kannst du den Test starten, kaufen, den Schlüssel eingeben oder aktualisieren). Einstellungen und das Anmeldeprotokoll bleiben erhalten, und alles läuft weiter, sobald die Lizenz wieder gültig ist.

Mit gültiger Lizenz kann dieselbe Seite ein Update installieren oder bei Problemen ein Rollback auf die vorherige Version ausführen. Starte Emby danach in beiden Fällen neu.

Konfiguration

Öffne Quick Connect im Emby-Dashboard.

Settings:
- Phone sign-in is active: die Handy- und Bildschirmseiten.
- Approval from the phone with username + password too, für Handys, auf denen Emby nicht angemeldet ist. Schalte es aus, um nur Freigaben von einem Handy mit bestehender Emby-Sitzung zu erlauben.
- One-time codes for Emby apps: lässt jeden Benutzer App-Codes auf der Handyseite aktivieren.
- Administrator accounts cannot sign in with a code: standardmäßig aus.
- Screen code validity: standardmäßig 5 Minuten, von 1 bis 15.
- New account created from the phone: the screen signs in by itself once the account is active: standardmäßig aus. Es braucht Registration 1.10.5 oder neuer; mit einer älteren Registration hat es keine Wirkung.
Button on the sign-in screen: Klicke auf Apply, um Sign in with your phone zum Anmeldebildschirm von Emby Web hinzuzufügen. Das Plugin schreibt eine Zeile in Embys dashboard-ui/index.html (und bewahrt eine Kopie als index.html.before-quickconnect) und fügt sie nach Emby-Updates erneut hinzu. Wenn die Datei root gehört und Emby sie nicht schreiben kann, zeigt die Seite den genauen Befehl, den du auf dem Server ausführen musst; Remove nimmt den Button wieder heraus.
How to use zeigt die beiden Adressen auf deinem Server: die Bildschirmseite (/emby/QuickConnect/Screen) und die Handyseite (/emby/QuickConnect/Page).

Tägliche Nutzung

Am TV-Browser oder Computer: 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.
Auf dem Handy: Scanne den QR-Code (oder öffne die Handyseite und tippe den Code ein), prüfe den Namen des wartenden Geräts und stimme dann mit einem Fingertipp als der auf dem Handy bereits angemeldete Emby-Benutzer zu — oder mit Another account und Benutzernamen und Passwort. Der Bildschirm meldet sich von selbst an.
In den offiziellen Emby-Apps (TVs, Konsolen): Der Benutzer öffnet die Handyseite, während er bei Emby angemeldet ist, aktiviert einmalig codes for my account und klickt dann bei Bedarf auf Show a code. In der Emby-App meldet er sich mit seinem Benutzernamen an und tippt den 6-stelligen Code in das Passwortfeld. Der Code ist 5 Minuten gültig und funktioniert einmal; das normale Passwort funktioniert weiter.
Noch kein Konto? Mit installiertem Registration zeigt die Handyseite einen Link zum Erstellen eines Kontos. Wenn die obige Einstellung aktiv ist, behält der Bildschirm seinen Code, während das Konto erstellt wird — bis zu 60 Minuten — und zeigt an, dass auf dem Handy ein Konto erstellt wird. Er meldet sich als neuer Benutzer an, sobald das Konto aktiv ist: sofort, nachdem ein Administrator es freigegeben hat oder nach der Zahlung mit Cashier. Die üblichen Prüfungen gelten auch für diese Anmeldung (deaktiviertes Konto, Administrator-Sperre, Remote-Zugriff).
Das Panel listet die Benutzer mit App-Codes und die letzten Anmeldungen (Benutzer, Gerät, App und wie zugestimmt wurde). Um eine Sitzung zu beenden, nutze Embys eigene Seite Devices.

Fehlersuche

Der Button erscheint nicht auf dem Anmeldebildschirm: Füge ihn über das Panel hinzu, führe den angezeigten Befehl aus, falls Emby die Datei nicht schreiben kann, und lade die Anmeldeseite neu. Nach einem Emby-Update setzt das Plugin ihn beim Start wieder ein; wenn das fehlschlägt, zeigt das Panel den Fehler.
"The code is not valid or has expired": Prüfe die Ziffern auf dem Bildschirm; Codes halten ein paar Minuten und funktionieren einmal. Bitte den Bildschirm um einen neuen.
"Too many attempts": Warte 10 Minuten; die Sperre gilt für die Adresse, die die falschen Versuche gemacht hat.
"The account is not allowed to sign in from outside the local network": Das Konto hat keinen Remote-Zugriff in Emby und der Bildschirm befindet sich außerhalb deines Netzwerks.
Der App-Code wird verweigert: Aktiviere zuerst die Codes für das Konto, nutze einen frischen Code (5 Minuten, einmal) und prüfe, dass Einmal-Codes im Panel aktiviert sind.