MediaLab SpeedTest para Emby — 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 Emby Server 4.10.1 o más reciente.

1. Inicia sesión en tu cuenta de MediaLab Works, abre Licencias y descarga la DLL del plugin (disponible con una suscripción activa, una licencia de por vida dentro de su periodo de actualizaciones o durante la prueba gratuita de 30 días).
2. Copia la DLL en la carpeta de plugins de Emby y reinicia Emby Server:
   • Linux (paquete): /var/lib/emby/plugins/
   • Docker: la carpeta plugins del volumen de configuración de Emby
   • Windows: %AppData%\Emby-Server\programdata\plugins\
3. Abre MediaLab SpeedTest en el menú de Emby y activa la licencia (abajo).

Licencia

Abre MediaLab SpeedTest en el menú de Emby 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 Emby y muestra la licencia como Activa.

La licencia se comprueba una vez al día (y en cada arranque de Emby). 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 Emby, 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 Emby 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 Emby el prefijo es /emby, así que una dirección completa es https://tu-servidor/emby/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.