Jellyfin ya tiene Quick Connect: una app en el televisor muestra un código de 6 dígitos, y un usuario con la sesión iniciada lo aprueba en otro sitio. Lo difícil es encontrar dónde aprobarlo, en lo profundo de los ajustes de Jellyfin en el teléfono. Quick Connect de MediaLab da a tus usuarios una página corta para el teléfono con un código QR para eso, y una pantalla de códigos para navegadores de TV.
Qué hace
- Página para el teléfono con un código QR (
/Connect/Pageen tu dirección de Jellyfin): aprueba el código de Quick Connect que muestra cualquier app de Jellyfin — Android TV, Fire TV, webOS, Tizen, Roku, iOS o Jellyfin Web. El usuario aprueba con un toque si Jellyfin ya tiene la sesión iniciada en el teléfono, o con nombre de usuario + contraseña (esta segunda forma se puede desactivar). - Pantalla para navegadores de TV (
/Connect/Screen): muestra el código y un código QR que lleva a la página para el teléfono; tras la aprobación, la pantalla inicia sesión en Jellyfin Web sola. - Cuenta nueva desde el teléfono: con Registration instalado, la página para el teléfono enlaza a la página de registro.
- Panel de administración en el panel de Jellyfin: si Quick Connect está activado en Jellyfin (con un botón para activarlo), los ajustes y las aprobaciones recientes. En inglés y rumano.
Sin código de un solo uso, a propósito. A diferencia de la versión para Emby, este plugin no deja a los usuarios escribir un código en lugar de su contraseña. Una cuenta de Jellyfin que dependiera de un código así se quedaría fuera si el plugin se eliminara alguna vez. Cada inicio de sesión pasa por el Quick Connect propio de Jellyfin, y las contraseñas siguen exactamente como las gestiona Jellyfin.
Seguridad
- Los códigos son los del Quick Connect propio de Jellyfin: Jellyfin los crea y caducan por sí mismos. El plugin solo los aprueba.
- 10 intentos incorrectos (códigos o contraseñas equivocados) desde una dirección en 10 minutos la bloquean durante 10 minutos.
- Las cuentas desactivadas se rechazan. Opcionalmente, las cuentas de administrador no pueden aprobar a través de la página para el teléfono.
- Las páginas para el teléfono y la pantalla se sirven con una política de seguridad de contenido estricta y no envían referrer.
- Cada aprobación se registra con el usuario, la dirección y cómo se aprobó.
Requisitos
- Jellyfin Server 12.2 o superior.
- Quick Connect activado en Jellyfin (Dashboard → General). La página del plugin muestra su estado y puede activarlo.
Preguntas frecuentes
¿Pueden mis usuarios iniciar sesión en el televisor sin escribir su contraseña? Sí. La app de Jellyfin en el televisor muestra un código de Quick Connect; el usuario escanea el código QR o abre la página para el teléfono y lo aprueba. Consulta la guía.
¿Hay un código de un solo uso para escribir en lugar de la contraseña, como en la versión para Emby? No, y es deliberado: si el plugin se eliminara, los usuarios que dependieran de ese código se quedarían fuera. El Quick Connect de Jellyfin ya cubre las apps oficiales.
Qué envía y adónde
- Ningún servicio externo además del cliente de licencias. Los códigos QR se generan en el servidor; las páginas de pantalla y de teléfono cargan solo los archivos del plugin.
- Tras el inicio de sesión, la TV/el navegador se envía a la dirección que fijó el administrador (por defecto: la interfaz web del servidor). El token de sesión se escribe en el almacenamiento del navegador antes de la redirección, nunca se pone en la URL. Las direcciones locales/externas son solo HTTPS.
- Usa el Quick Connect nativo de Jellyfin; no se modifica ningún archivo.
- Además, el cliente de licencias, igual en todos los plugins: consulta Licencias y privacidad en nuestros plugins.
Guardado localmente:
- Códigos pendientes — solo en memoria.
state/approvals.json: las últimas 500 aprobaciones (hora, usuario, dispositivo, app, IP, método).
Nunca enviados: contraseñas, tokens — nada va a terceros.
Compatibilidad con clientes
- Pantalla + teléfono (código QR, aprobación desde el teléfono): navegadores — Jellyfin Web en una TV, escritorio, MediaLab TV. ✅ emulado (Chrome con un User-Agent de Philips NETTV; 25/25); ❔ no probado en TVs físicas.
- Cualquier app con Quick Connect nativo (Android TV, Fire TV, webOS, Tizen, Roku, iOS/Swiftfin, Jellyfin Web): la página para el teléfono aprueba el código que muestra la app. ✅ simulado vía API (cliente «Jellyfin Android TV»); ❔ no probado en Android TV real, Swiftfin, Findroid, Kodi/JellyCon, Infuse, Streamyfin. Requiere Quick Connect activado en el Dashboard. Sin códigos de un solo uso en Jellyfin (decisión de seguridad).
- Inicio de sesión automático tras cuenta nueva + pago: con Registration y Cashier; desactivado por defecto.
Leyenda: ✅ verificado (prueba de extremo a extremo o en el dispositivo) · 🟢 en el servidor, funciona con cualquier cliente (por diseño, sin prueba específica para cada cliente) · ➖ no aplicable · ❔ no probado.
Licencia
El plugin es de código abierto (GPL-3.0). Las compilaciones listas para instalar son públicas, igual que el código fuente. Lo que compras es la suscripción: la licencia para usar el plugin en un servidor de Jellyfin, las actualizaciones que incluye tu plan y el soporte: cada actualización mientras la suscripción esté activa, a través de tu repositorio privado de plugins, y ayuda cuando algo no funcione. El plugin comprueba la clave de suscripción una vez al día; sin una suscripción válida se detiene hasta que renueves (no se borra nada). Mensual, anual o de por vida (la de por vida incluye un año de actualizaciones), o incluido en el paquete para Jellyfin. 30 días de prueba gratis.
Código fuente. Para cada versión, el código fuente correspondiente completo es público, junto a la compilación, en el registro de cambios, y también en tu cuenta (Cuenta → Licencias, Código fuente); cada archivo comprimido contiene el texto completo de la GPL-3.0 (LICENSE). Si necesitas el código fuente de una versión que ya no puedes descargar, pídenoslo y te lo enviamos. Consulta la sección 10 del EULA.
Código propio, escrito por MediaLab Works. Código de terceros: el generador de códigos QR se basa en la biblioteca QR Code generator de Project Nayuki (licencia MIT).