Quick Connect para Emby — guía

Instalación

Necesitas Emby Server 4.10.1 o posterior.

Inicia sesión en tu cuenta de MediaLab Works, abre Licenses y descarga el DLL del plugin (disponible con una suscripción activa, con una licencia de por vida dentro de su período de actualizaciones o durante la prueba gratuita de 30 días).
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\
Abre Quick Connect en el menú del panel de Emby y haz clic en License. Pega tu clave de licencia y actívala, o escribe tu correo para empezar la prueba gratuita de 30 días o comprar una licencia. El plugin contacta con el servidor de licencias, vincula la clave a este servidor de Emby y muestra la licencia como Active.

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; después se detiene hasta que pueda comprobarla de nuevo.

Licencia

Sin una licencia válida, Quick Connect se detiene: las páginas del móvil y de la pantalla no están disponibles, no se emite ningún código y los códigos de un solo uso para apps no se aceptan. Los usuarios que activaron los códigos para apps simplemente inician sesión con su contraseña habitual, que Emby comprueba como siempre. Solo sigue funcionando la página License (desde ella puedes empezar la prueba, comprar, introducir la clave o actualizar). Los ajustes y el registro de inicios de sesión se conservan, y todo se reanuda en cuanto la licencia vuelve a ser válida.

Con una licencia válida, esa misma página puede instalar una actualización o volver a la versión anterior si una actualización causa problemas. Reinicia Emby después de cualquiera de las dos.

Configuración

Abre Quick Connect en el panel de Emby.

Settings:
- Phone sign-in is active: las páginas del móvil y de la pantalla.
- Approval from the phone with username + password too, también para móviles donde Emby no tiene la sesión iniciada. 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 para apps desde la página del móvil.
- Administrator accounts cannot sign in with a code: desactivado por defecto.
- Screen code validity: 5 minutos por defecto, de 1 a 15.
- New account created from the phone: the screen signs in by itself once the account is active: desactivado por defecto. Necesita Registration 1.10.5 o posterior; con una versión anterior de Registration no tiene efecto.
Button on the sign-in screen: haz clic en Apply para añadir Sign in with your phone a la pantalla de inicio de sesión de Emby Web. El plugin escribe una línea en el dashboard-ui/index.html de Emby (guardando una copia como index.html.before-quickconnect) y la vuelve a añadir tras las actualizaciones de Emby. Si el archivo pertenece a root y Emby no puede escribirlo, la página muestra el comando exacto que hay que ejecutar en el servidor; Remove quita el botón de nuevo.
How to use muestra las dos direcciones de tu servidor: la página de la pantalla (/emby/QuickConnect/Screen) y la página del móvil (/emby/QuickConnect/Page).

Uso diario

En un navegador del televisor o en el ordenador: en la pantalla de inicio de sesión de Emby, haz clic en Sign in with your phone (o abre la página de la pantalla). La pantalla muestra un código de 6 dígitos y un código QR.
En el móvil: escanea el código QR (o abre la página del móvil y escribe el código), comprueba el nombre del dispositivo que espera y, después, aprueba con un toque como el usuario de Emby que ya tiene la sesión iniciada en el móvil, o con Another account y un nombre de usuario y una contraseña. La pantalla inicia sesión sola.
En las apps oficiales de Emby (televisores, consolas): el usuario abre la página del móvil con la sesión de Emby iniciada, activa codes for my account una vez y, después, pulsa Show a code cuando lo necesite. En la app de Emby inicia sesión con su nombre de 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; la contraseña habitual sigue funcionando.
¿Todavía no tienes cuenta? Con Registration instalado, la página del móvil muestra un enlace para crear una. Si el ajuste anterior está activado, la pantalla conserva su código mientras se crea la cuenta, hasta 60 minutos, e indica que se está creando una cuenta en el móvil. Inicia sesión como el usuario nuevo en cuanto la cuenta está activa: enseguida, después de que un administrador la apruebe o después del pago con Cashier. Los controles habituales se aplican también a ese inicio de sesión (cuenta desactivada, bloqueo del administrador, acceso remoto).
El panel enumera los usuarios con códigos para apps y los inicios de sesión recientes (usuario, dispositivo, app y cómo se aprobó). Para terminar una sesión, usa la página Devices de Emby.

Resolució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, después, recarga la página de inicio de sesión. Tras 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»: comprueba los dígitos en la pantalla; los códigos duran unos minutos y funcionan una sola vez. Pide a la pantalla uno nuevo.
«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.
El código de la app se rechaza: activa primero los códigos para la cuenta, usa un código nuevo (5 minutos, una sola vez) y comprueba que los códigos de un solo uso estén activados en el panel.