MediaLab TV 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 alors le plugin et ses mises à jour tout seul.

1. Dans votre compte MediaLab Works, ouvrez Licenses → Jellyfin plugin repository et cliquez sur Create address. Copiez-la : elle est privée (elle contient un jeton), 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, trouvez MediaLab TV, cliquez sur Install, puis redémarrez Jellyfin.

Le dépôt ne liste que les plugins que vos licences couvrent, et seulement les versions qu’elles autorisent. Ses liens de téléchargement sont signés et expirent au bout de quelques heures, Jellyfin lit donc 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 tout seul. 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 ne propose que les versions que votre licence autorise.

Manuellement, depuis un fichier zip.

1. Dans Account → Licenses, téléchargez jf-tvapp_x.y.z.zip (le SHA-256 du fichier est affiché à côté du bouton).
2. Extrayez-le dans un nouveau dossier MediaLab TV_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 → MediaLab TV et cliquez sur License.
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 cesse son travail et seule sa page License continue de fonctionner (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 à l’empreinte 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 avec la dernière version qu’il peut 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) réinstalle la version la plus récente. Pour rester sur la version précédente un moment, 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 Account → Licenses (Source code), à côté du téléchargement, sous forme d’archive .tar.gz créée depuis le commit exact de cette version.

Habillage

Ouvrez MediaLab TV dans le menu du tableau de bord Jellyfin.

• App name : le titre sur la TV (par défaut « MediaLab TV »).
• Short name : affiché dans la liste des appareils du serveur et comme nom de l’application enregistrée sur la TV.
• Line under the name et footer line : facultatifs (par exemple votre site web et comment joindre le support). Un pied de page vide affiche « Unofficial app, compatible with Jellyfin servers » dans la langue de la TV.
• Colors : l’accent (boutons, focus) et l’arrière-plan, en #rrggbb. La couleur du texte est choisie automatiquement pour rester lisible.
• Language : automatique (la langue du navigateur de la TV), anglais ou roumain.
• Logo : PNG ou SVG, au plus 512 Ko ; une image carrée rend le mieux. Les fichiers SVG avec scripts sont refusés.
• Buttons : « Sign in with your phone » et « New account (from the phone) ».

Le preview affiche le résultat avant que vous ne cliquiez sur Save.

Après la connexion

• « After sign-in, open » : l’interface MediaLab TV (le défaut : bannière, rangées, pages de titre, son propre lecteur et les boutons de saut) ou Jellyfin Web.
• « Remember the password on TVs » (désactivé par défaut) : la TV ne conserve que le jeton de connexion du serveur, pas le mot de passe ; activez-le uniquement pour les TV qui perdent sans cesse le jeton. Un mot de passe enregistré par la version 1.1 est utilisé une fois, si nécessaire, puis supprimé.
• Sur la TV, le menu du profil permet de changer le mode TV (choisi tout seul sur les TV Tizen, webOS, Android TV, Google TV et Philips) et de se déconnecter.

Adresse pour les TV

• /MediaLabTv/ sur l’adresse de votre serveur : fonctionne toujours.
• Votre propre chemin, par exemple /web/tv/ (le chemin par défaut est tv), servi directement par le plugin : la barre d’adresse garde /web/tv/, rien n’est écrit dans les fichiers de Jellyfin et rien n’a à être refait après les mises à jour de Jellyfin. Une URL de base définie dans Jellyfin est respectée. Un chemin qui existe déjà dans l’interface web de Jellyfin n’est jamais recouvert : choisissez-en un autre.

Sur chaque TV, ouvrez l’adresse une fois dans le navigateur et enregistrez-la comme page de démarrage ou favori.

Connexion avec le téléphone et nouveaux comptes

Tous deux utilisent le Quick Connect de Jellyfin : activez-le dans Dashboard → General.

• Sign in with your phone : la TV affiche un code à 6 chiffres. Un utilisateur connecté l’approuve sur le téléphone, dans l’application Jellyfin (Settings → Quick Connect). Avec Quick Connect by MediaLab installé, la TV affiche aussi un code QR qui ouvre la page d’approbation.
• New account (from the phone) : avec Registration by MediaLab, la TV affiche un code QR vers la page d’inscription et un code à saisir dans le formulaire. Quand le compte devient actif (après l’approbation de l’administrateur ou, avec Cashier by MediaLab, après le paiement), la TV se connecte toute seule.

Dépannage

• La TV affiche « Service unavailable » : la licence n’est pas valide, ou le serveur n’atteint plus medialab.works depuis plus de 7 jours. Vérifiez la page License du plugin.
• « Sign in with your phone » est absent : Quick Connect est désactivé dans Jellyfin (Dashboard → General).
• L’adresse courte affiche la propre page de Jellyfin : ce chemin existe déjà dans l’interface web ; choisissez un autre chemin.
• Une vidéo ne se lit pas dans le navigateur de la TV : vérifiez les paramètres de lecture de cet utilisateur dans Jellyfin (débit maximal de streaming, transcodage autorisé) ; le serveur transcode ce que le navigateur ne peut pas lire.