Quick Connect pour Emby — guide

Installation

Vous avez besoin d’Emby Server 4.10.1 ou plus récent.

1. Connectez-vous à votre compte MediaLab Works, ouvrez Licenses et téléchargez la DLL du plugin (disponible avec un abonnement actif, une licence à vie dans sa période de mises à jour, ou pendant l’essai gratuit de 30 jours).
2. Copiez la DLL dans le dossier des plugins Emby et redémarrez Emby Server :
   • Linux (paquet) : /var/lib/emby/plugins/
   • Docker : le dossier plugins dans votre volume de configuration Emby
   • Windows : %AppData%\Emby-Server\programdata\plugins\
3. Ouvrez Quick Connect dans le menu du tableau de bord Emby et cliquez sur License. Collez votre clé de licence et activez-la, ou saisissez votre e-mail pour démarrer l’essai gratuit de 30 jours ou acheter une licence. Le plugin contacte le serveur de licences, lie la clé à ce serveur Emby et affiche la licence comme Active.

La licence est vérifiée une fois par jour (et à chaque démarrage d’Emby). Sans internet, le plugin continue de fonctionner 7 jours après la dernière vérification réussie ; après cela, il est arrêté jusqu’à pouvoir revérifier.

Licence

Sans licence valide, Quick Connect est arrêté : les pages téléphone et écran ne sont pas disponibles, aucun code n’est délivré et les codes à usage unique des applications ne sont pas acceptés. Les utilisateurs qui avaient activé les codes d’application se connectent simplement avec leur mot de passe normal, qu’Emby vérifie comme d’habitude. Seule la page License continue de fonctionner (vous pouvez y démarrer l’essai, acheter, saisir la clé ou mettre à jour). Les paramètres et le journal de connexion sont conservés, et tout reprend dès que la licence redevient valide.

Avec une licence valide, la même page peut installer une mise à jour ou revenir à la version précédente si une mise à jour pose problème. Redémarrez Emby après l’une ou l’autre opération.

Configuration

Ouvrez Quick Connect dans le tableau de bord Emby.

1. Settings :
   • Phone sign-in is active : les pages téléphone et écran.
   • Approval from the phone with username + password too, pour les téléphones où Emby n’est pas connecté. Désactivez-la pour n’autoriser que les approbations depuis un téléphone qui a déjà une session Emby.
   • One-time codes for Emby apps : permet à chaque utilisateur d’activer les codes d’application depuis la page téléphone.
   • Administrator accounts cannot sign in with a code : désactivé par défaut.
   • Screen code validity : 5 minutes par défaut, de 1 à 15.
   • New account created from the phone: the screen signs in by itself once the account is active : désactivé par défaut. Nécessite Registration 1.10.5 ou plus récent ; avec un Registration plus ancien, il n’a aucun effet.
2. Button on the sign-in screen : cliquez sur Apply pour ajouter Sign in with your phone à l’écran de connexion Emby Web. Le plugin écrit une ligne dans le dashboard-ui/index.html d’Emby (en gardant une copie sous index.html.before-quickconnect) et le rajoute après les mises à jour d’Emby. Si le fichier appartient à root et qu’Emby ne peut pas l’écrire, la page affiche la commande exacte à exécuter sur le serveur ; Remove retire le bouton.
3. How to use affiche les deux adresses de votre serveur : la page écran (/emby/QuickConnect/Screen) et la page téléphone (/emby/QuickConnect/Page).

Utilisation quotidienne

• Sur un navigateur de TV ou un ordinateur : sur l’écran de connexion Emby, cliquez sur Sign in with your phone (ou ouvrez la page écran). L’écran affiche un code à 6 chiffres et un code QR.
• Sur le téléphone : scannez le code QR (ou ouvrez la page téléphone et tapez le code), vérifiez le nom de l’appareil qui attend, puis approuvez en un geste en tant qu’utilisateur Emby déjà connecté sur le téléphone, ou avec Another account et un nom d’utilisateur et un mot de passe. L’écran se connecte tout seul.
• Dans les applications Emby officielles (TV, consoles) : l’utilisateur ouvre la page téléphone en étant connecté à Emby, active une fois codes for my account, puis clique sur Show a code quand nécessaire. Dans l’application Emby, il se connecte avec son nom d’utilisateur et tape le code à 6 chiffres dans le champ du mot de passe. Le code est valable 5 minutes et fonctionne une fois ; le mot de passe normal continue de fonctionner.
• Pas encore de compte ? Avec Registration installé, la page téléphone affiche un lien pour en créer un. Si le paramètre ci-dessus est activé, l’écran garde son code pendant la création du compte, jusqu’à 60 minutes, et affiche qu’un compte est en cours de création sur le téléphone. Il se connecte comme nouvel utilisateur dès que le compte est actif : immédiatement, après approbation par un administrateur, ou après paiement avec Cashier. Les vérifications habituelles s’appliquent toujours à cette connexion (compte désactivé, blocage par un administrateur, accès distant).
• Le panneau liste les utilisateurs avec codes d’application et les connexions récentes (utilisateur, appareil, application et comment elles ont été approuvées). Pour terminer une session, utilisez la page Devices d’Emby.

Dépannage

• Le bouton n’apparaît pas sur l’écran de connexion : appliquez-le depuis le panneau, exécutez la commande affichée si Emby ne peut pas écrire le fichier, puis rechargez la page de connexion. Après une mise à jour d’Emby, le plugin le remet au démarrage ; si cela échoue, le panneau affiche l’erreur.
• « The code is not valid or has expired » : vérifiez les chiffres à l’écran ; les codes durent quelques minutes et fonctionnent une fois. Demandez un nouveau code à l’écran.
• « Too many attempts » : attendez 10 minutes ; le blocage s’applique à l’adresse qui a fait les tentatives erronées.
• « The account is not allowed to sign in from outside the local network » : le compte n’a pas d’accès distant dans Emby et l’écran est hors de votre réseau.
• Le code d’application est refusé : activez d’abord les codes pour le compte, utilisez un code frais (5 minutes, une fois) et vérifiez que les codes à usage unique sont activés dans le panneau.