MediaLab SpeedTest pour Emby — 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 Emby Server 4.10.1 ou plus récent.

Connectez-vous à votre compte MediaLab Works, ouvrez Licences et téléchargez la DLL du greffon (disponible avec un abonnement actif, une licence à vie pendant sa période de mises à jour, ou pendant l’essai gratuit de 30 jours).
Copiez la DLL dans le dossier des greffons d’Emby et redémarrez Emby Server :
- Linux (paquet) : /var/lib/emby/plugins/
- Docker : le dossier plugins du volume de configuration d’Emby
- Windows : %AppData%\Emby-Server\programdata\plugins\
Ouvrez MediaLab SpeedTest dans le menu d’Emby et activez la licence (ci-dessous).

Licence

Ouvrez MediaLab SpeedTest dans le menu d’Emby 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 Emby et affiche la licence comme Active.

La licence est vérifiée une fois par jour (et à chaque démarrage d’Emby). 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’Emby, quel que soit le réglage d’historique.

Mesurer

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.
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.
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é.
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 Emby 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 Emby le préfixe est /emby, une adresse complète ressemble donc à https://votre-serveur/emby/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.