Connexion sans mot de passe sur le téléviseur : une page téléphone avec un code QR approuve le code Quick Connect de n’importe quelle application Jellyfin, et un écran de code pour les navigateurs des téléviseurs.

Jellyfin dispose déjà de Quick Connect : une application sur le téléviseur affiche un code à 6 chiffres, et un utilisateur connecté l’approuve depuis un autre appareil. Le plus difficile, c’est de trouver où l’approuver, au fond des réglages Jellyfin sur le téléphone. Quick Connect de MediaLab offre à vos utilisateurs une courte page téléphone avec un code QR pour cela, et un écran de code pour les navigateurs des téléviseurs.

Ce qu’il fait

Page téléphone avec un code QR (/Connect/Page sur votre adresse Jellyfin) : elle approuve le code Quick Connect affiché par n’importe quelle application Jellyfin — Android TV, Fire TV, webOS, Tizen, Roku, iOS ou Jellyfin Web. L’utilisateur approuve d’un seul geste si Jellyfin est déjà connecté sur le téléphone, ou avec nom d’utilisateur + mot de passe (ce deuxième mode peut être désactivé).
Écran pour les navigateurs des téléviseurs (/Connect/Screen) : affiche le code et un code QR menant à la page téléphone ; après l’approbation, l’écran se connecte tout seul à Jellyfin Web.
Nouveau compte depuis le téléphone : avec Registration installé, la page téléphone renvoie vers la page d’inscription.
Panneau d’administration dans le tableau de bord Jellyfin : l’état de Quick Connect dans Jellyfin (avec un bouton pour l’activer), les réglages et les approbations récentes. En anglais et en roumain.

Pas de code de mot de passe à usage unique, volontairement. Contrairement à la version Emby, ce plugin ne permet pas de saisir un code à la place du mot de passe. Un compte Jellyfin qui dépendrait d’un tel code serait bloqué si le plugin était un jour supprimé. Chaque connexion passe par le Quick Connect natif de Jellyfin, et les mots de passe restent gérés exactement comme Jellyfin les gère.

Sécurité

Les codes sont ceux du Quick Connect natif de Jellyfin : Jellyfin les crée et ils expirent d’eux-mêmes. Le plugin se contente de les approuver.
10 tentatives erronées (codes ou mots de passe incorrects) depuis une même adresse en 10 minutes la bloquent pendant 10 minutes.
Les comptes désactivés sont refusés. En option, les comptes administrateur ne peuvent pas approuver via la page téléphone.
Les pages téléphone et écran sont servies avec une politique de sécurité du contenu stricte et n’envoient aucun référent.
Chaque approbation est consignée avec l’utilisateur, l’adresse et le mode d’approbation.

Prérequis

Jellyfin Server 12.2 ou plus récent.
Quick Connect activé dans Jellyfin (Tableau de bord → Général). La page du plugin indique son état et peut l’activer.

Questions fréquentes

Mes utilisateurs peuvent-ils se connecter sur un téléviseur sans saisir leur mot de passe ? Oui. L’application Jellyfin sur le téléviseur affiche un code Quick Connect ; l’utilisateur scanne le code QR ou ouvre la page téléphone et l’approuve. Voir le guide.

Existe-t-il un code à usage unique à saisir à la place du mot de passe, comme dans la version Emby ? Non, et c’est volontaire : si le plugin était supprimé, les utilisateurs qui comptaient sur ce code seraient bloqués. Le Quick Connect de Jellyfin couvre déjà les applications officielles.

Ce qu’il envoie et où

Aucun service externe en dehors du client de licence. Les codes QR sont générés sur le serveur ; les pages écran et téléphone ne chargent que les fichiers du plugin.
Après la connexion, le téléviseur/navigateur est redirigé vers l’adresse définie par l’administrateur (par défaut : l’interface web du serveur). Le jeton de session est écrit dans le stockage du navigateur avant la redirection, jamais placé dans l’URL. Les adresses locales/externes sont en HTTPS uniquement.
Utilise le Quick Connect natif de Jellyfin ; aucun fichier modifié.
Plus le client de licence, le même dans chaque plugin : voir Licences et confidentialité dans nos plugins.

Stocké localement :

Codes en attente — en mémoire uniquement.
state/approvals.json : les 500 dernières approbations (heure, utilisateur, appareil, application, IP, méthode).

Jamais envoyé : mots de passe, jetons — rien ne va à des tiers.

Compatibilité avec les clients

Écran + téléphone (QR, approbation depuis le téléphone) : navigateurs — Jellyfin Web sur téléviseur, ordinateur, MediaLab TV. ✅ émulé (Chrome avec un User-Agent Philips NETTV ; 25/25) ; ❔ non testé sur des téléviseurs physiques.
Toute application avec Quick Connect natif (Android TV, Fire TV, webOS, Tizen, Roku, iOS/Swiftfin, Jellyfin Web) : la page téléphone approuve le code affiché par l’application. ✅ simulé via l’API (client « Jellyfin Android TV ») ; ❔ non testé sur de vrais Android TV, Swiftfin, Findroid, Kodi/JellyCon, Infuse, Streamyfin. Nécessite Quick Connect activé dans le tableau de bord. Pas de codes à usage unique sur Jellyfin (décision de sécurité).
Connexion automatique après nouveau compte + paiement : avec Registration et Cashier ; désactivé par défaut.

Légende : ✅ vérifié (test de bout en bout ou sur l’appareil) · 🟢 côté serveur, fonctionne avec tout client (par conception, sans test propre à un client) · ➖ non applicable · ❔ non testé.

Licence

Le plugin est open source (GPL-3.0). Les versions compilées prêtes à installer sont publiques, comme le code source. Ce que vous achetez, c’est l’abonnement : la licence d’utilisation du plugin sur un serveur Jellyfin, les mises à jour comprises dans votre formule et le support : chaque mise à jour pendant que l’abonnement est actif, via votre dépôt de plugins privé, et de l’aide quand quelque chose ne fonctionne pas. Le plugin vérifie la clé d’abonnement une fois par jour ; sans abonnement valide, il s’arrête jusqu’au renouvellement (rien n’est supprimé). Mensuel, annuel ou à vie (la licence à vie comprend un an de mises à jour), ou inclus dans le pack Jellyfin. Essai gratuit de 30 jours.

Code source. Pour chaque version, le code source complet correspondant est public, à côté de la version compilée, dans l’historique des versions, et aussi dans votre compte (Compte → Licences, Code source) ; chaque archive contient le texte intégral de la GPL-3.0 (LICENSE). Si vous avez besoin du code source d’une version que vous ne pouvez plus télécharger, écrivez-nous et nous vous l’envoyons. Voir la section 10 de la Licence (CLUF).

Code propre, écrit par MediaLab Works. Code tiers : le générateur de codes QR est basé sur la bibliothèque QR Code generator de Project Nayuki (licence MIT).

Ce plugin fonctionne sur Jellyfin officiel 12.2 ou plus récent. Sur medialab Server, notre serveur basé sur Jellyfin, avec les mêmes données, bibliothèques, utilisateurs et applications, il fonctionne mieux :

Verified – medialab. Le serveur vérifie la signature de nos plugins et vous montre que les fichiers sont exactement ceux que nous avons publiés. Un plugin modifié après sa publication est signalé.
Intégré à l’interface. Les plugins peuvent ajouter des boutons et des liens dans le menu de vos utilisateurs (par exemple « TV », « Share ») sans configuration web manuelle.
Prioritaire par défaut. Les plugins medialab passent en premier là où cela compte : tuners TV en direct, sources de guide et fournisseurs de sous-titres. L’ordre reste le vôtre : vous pouvez le modifier à tout moment.
Le catalogue medialab.works inclus, avec une installation sans confirmations supplémentaires.
Mises à jour depuis l’interface web, sans terminal (avec Self-Update de MediaLab) : vérifiez, mettez à jour et revenez en arrière depuis le tableau de bord ; si une nouvelle version ne démarre pas, le serveur revient de lui-même à la version précédente, avec vos données intactes.
Le même Jellyfin, à jour. medialab Server suit chaque semaine les versions stables de Jellyfin 12.x ; une nouvelle version n’est publiée qu’après avoir réussi tous les tests, y compris ceux de nos plugins.

Les applications Jellyfin (Android, iOS, TV, web) se connectent exactement comme à Jellyfin officiel.

Pour l’installer, lancez l’image de conteneur (guide) ou, sur Debian 12, les paquets apt, qui remplacent jellyfin-server et jellyfin-web en conservant vos données en place (guide).

medialab Server est un logiciel libre (GPL-2.0), basé sur Jellyfin. Le code source est public : medialab-server et medialab-server-web.

Quick Connect pour Jellyfin