Se connecter à Emby sur la TV sans taper le mot de passe : QR code et validation sur mobile

Taper un mot de passe avec la télécommande d’une TV est la partie la plus pénible quand on fait tourner Emby pour un foyer. C’est lent, source d’erreurs, et cela finit souvent par un mot de passe de compte partagé dans une conversation, qu’il faut ensuite changer. Quick Connect supprime cette étape : l’écran affiche un code à 6 chiffres et un QR code, l’utilisateur approuve depuis son téléphone, et l’écran se connecte tout seul. Pour les applications officielles Emby, où il n’existe pas de page d’écran, chaque utilisateur peut activer un code de connexion à usage unique saisi dans le champ mot de passe.

Ce tutoriel couvre l’installation, la configuration et l’usage quotidien. Il s’adresse aux personnes qui font déjà tourner Emby sur leur propre serveur, sous Linux, Windows ou dans Docker.

Prérequis

• Emby Server 4.10.1 ou plus récent. Les versions plus anciennes ne sont pas prises en charge.
• Un compte MediaLab Works avec une licence active, une licence à vie dans sa fenêtre de mise à jour, ou l’essai gratuit de 30 jours, pour pouvoir télécharger la DLL du plugin.
• Pour le bouton sur l’écran de connexion d’Emby Web : un accès en écriture au fichier dashboard-ui/index.html d’Emby. Si Emby ne peut pas écrire ce fichier, le panneau affiche la commande exacte à lancer sur le serveur. Les pages téléphone et écran fonctionnent sans le bouton.

Étape 1 : installer le plugin

1. Connectez-vous à votre compte MediaLab Works, ouvrez Licenses et téléchargez la DLL du plugin.
2. Copiez la DLL dans le dossier des plugins d’Emby et redémarrez Emby Server :
   • Linux (paquet) : /var/lib/emby/plugins/
   • Docker : le dossier plugins dans le volume de configuration d’Emby
   • Windows : %AppData%\Emby-Server\programdata\plugins\
3. Ouvrez Quick Connect dans le menu du tableau de bord Emby, cliquez sur License, puis collez votre clé de licence pour l’activer, ou saisissez votre e-mail pour démarrer l’essai. La page affiche la licence comme Active une fois la clé liée à ce serveur.

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 ; passé ce délai, il s’arrête jusqu’à ce qu’il puisse vérifier à nouveau. Si la licence n’est pas valide, les pages téléphone et écran sont indisponibles et les codes d’application ne sont pas acceptés, mais chacun peut toujours se connecter avec son mot de passe habituel.

Étape 2 : configurer les paramètres

Ouvrez Quick Connect dans le tableau de bord Emby et parcourez l’onglet Settings :

• Phone sign-in is active : active les pages téléphone et écran.
• Approval from the phone with username + password too : laissez activé pour les téléphones où Emby n’est pas connecté, ou désactivez-le pour n’autoriser que les approbations depuis un téléphone déjà connecté à 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 ; envisagez de l’activer.
• Screen code validity : 5 minutes par défaut, réglable de 1 à 15.
• New account created from the phone : désactivé par défaut. Nécessite Registration 1.10.5 ou plus récent ; avec une version plus ancienne de Registration, l’option n’a aucun effet.

Étape 3 : ajouter le bouton à l’écran de connexion

Dans l’onglet Button on the sign-in screen, cliquez sur Apply. Le plugin écrit une ligne dans le fichier dashboard-ui/index.html d’Emby, en conserve une copie sous index.html.before-quickconnect, et remet le bouton après une mise à jour d’Emby. Si le fichier appartient à root et qu’Emby ne peut pas l’écrire, la page affiche la commande exacte à lancer ; Remove retire le bouton.

Étape 4 : noter les deux adresses

L’onglet How to use affiche les adresses sur votre serveur :

• Page écran : /emby/QuickConnect/Screen
• Page téléphone : /emby/QuickConnect/Page

Étape 5 : se connecter sur un navigateur de TV ou un ordinateur

1. Sur l’écran de connexion d’Emby, cliquez sur Sign in with your phone, ou ouvrez la page écran. L’écran affiche un code à 6 chiffres et un QR code.
2. Sur le téléphone, scannez le QR code, ou ouvrez la page téléphone et saisissez le code.
3. Vérifiez le nom de l’appareil en attente, puis approuvez en un geste en tant qu’utilisateur Emby déjà connecté sur le téléphone, ou utilisez Another account avec un identifiant et un mot de passe.
4. L’écran se connecte tout seul et est redirigé vers l’adresse définie par l’administrateur (par défaut : l’interface web du serveur).

Étape 6 : codes à usage unique pour les applications officielles Emby

Sur les TV et consoles où l’application officielle Emby est le seul client, il n’y a pas de page écran. Le code à usage unique couvre ce cas :

1. Sur le téléphone, ouvrez la page téléphone en étant connecté à Emby et activez une fois codes for my account.
2. Cliquez sur Show a code quand vous en avez besoin.
3. Dans l’application Emby, connectez-vous avec votre identifiant et saisissez le code à 6 chiffres dans le champ mot de passe.

Le code est valable 5 minutes et ne fonctionne qu’une fois. L’activation se fait par utilisateur, et le mot de passe habituel continue de fonctionner. Si le plugin est retiré ou si la licence prend fin, Emby revient de lui-même à la vérification du mot de passe habituel.

Notes de sécurité

• Les codes d’écran sont aléatoires, à usage unique, et seul l’écran qui a demandé le code reçoit la session. Une adresse peut avoir au maximum 5 codes en attente à la fois.
• 10 tentatives erronées depuis une adresse en 10 minutes bloquent cette adresse pendant 10 minutes ; un code d’application à usage unique est annulé après 5 essais erronés.
• Les comptes désactivés sont refusés, tout comme les comptes sans accès distant lorsque l’écran est en dehors de votre réseau local.
• Les codes d’application à usage unique sont stockés uniquement sous forme de hachage, en mémoire : un redémarrage d’Emby annule tous les codes en attente.
• Chaque connexion par code est journalisée avec l’utilisateur, l’appareil, l’application et la personne qui a approuvé.
• Les QR codes sont générés sur le serveur ; le seul service externe est le client de licence. Les jetons de session sont écrits dans le stockage du navigateur avant la redirection, jamais placés dans l’URL.

Astuces et dépannage

• Le bouton n’apparaît pas sur l’écran de connexion : appliquez-le depuis le panneau, lancez 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 ; en cas d’échec, le panneau affiche l’erreur.
• « The code is not valid or has expired » : vérifiez les chiffres affichés à l’écran ; les codes durent quelques minutes et ne fonctionnent qu’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 en dehors de votre réseau.
• Le code d’application est refusé : activez d’abord les codes pour le compte, utilisez un code récent, et vérifiez que les codes à usage unique sont activés dans le panneau.
• Mettre fin à une session : utilisez la page Devices d’Emby.

Le panneau d’administration liste aussi les utilisateurs avec codes d’application et les connexions récentes, ce qui permet de voir qui s’est connecté, depuis quel appareil et quelle application, et comment la connexion a été approuvée.

Conclusion

Quick Connect transforme la connexion sur TV, autrefois un exercice de saisie à la télécommande, en un scan et un geste, et offre aux applications officielles une voie par code à usage unique sans affaiblir le mot de passe habituel. Installez-le, réglez la durée de vie des codes et le blocage administrateur à votre convenance, appliquez le bouton de connexion, et vos utilisateurs arrêtent de vous demander des mots de passe. Le parcours complet se trouve dans le guide utilisateur ; la page produit contient la liste des fonctionnalités et le changelog suit les changements. Vos questions sont les bienvenues via contact, et la base de connaissances et la FAQ couvrent le reste de nos plugins.