Quick Connect pour Jellyfin — guide

Installation

Vous avez besoin de Jellyfin Server 12.2 ou plus récent et d’un compte MediaLab Works avec une licence qui couvre le plugin (un abonnement actif, une licence à vie dans sa période de mises à jour, le pack Jellyfin ou l’essai gratuit de 30 jours).

Depuis votre dépôt de plugins (recommandé). Jellyfin installe ensuite et met à jour le plugin tout seul.

Dans votre compte MediaLab Works, ouvrez Licences → Dépôt de plugins Jellyfin et cliquez sur Créer l’URL du dépôt. Copiez-la : elle est privée (elle contient un token), ne la partagez pas ; vous pouvez la régénérer ou la révoquer à tout moment.
Dans Jellyfin, ouvrez Dashboard → Plugins → Repositories, cliquez sur +, donnez-lui un nom (par exemple MediaLab Works), collez l’adresse et enregistrez.
Dans Dashboard → Plugins → Catalog, cherchez Quick Connect by MediaLab, cliquez sur Install, puis redémarrez Jellyfin.

Le dépôt ne liste que les plugins couverts par vos licences, et uniquement dans les versions qu’elles autorisent. Ses liens de téléchargement sont signés et expirent après quelques heures, donc Jellyfin lit toujours une liste à jour.

Depuis le catalogue public. https://medialab.works/jellyfin/manifest.json liste chaque plugin MediaLab Works publié avec sa version publique ; medialab Server l’ajoute lui-même. Vous pouvez l’ajouter de la même façon pour installer un plugin avant d’avoir une clé : le plugin demande alors la licence, ou démarre l’essai, sur sa page License. Avec une licence à vie dont la période de mises à jour est terminée, restez sur votre dépôt privé, qui propose uniquement les versions que votre licence autorise.

Manuellement, depuis un fichier zip.

Dans Compte → Licences, téléchargez jf-quickconnect_x.y.z.zip (le SHA-256 du fichier est affiché à côté du bouton).
Extrayez-le dans un nouveau dossier Quick Connect by MediaLab_x.y.z.0 à l’intérieur du dossier des plugins Jellyfin :
- Linux (paquet) : /var/lib/jellyfin/plugins/
- Docker (image officielle) : /config/plugins/ dans le volume de configuration
- Windows : %ProgramData%\Jellyfin\Server\plugins\
Redémarrez Jellyfin.

Activation de la licence

Ouvrez la page du plugin dans Dashboard → Plugins → Quick Connect by MediaLab et cliquez sur License.
Collez votre clé de licence et cliquez sur Activate with key. Le plugin contacte le serveur de licences, lie la clé à ce serveur Jellyfin et affiche la licence comme Active.
Pas encore de clé ? Sur la même page, saisissez votre e-mail et démarrez l’essai gratuit de 30 jours (carte requise, rien à payer aujourd’hui) ou achetez une licence ; le plugin s’active tout seul une fois le paiement effectué.

La licence est vérifiée une fois par jour et à chaque démarrage de Jellyfin. Sans internet, le plugin continue de fonctionner pendant 7 jours après la dernière vérification réussie. Sans licence valide, le plugin arrête son travail et seule sa page License reste fonctionnelle (essai, clé, renouvellement) ; rien n’est supprimé et tout reprend dès que la licence redevient valide. Move license (release this server) sur la même page libère la clé pour un autre serveur.

Mises à jour et retour en arrière

Depuis le dépôt : Jellyfin affiche les nouvelles versions dans Dashboard → Plugins et peut mettre à jour le plugin automatiquement ; redémarrez Jellyfin pour charger la nouvelle version.
Depuis la page License du plugin : avec une licence valide, Install update installe la version la plus récente que votre licence autorise et Roll back to x.y.z revient à la version précédente (par exemple si quelque chose a cessé de fonctionner après une mise à jour). Redémarrez Jellyfin après l’une ou l’autre. Les deux paquets sont vérifiés par rapport à la somme de contrôle publiée par le serveur de licences.
Une licence à vie reçoit les versions publiées pendant sa période de mises à jour ; après celle-ci, le plugin continue de fonctionner sur la dernière version qui lui est autorisée.
Après un Roll back to x.y.z, la mise à jour automatique de Jellyfin pour ce plugin est désactivée jusqu’au prochain Install update sur la page License, pour que la tâche planifiée Update Plugins (au démarrage et chaque jour) ne réinstalle pas la version plus récente.
Licence à vie et mises à jour automatiques. Le catalogue public Jellyfin (https://medialab.works/jellyfin/manifest.json) propose toujours la version la plus récente. Quand la période de mises à jour d’une licence à vie est terminée, les versions publiées ensuite ne sont pas licenciées : si les mises à jour automatiques de Jellyfin en installent une, le plugin s’arrête avec « version not licensed » jusqu’à ce que vous reveniez en arrière avec Roll back to x.y.z sur sa page License ou que vous achetiez un pass de mises à jour. Pour l’éviter, ne laissez pas Jellyfin mettre à jour ce plugin automatiquement : ajoutez votre dépôt de plugins privé, qui propose uniquement les versions que votre licence autorise, à la place du catalogue public, ou retirez les déclencheurs de la tâche planifiée Update Plugins dans Dashboard → Scheduled Tasks (cela arrête les mises à jour automatiques pour chaque plugin).

Code source

Le code source GPL-3.0 de chaque version est dans Compte → Licences (Code source), à côté du téléchargement, sous forme d’archive .tar.gz créée depuis le commit exact de cette version.

Configuration

Ouvrez Quick Connect dans le menu du tableau de bord de Jellyfin.

Quick Connect in Jellyfin : le plugin fonctionne par-dessus le Quick Connect propre à Jellyfin. Si le panneau indique qu’il est désactivé, cliquez sur Turn on Quick Connect (ou activez-le dans Dashboard → General) ; tant qu’il est désactivé, les applications Jellyfin ne peuvent pas demander de codes.
Settings :
- The phone and screen pages are active (les pages téléphone et écran sont actives).
- Approval from the phone with username + password too (approbation depuis le téléphone avec nom d’utilisateur et mot de passe aussi), pour les téléphones où Jellyfin n’est pas connecté. Désactivez-la pour n’autoriser que les approbations depuis un téléphone qui a déjà une session Jellyfin.
- Administrator accounts cannot approve through the phone page (les comptes administrateurs ne peuvent pas approuver via la page téléphone) : désactivé par défaut.
How to use affiche les deux adresses de votre serveur : la page téléphone (/Connect/Page) et la page écran pour les navigateurs de téléviseurs (/Connect/Screen). Partagez l’adresse de la page téléphone avec vos utilisateurs, ou placez son code QR à côté du téléviseur.

Le plugin n’ajoute pas de code à usage unique à saisir à la place du mot de passe, volontairement : les utilisateurs qui en dépendraient seraient verrouillés si le plugin était retiré. Les mots de passe restent exactement gérés comme Jellyfin le fait.

Utilisation quotidienne

Dans une application Jellyfin sur le téléviseur (Android TV, Fire TV, webOS, Tizen, Roku et les autres) : choisissez Quick Connect sur l’écran de connexion. L’application affiche un code à 6 chiffres.
Dans un navigateur de téléviseur : ouvrez la page écran. Elle affiche le code et un code QR qui mène à la page téléphone.
Sur le téléphone : scannez le code QR ou ouvrez la page téléphone, saisissez le code s’il n’est pas déjà rempli, puis approuvez d’un geste comme l’utilisateur Jellyfin déjà connecté sur le téléphone, ou avec un nom d’utilisateur et un mot de passe. Le téléviseur se connecte tout seul.
Pas encore de compte ? Avec Registration by MediaLab installé, la page téléphone affiche un lien pour en créer un.
Le panneau liste les approbations récentes (quand, quel utilisateur et comment elles ont été approuvées).

Dépannage

« Quick Connect is not available on this server » : activez Quick Connect dans Jellyfin (le panneau a un bouton pour cela) et vérifiez que la licence du plugin est active.
« The code is not valid or has expired » : vérifiez les chiffres sur le téléviseur ; les codes de Jellyfin expirent après un certain temps. Demandez-en un nouveau à l’application.
« Too many attempts » : attendez 10 minutes ; le blocage s’applique à l’adresse qui a fait les tentatives erronées.
« The account is disabled » ou administrator accounts refused : le compte est désactivé dans Jellyfin, ou les administrateurs ne sont pas autorisés à approuver dans les réglages du plugin.