Access Links pour Jellyfin — guide

Installation

Il vous faut Jellyfin Server 12.2 ou plus récent et 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 alors le plugin et ses mises à jour 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 jeton), ne la partagez donc pas ; vous pouvez la régénérer ou la révoquer à tout moment.
Dans Jellyfin, ouvrez Dashboard → Plugins → Repositories, cliquez sur +, donnez un nom au dépôt (par exemple MediaLab Works), collez l’adresse et enregistrez.
Dans Dashboard → Plugins → Catalog, cherchez Access Links by MediaLab, cliquez sur Install, puis redémarrez Jellyfin.

Le dépôt ne liste que les plugins couverts par vos licences, et uniquement les versions qu’elles autorisent. Ses liens de téléchargement sont signés et expirent au bout de quelques heures, de sorte que 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 compilée publique ; medialab Server l’ajoute lui-même. Vous pouvez l’ajouter de la même manière 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 ne propose que les versions que votre licence autorise.

Manuellement, depuis un fichier zip.

Dans Compte → Licences, téléchargez jf-accesslinks_x.y.z.zip (le SHA-256 du fichier est indiqué à côté du bouton).
Extrayez-le dans un nouveau dossier Access Links by MediaLab_x.y.z.0 dans le dossier des plugins de 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 → Access Links 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, entrez 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 dès que le paiement est 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 cesse 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 autorisée par votre licence 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 opération. 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 ; ensuite, le plugin continue de fonctionner avec la dernière version qu’il est autorisé à utiliser.
Après un retour en arrière, si votre dépôt de plugins est ajouté dans Jellyfin, la tâche planifiée Update Plugins de Jellyfin (au démarrage et chaque jour) installe à nouveau la version la plus récente. Pour rester un moment sur la version précédente, retirez les déclencheurs de cette tâche dans Dashboard → Scheduled Tasks et rajoutez-les plus tard.

Code source

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

Configuration

Ouvrez Access Links dans le menu du tableau de bord de Jellyfin (ou Dashboard → Plugins → Access Links by MediaLab).

HTTPS : Access Links ne fonctionne qu’avec des adresses HTTPS. Si la page indique que HTTPS n’est pas activé, configurez HTTPS et un certificat dans les paramètres réseau de Jellyfin ; d’ici là, les liens https:// ne s’ouvriront pas.
Adresse locale : laissez vide pour utiliser automatiquement l’adresse IP réseau du serveur, son port HTTPS local et son URL de base ; saisissez un nom de votre réseau (par exemple media.lan ; le port HTTPS est ajouté pour vous) ou une adresse https://… complète. Astuce : si votre certificat est délivré pour un nom, utilisez ce nom, résolu vers le serveur dans votre réseau ; une simple adresse IP déclenche en général un avertissement dans les navigateurs.
Adresse externe : saisissez-la exactement comme vous le feriez dans un navigateur en dehors de chez vous, avec le port externe, par exemple https://example.com:2096. Le port externe peut différer du port local. Si une adresse https:// est définie dans Published server URIs de Jellyfin, la page la suggère avec un bouton. Tout ce qui est collé depuis la barre du navigateur après l’adresse (comme /web/#/home) est retiré pour vous.
Cliquez sur Save.

Utilisation quotidienne

La page liste chaque lien par groupes : Jellyfin (application web, écran de connexion, page du code Quick Connect de Jellyfin, tableau de bord d’administration, adresse du serveur pour les applications) et un groupe pour chaque plugin MediaLab installé et actif sur le serveur (Quick Connect, Registration, Cashier, Share Links, Headend). Chaque lien indique à qui il sert et son adresse locale et externe.
Pour chaque adresse : Open, Copy ou QR. Affichez le QR code à l’écran pour qu’un téléphone puisse le scanner, par exemple la page téléphone de Quick Connect ou le formulaire d’inscription.
Check all links lit les certificats, confirme que l’adresse externe atteint bien ce même serveur et teste chaque page. Les avertissements indiquent exactement ce qui ne va pas : HTTPS désactivé, certificat expiré ou expirant dans les 14 jours, certificat ne couvrant pas l’adresse, ou adresse externe aboutissant à un autre serveur.
Other Emby / Jellyfin servers : ajoutez un nom, le type et l’adresse https:// d’un autre serveur (jusqu’à 50). Ses liens sont construits pour vous ; Check affiche son nom, sa version, son vrai type et les pages de plugins qui y existent (une page manquante signifie en général que le plugin n’y est pas installé).

Ce qu’il envoie où

Les vérifications n’ont lieu que lorsque vous cliquez sur Check all links ou Check : le serveur se connecte aux adresses que vous avez saisies pour lire leur certificat, leurs informations publiques de serveur et si chaque page répond. Rien de secret n’est envoyé.
Les QR codes sont générés sur votre serveur ; aucune adresse ne part vers un service externe.
Rien ne va vers medialab.works, hormis la vérification de la licence.

Dépannage

« HTTPS is not enabled on this server » : activez HTTPS avec un certificat dans les paramètres réseau de Jellyfin, puis redémarrez Jellyfin.
« The certificate does not cover the local address » : l’adresse locale est une adresse IP ou un nom absent du certificat. Utilisez un nom couvert par le certificat, résolu vers le serveur dans votre réseau.
« The external address does not answer from the server » : de nombreux routeurs ne peuvent pas atteindre leur propre adresse externe depuis l’intérieur (« hairpin NAT »). Ouvrez le lien externe depuis un téléphone en données mobiles pour le vérifier.
« The external address reaches ANOTHER server » : la redirection de port ou le reverse proxy envoie cette adresse vers un autre serveur Jellyfin ou Emby ; corrigez la redirection ou l’adresse externe.