MediaLab SpeedTest pour Jellyfin — guide

Installez le greffon, activez la licence, puis mesurez la vitesse de chaque télévision, téléphone ou navigateur et lisez le verdict.

Installation

Il faut Jellyfin Server 12.2 ou plus récent (ou medialab Server) et un compte MediaLab Works avec une licence qui couvre le greffon (abonnement actif, licence à vie pendant sa période de mises à jour, le pack Jellyfin ou l’essai gratuit de 30 jours).

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

1. Dans votre compte MediaLab Works, ouvrez Licences → Dépôt de greffons Jellyfin et cliquez sur Créer l’adresse. 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 Tableau de bord → Greffons → Dépôts, cliquez sur +, donnez un nom (par exemple MediaLab Works), collez l’adresse et enregistrez.
3. Dans Tableau de bord → Greffons → Catalogue, trouvez MediaLab SpeedTest by MediaLab, cliquez sur Installer, puis redémarrez Jellyfin.

Le dépôt ne liste que les greffons couverts par vos licences et seulement les versions autorisées. Ses liens de téléchargement sont signés et expirent après quelques heures, Jellyfin lit donc toujours une liste fraîche.

Manuellement, depuis un fichier zip.

1. Dans Compte → Licences, téléchargez jf-speedtest_x.y.z.zip (le SHA-256 est affiché à côté du bouton).
2. Décompressez-le dans un nouveau dossier MediaLab SpeedTest by MediaLab_x.y.z.0 dans le dossier des greffons 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.

Licence

Ouvrez MediaLab SpeedTest dans le menu de Jellyfin et cliquez sur Licence. Collez votre clé de licence et activez-la, ou saisissez votre e-mail pour l’essai gratuit de 30 jours ou l’achat. Le greffon contacte le serveur de licences, lie la clé à ce serveur Jellyfin et affiche la licence comme Active.

La licence est vérifiée une fois par jour (et à chaque démarrage d’Jellyfin). Sans internet, le greffon fonctionne encore 7 jours après la dernière vérification réussie ; ensuite il s’arrête jusqu’à pouvoir vérifier de nouveau.

Sans licence valide, la page n’affiche que le panneau de licence : les points de mesure et les boutons de test s’arrêtent, et MediaLab TV revient à sa mesure interne. Rien n’est supprimé, les réglages restent.

Réglages

La page contient le test, la vitesse par appareil et les mesures récentes ; les réglages sont en bas :

• Activé / désactivé : désactivé, les points de mesure s’arrêtent (MediaLab TV mesure alors en interne).
• Mesures par minute, par utilisateur : la limite anti-abus. Un appareil a rarement besoin de plus de quelques mesures ; gardez-la basse.
• Taille maximale par mesure : entre 1 et 64 MiB. Plus grande donne un résultat plus stable sur les lignes rapides ; sur une connexion lente ou mobile une petite taille suffit.
• Historique : combien de mesures récentes sont gardées en mémoire.

Enregistrez après chaque changement. Les mesures restent uniquement en mémoire : la liste repart vide après chaque redémarrage d’Jellyfin, quel que soit le réglage d’historique.

Mesurer

1. Ouvrez la page du greffon sur l’appareil à tester — navigateur de la TV, téléphone ou ordinateur —, connecté avec le compte de cet appareil. La page mesure le trajet de cet appareil ; ouverte sur le serveur, elle mesure le serveur lui-même.
2. Cliquez sur Démarrer (d’abord téléchargement, puis envoi, puis latence). Laissez la page ouverte jusqu’à la fin ; les boutons sont bloqués pendant une mesure.
3. Lisez le résultat :
   • téléchargement — ce qui compte pour la lecture ; environ 25 Mbps suffisent pour un flux 4K à haut débit, 10–15 Mbps pour du 1080p ;
   • envoi — ce qui compte quand l’appareil envoie des données (rare en lecture) ;
   • latence — ce qui compte pour un démarrage fluide et pour avancer ; au-delà de 100 ms, c’est en général un VPN, un trajet long ou un Wi-Fi chargé.
4. Le verdict apparaît à côté du résultat : lent (moins de 3 Mbps), moyen (3–12), bon (12–40), excellent (plus de 40). La carte vitesse par appareil garde le dernier résultat et la médiane des cinq derniers.

Relancez le test quand l’image s’arrête, pour voir si le problème est sur le trajet de cet appareil à ce moment-là.

Avec MediaLab TV

MediaLab TV vérifie si MediaLab SpeedTest est installé et sous licence :

• si oui, l’application TV mesure le réseau au démarrage et pendant la lecture, choisit la qualité AUTO d’après la vitesse réelle et affiche le résultat sur l’écran Vérifier le réseau ;
• sinon (absent, licence inactive, ou le serveur n’a pas pu vérifier la licence dans les 7 derniers jours), l’application revient à sa mesure interne, sans erreurs et sans rien demander au spectateur.

Points d’accès (pour les administrateurs)

Tous les points exigent un utilisateur Jellyfin connecté ; il n’y a aucun point public.

• HEAD ou GET …/MediaLabSpeedTest/ping — vérifie que le greffon répond.
• GET …/MediaLabSpeedTest/download?mb=N — envoie N MiB pour la mesure du téléchargement (N est plafonné par la taille maximale).
• POST …/MediaLabSpeedTest/upload — reçoit les données de la mesure d’envoi.

Sur Jellyfin les points sont directement sous l’adresse du serveur, une adresse complète ressemble donc à https://votre-serveur/MediaLabSpeedTest/ping.

Dépannage

• La page dit que la licence n’est pas active : saisissez de nouveau la clé dans Licence, ou vérifiez dans votre compte que la licence couvre ce serveur et n’a pas expiré. Le greffon doit joindre medialab.works au moins une fois tous les 7 jours.
• Le test échoue immédiatement : vérifiez que vous êtes connecté (les points refusent les requêtes anonymes) et que le greffon est activé dans les réglages.
• Les chiffres sont bien plus bas que la ligne du serveur : testez depuis un autre appareil sur le même Wi-Fi, puis depuis un appareil câblé. Si un seul appareil est lent, le problème est son Wi-Fi ou son trajet, pas le serveur.
• L’application TV l’ignore : vérifiez que la licence couvre speedtest (ou le pack) et que le serveur a pu vérifier la licence dans les 7 derniers jours.