Headend pour Jellyfin — guide d’installation

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.

1. 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.
2. Dans Jellyfin, ouvrez Dashboard → Plugins → Repositories, cliquez sur +, donnez-lui un nom (par exemple MediaLab Works), collez l’adresse et enregistrez.
3. Dans Dashboard → Plugins → Catalog, cherchez Headend 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.

1. Dans Compte → Licences, téléchargez jf-headend_x.y.z.zip (le SHA-256 du fichier est affiché à côté du bouton).
2. Extrayez-le dans un nouveau dossier Headend 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\
3. Redémarrez Jellyfin.

Activation de la licence

1. Ouvrez la page du plugin dans Dashboard → Plugins → Headend by MediaLab et cliquez sur Open License page.
2. 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.
3. 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 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 certain temps sur la version précédente, retirez les déclencheurs de cette tâche dans Dashboard → Scheduled Tasks et remettez-les en place plus tard.

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

1. Ouvrez Dashboard → Live TV, ajoutez un tuner device de type Headend (Enigma2 / Vu+) et saisissez le récepteur : adresse, port OpenWebif (80) et port de flux (8001), nom d’utilisateur et mot de passe si OpenWebif les demande, et les bouquets à importer.
2. Ajoutez le fournisseur de guide Headend dans la même page, pour que le guide des programmes provienne du récepteur.
3. Ouvrez Dashboard → Headend pour ajuster la liste de chaînes (noms, numéros, ordre, logos, chaînes pour adultes) et pour donner l’accès à la TV en direct aux utilisateurs concernés ; les nouveaux utilisateurs démarrent sans cet accès.
4. Actualisez le guide (Dashboard → Scheduled Tasks → Refresh Guide) ; les chaînes apparaissent dans Live TV.

Dépannage

• Aucune chaîne : vérifiez qu’OpenWebif s’ouvre dans un navigateur depuis le serveur Jellyfin, à l’adresse que vous avez saisie.
• Une chaîne ne se lit pas : un tuner ne peut recevoir qu’un transpondeur à la fois ; un enregistrement ou un autre spectateur sur un transpondeur différent peut l’occuper.
• Un utilisateur ne voit pas la TV en direct : donnez-lui l’accès depuis la page Headend.