MediaLab SpeedTest para Jellyfin — guía

Instala el plugin, activa la licencia y mide la velocidad de cada televisor, teléfono o navegador para leer el veredicto.

Instalación

Necesitas Jellyfin Server 12.2 o más reciente (o medialab Server) y una cuenta de MediaLab Works con una licencia que cubra el plugin (suscripción activa, licencia de por vida dentro de su periodo de actualizaciones, el paquete Jellyfin o la prueba gratuita de 30 días).

Desde tu repositorio de plugins (recomendado). Jellyfin instala y actualiza el plugin por sí solo.

1. En tu cuenta de MediaLab Works abre Licencias → Repositorio de plugins Jellyfin y pulsa Crear dirección. Cópiala: es privada (contiene un token), no la compartas; puedes regenerarla o revocarla cuando quieras.
2. En Jellyfin abre Panel → Plugins → Repositorios, pulsa +, ponle un nombre (por ejemplo MediaLab Works), pega la dirección y guarda.
3. En Panel → Plugins → Catálogo busca MediaLab SpeedTest by MediaLab, pulsa Instalar y reinicia Jellyfin.

El repositorio solo lista los plugins que cubren tus licencias y solo las versiones permitidas. Sus enlaces de descarga están firmados y caducan en unas horas, así que Jellyfin lee siempre una lista reciente.

Manualmente, desde un archivo zip.

1. En Cuenta → Licencias descarga jf-speedtest_x.y.z.zip (el SHA-256 aparece junto al botón).
2. Descomprímelo en una carpeta nueva MediaLab SpeedTest by MediaLab_x.y.z.0 dentro de la carpeta de plugins de Jellyfin:
   • Linux (paquete): /var/lib/jellyfin/plugins/
   • Docker (imagen oficial): /config/plugins/ en el volumen de configuración
   • Windows: %ProgramData%\Jellyfin\Server\plugins\
3. Reinicia Jellyfin.

Licencia

Abre MediaLab SpeedTest en el menú de Jellyfin y pulsa Licencia. Pega tu clave de licencia y actívala, o introduce tu correo para la prueba gratuita de 30 días o la compra. El plugin habla con el servidor de licencias, vincula la clave a este servidor Jellyfin y muestra la licencia como Activa.

La licencia se comprueba una vez al día (y en cada arranque de Jellyfin). Sin internet, el plugin sigue funcionando 7 días desde la última comprobación correcta; después se detiene hasta poder comprobar de nuevo.

Sin licencia válida, la página solo muestra el panel de licencia: los puntos de medición y los botones de prueba se detienen, y MediaLab TV vuelve a su medición interna. No se borra nada y los ajustes se conservan.

Ajustes

La página tiene la prueba, la velocidad por dispositivo y las mediciones recientes; los ajustes están abajo:

• Activado / desactivado: al desactivarlo se cierran los puntos de medición (MediaLab TV mide entonces internamente).
• Mediciones por minuto, por usuario: el límite antiabuso. Un dispositivo rara vez necesita más de unas pocas; mantenlo bajo.
• Tamaño máximo por medición: entre 1 y 64 MiB. Un tamaño mayor da un resultado más estable en líneas rápidas; en una conexión lenta o móvil basta uno pequeño.
• Historial: cuántas mediciones recientes se guardan en memoria.

Guarda tras cada cambio. Las mediciones están solo en memoria: la lista empieza vacía tras cada reinicio de Jellyfin, sea cual sea el ajuste de historial.

Cómo medir

1. Abre la página del plugin en el dispositivo que quieres probar — navegador del televisor, teléfono u ordenador —, con la sesión del cuenta que usa ese dispositivo. La página mide el camino de ese dispositivo; abierta en el servidor, mide el servidor mismo.
2. Pulsa Iniciar (primero descarga, luego subida, luego latencia). Deja la página abierta hasta que termine; los botones se bloquean mientras hay una medición.
3. Lee el resultado:
   • descarga — lo que importa para reproducir; unos 25 Mbps bastan para 4K con bitrate alto, 10–15 Mbps para 1080p;
   • subida — lo que importa cuando el dispositivo envía datos (raro al reproducir);
   • latencia — lo que importa para un inicio fluido y para avanzar; más de 100 ms suele significar VPN, un camino largo o un Wi-Fi cargado.
4. El veredicto aparece junto al resultado: lenta (menos de 3 Mbps), media (3–12), buena (12–40), excelente (más de 40). La tarjeta velocidad por dispositivo guarda el último resultado y la mediana de los cinco últimos.

Vuelve a medir cuando la imagen se pare, para ver si el problema está en el camino de ese dispositivo en ese momento.

Con MediaLab TV

MediaLab TV comprueba si MediaLab SpeedTest está instalado y con licencia:

• si lo está, la app de televisión mide la red al arrancar y durante la reproducción, elige la calidad AUTO según la velocidad real y muestra el resultado en la pantalla Comprobar la red;
• si no (falta, licencia inactiva o el servidor no pudo comprobar la licencia en los últimos 7 días), la app vuelve a su medición interna, sin errores y sin preguntar nada al espectador.

Puntos de acceso (para administradores)

Todos los puntos exigen un usuario de Jellyfin con sesión; no hay ningún punto público.

• HEAD o GET …/MediaLabSpeedTest/ping — comprueba que el plugin responde.
• GET …/MediaLabSpeedTest/download?mb=N — envía N MiB para la medición de descarga (N está limitado por el tamaño máximo).
• POST …/MediaLabSpeedTest/upload — recibe los datos de la medición de subida.

En Jellyfin los puntos están directamente bajo la dirección del servidor, así que una dirección completa es https://tu-servidor/MediaLabSpeedTest/ping.

Si algo no funciona

• La página dice que la licencia no está activa: introduce la clave de nuevo en Licencia o comprueba en tu cuenta que la licencia cubre este servidor y no ha caducado. El plugin debe llegar a medialab.works al menos una vez cada 7 días.
• La prueba falla de inmediato: comprueba que tienes sesión iniciada (los puntos rechazan las peticiones anónimas) y que el plugin está activado en los ajustes.
• Las cifras son mucho más bajas que la línea del servidor: prueba desde otro dispositivo en el mismo Wi-Fi y luego desde uno por cable. Si solo un dispositivo va lento, el problema es su Wi-Fi o su camino, no el servidor.
• La app de TV lo ignora: comprueba que la licencia cubre speedtest (o el paquete) y que el servidor pudo comprobar la licencia en los últimos 7 días.