Iniciar sesión en Emby en la TV sin escribir la contraseña: código QR y aprobación en el móvil

Escribir la contraseña con el mando de la TV es la parte más molesta de tener Emby en casa. Es lento, se falla a menudo y suele acabar con alguien compartiendo la contraseña de la cuenta por chat, que luego toca cambiar. Quick Connect elimina ese paso: la pantalla muestra un código de 6 dígitos y un código QR, el usuario aprueba desde el móvil y la pantalla inicia sesión sola. En las apps oficiales de Emby, donde no existe una página de pantalla, cada usuario puede activar un código de un solo uso que se escribe en el campo de la contraseña.

Este tutorial recorre la instalación, la configuración y el uso diario. Está pensado para quienes ya tienen Emby en su propio servidor, en Linux, Windows o en Docker.

Requisitos previos

• Emby Server 4.10.1 o superior. Las versiones anteriores no son compatibles.
• Una cuenta de MediaLab Works con una licencia activa, una licencia de por vida dentro de su ventana de actualizaciones o la prueba gratuita de 30 días, para poder descargar el DLL del plugin.
• Para el botón en la pantalla de inicio de sesión de Emby Web: permiso de escritura en el dashboard-ui/index.html de Emby. Si Emby no puede escribir ese archivo, el panel muestra el comando exacto que hay que ejecutar en el servidor. Las páginas del móvil y de la pantalla funcionan sin el botón.

Paso 1: Instalar el plugin

1. Inicia sesión en tu cuenta de MediaLab Works, abre Licenses y descarga el DLL del plugin.
2. Copia el DLL en la carpeta de plugins de Emby y reinicia Emby Server:
   • Linux (paquete): /var/lib/emby/plugins/
   • Docker: la carpeta plugins dentro del volumen de configuración de Emby
   • Windows: %AppData%\Emby-Server\programdata\plugins\
3. Abre Quick Connect en el menú del panel de Emby, haz clic en License y pega tu clave de licencia para activarla, o introduce tu correo electrónico para empezar la prueba. La página muestra la licencia como Active una vez que la clave queda vinculada a este servidor.

La licencia se comprueba una vez al día y en cada arranque de Emby. Sin internet, el plugin sigue funcionando 7 días después de la última comprobación correcta; pasados esos días se detiene hasta que pueda comprobarla de nuevo. Si la licencia no es válida, las páginas del móvil y de la pantalla no están disponibles y no se aceptan los códigos de app, pero todo el mundo puede seguir iniciando sesión con su contraseña normal.

Paso 2: Configurar los ajustes

Abre Quick Connect en el panel de Emby y repasa la pestaña Settings:

• Phone sign-in is active: activa las páginas del móvil y de la pantalla.
• Approval from the phone with username + password too: déjalo activado para móviles donde Emby no tiene sesión iniciada, o desactívalo para permitir solo aprobaciones desde un móvil que ya tenga una sesión de Emby.
• One-time codes for Emby apps: permite que cada usuario active los códigos de app desde la página del móvil.
• Administrator accounts cannot sign in with a code: desactivado por defecto; considera activarlo.
• Screen code validity: 5 minutos por defecto, ajustable de 1 a 15.
• New account created from the phone: desactivado por defecto. Necesita Registration 1.10.5 o superior, y con una versión anterior de Registration no tiene efecto.

Paso 3: Añadir el botón a la pantalla de inicio de sesión

En la pestaña Button on the sign-in screen, haz clic en Apply. El plugin escribe una línea en el dashboard-ui/index.html de Emby, guarda una copia como index.html.before-quickconnect y vuelve a añadir el botón después de que Emby se actualice. Si el archivo pertenece a root y Emby no puede escribirlo, la página muestra el comando exacto que hay que ejecutar; Remove quita el botón de nuevo.

Paso 4: Anotar las dos direcciones

La pestaña How to use muestra las direcciones en tu servidor:

• Página de pantalla: /emby/QuickConnect/Screen
• Página del móvil: /emby/QuickConnect/Page

Paso 5: Iniciar sesión en un navegador de TV o en un ordenador

1. En la pantalla de inicio de sesión de Emby, haz clic en Sign in with your phone o abre la página de pantalla. La pantalla muestra un código de 6 dígitos y un código QR.
2. En el móvil, escanea el código QR o abre la página del móvil y escribe el código.
3. Comprueba el nombre del dispositivo que está esperando y aprueba con un toque como el usuario de Emby que ya tiene la sesión iniciada en el móvil, o usa Another account con un usuario y una contraseña.
4. La pantalla inicia sesión sola y se envía a la dirección que haya definido el administrador (por defecto: la interfaz web del servidor).

Paso 6: Códigos de un solo uso para las apps oficiales de Emby

En TVs y consolas donde la app oficial de Emby es el único cliente no hay página de pantalla. El código de un solo uso cubre ese caso:

1. En el móvil, abre la página del móvil con la sesión de Emby iniciada y activa una vez codes for my account.
2. Haz clic en Show a code cada vez que necesites uno.
3. En la app de Emby, inicia sesión con tu usuario y escribe el código de 6 dígitos en el campo de la contraseña.

El código es válido durante 5 minutos y funciona una sola vez. Se activa por usuario y la contraseña normal sigue funcionando. Si se quita el plugin o termina la licencia, Emby vuelve a comprobar la contraseña normal por sí mismo.

Notas de seguridad

• Los códigos de pantalla son aleatorios, de un solo uso, y solo la pantalla que pidió el código recibe la sesión. Una dirección puede tener como máximo 5 códigos esperando a la vez.
• 10 intentos fallidos desde una misma dirección en 10 minutos bloquean esa dirección durante 10 minutos; un código de app de un solo uso se cancela tras 5 intentos fallidos.
• Se rechazan las cuentas deshabilitadas y también las cuentas sin acceso remoto cuando la pantalla está fuera de tu red local.
• Los códigos de app de un solo uso se guardan solo como hash, en memoria: al reiniciar Emby se cancelan todos los códigos pendientes.
• Cada inicio de sesión por código queda registrado con el usuario, el dispositivo, la app y quién lo aprobó.
• Los códigos QR se generan en el servidor; el único servicio externo es el cliente de licencias. Los tokens de sesión se escriben en el almacenamiento del navegador antes de la redirección y nunca se ponen en la URL.

Consejos y solución de problemas

• El botón no aparece en la pantalla de inicio de sesión: aplícalo desde el panel, ejecuta el comando que muestra si Emby no puede escribir el archivo y recarga la página de inicio de sesión. Después de una actualización de Emby, el plugin lo vuelve a poner al arrancar; si falla, el panel muestra el error.
• «The code is not valid or has expired»: revisa los dígitos de la pantalla; los códigos duran unos minutos y funcionan una sola vez. Pide uno nuevo a la pantalla.
• «Too many attempts»: espera 10 minutos; el bloqueo se aplica a la dirección que hizo los intentos fallidos.
• «The account is not allowed to sign in from outside the local network»: la cuenta no tiene acceso remoto en Emby y la pantalla está fuera de tu red.
• Se rechaza el código de app: activa primero los códigos para la cuenta, usa un código reciente y comprueba que los códigos de un solo uso están activados en el panel.
• Terminar una sesión: usa la página Devices del propio Emby.

El panel de administración también lista los usuarios con códigos de app y los inicios de sesión recientes, así que puedes ver quién inició sesión, desde qué dispositivo y app, y cómo se aprobó.

Conclusión

Quick Connect convierte el inicio de sesión en la TV de un ejercicio de escritura con el mando en un escaneo y un toque, y da a las apps oficiales una vía de código de un solo uso sin debilitar la contraseña normal. Instálalo, ajusta la duración de los códigos y el bloqueo de administradores a tu gusto, aplica el botón de inicio de sesión y tus usuarios dejarán de pedirte contraseñas. El recorrido completo está en la guía de usuario; la página del producto tiene la lista de funciones y el changelog recoge los cambios. Las preguntas son bienvenidas en contacto, y la base de conocimiento y las FAQ cubren el resto de nuestros plugins.