Jellyfin
Incluida en Macro DeckControla las apps y televisores de Jellyfin desde tu deck, muestra lo que se reproduce y reacciona cuando la reproducción empieza o se detiene.
Dos widgets Reproductor de música reproduciendo una pista, uno con el estilo Portada completa y otro con el estilo Portada pequeña, ambos con el nombre y el logotipo de Jellyfin en el encabezado
- Controla la reproducción y el volumen en apps, navegadores y televisores de Jellyfin
- Busca una película, un episodio, una canción o un álbum e inícialo
- Disparadores cuando la reproducción empieza, se pausa, se reanuda o se detiene
- Widgets Reproductor de música y Sesiones de Jellyfin
- Conecta varios servidores, cada uno con sus propias variables
La integración Jellyfin conecta Macro Deck con uno o varios servidores multimedia Jellyfin y trabaja con sus sesiones: las apps, navegadores y televisores de Jellyfin que tienen la sesión iniciada y están reproduciendo. No necesita ningún complemento de Jellyfin. Inicias sesión con una clave de API, que permite a Macro Deck ver y controlar todas las sesiones del servidor, o con un nombre de usuario y una contraseña, que lo limitan a las sesiones que esa cuenta puede controlar.
Qué puedes hacer
- Reproduce, pausa, detén, salta, ve a una posición o avanza y retrocede un número de segundos.
- Ajusta el volumen, silencia y quita el silencio, y configura el orden aleatorio y la repetición en un cliente.
- Busca en el servidor una película, un episodio, una canción o un álbum e inícialo en un dispositivo con Reproducir contenido.
- Muestra un mensaje con un título en un cliente de Jellyfin.
- Muestra lo que se reproduce en el widget Reproductor de música, o la reproducción en tus servidores en el widget Sesiones de Jellyfin.
- Inicia una automatización cuando la reproducción empieza, se pausa, se reanuda o se detiene, cuando cambia el contenido o cuando se conecta un cliente.
Algunos ejemplos:
- Un botón Toggle Play/Pause para el televisor del salón, con Retroceder al lado para repetir los últimos 10 segundos.
- Una automatización con Reproducción iniciada para tu televisor que atenúa las luces cuando
{{ event.itemType }}esMovie, y otra con Reproducción detenida que las vuelve a subir. - Un botón que muestra "La cena está lista" en el televisor con Mostrar mensaje.
Servidores y dispositivos
Cada servidor que añades aparece de dos formas en todos los lugares donde eliges un reproductor. El nombre del servidor sigue a la sesión que haya reproducido algo más recientemente. Servidor · Dispositivo, por ejemplo Home · Living Room TV, siempre apunta a ese dispositivo y figura como no conectado mientras el dispositivo está apagado. Macro Deck recuerda los dispositivos durante 30 días desde la última vez que los vio.
Macro Deck sigue a un servidor en directo a través de su WebSocket en Jellyfin 10.11 y posteriores. Cuando un servidor no envía actualizaciones en directo, pide las sesiones cada dos segundos. Cuando un servidor desaparece, Macro Deck lo sigue intentando en segundo plano y lo indica en la página de Jellyfin de Integraciones tras varios intentos fallidos. No todos los clientes de Jellyfin admiten todos los comandos: un comando que el cliente no puede ejecutar falla con un mensaje.
Qué necesitas
- Un servidor Jellyfin al que pueda llegar por la red el ordenador en el que se ejecuta Macro Deck.
- Una clave de API del panel de Jellyfin (recomendado), o un nombre de usuario y una contraseña de Jellyfin.
- Jellyfin 10.11 o posterior para las actualizaciones en directo. Sin ellas, Macro Deck pide las sesiones cada dos segundos.
Configúrala
Paso 1: Crea una clave de API en Jellyfin
Abre el panel de Jellyfin y ve a API Keys. Crea una clave nueva y cópiala. Si prefieres iniciar sesión con una cuenta de usuario, sáltate este paso.
Paso 2: Añade una configuración en Macro Deck
En Macro Deck, haz clic en Integraciones en la barra lateral y después en Jellyfin. En la pestaña Resumen, haz clic en Añadir configuración en la sección Configuración. Activar el interruptor de arriba a la derecha abre el mismo cuadro de diálogo, y la integración se activa cuando termina la configuración.
Paso 3: Introduce los datos del servidor
En el cuadro de diálogo Conectar con Jellyfin, rellena:
- Nombre de la configuración: un nombre para este servidor, por ejemplo
Home. Se usa en los nombres de los reproductores y en las variables. - Dirección del servidor: la dirección con su puerto y su ruta base, si la tiene, por ejemplo
http://192.168.1.10:8096. - Iniciar sesión con: Clave de API o Nombre de usuario y contraseña; después introduce la Clave de API, o el Nombre de usuario y la Contraseña.
Haz clic en Continuar. Macro Deck comprueba la conexión antes de guardar.
- Nombre de la configuración: un nombre para este servidor, por ejemplo
Paso 4: Comprueba la conexión
La nueva configuración muestra Conectado en la sección Configuración de la página de Jellyfin. Repite los pasos para cada servidor adicional.
Paso 5: Añade una acción a un botón
En la página Deck, haz clic en el botón que quieras usar. El deck tiene que estar desbloqueado: lo está cuando el botón de arriba a la derecha dice Bloquear. El editor se abre con Pulsación corta seleccionada. Haz clic en + Añadir acción, selecciona Jellyfin a la izquierda del cuadro de diálogo Añadir acción y elige una acción como Toggle Play/Pause. Selecciona el servidor o el dispositivo que controla y haz clic en Guardar.
Paso 6: Pulsa el botón
Inicia algo en el cliente de Jellyfin y pulsa el botón en tu deck. La reproducción se pausa o se reanuda en ese cliente.
Acciones20
Ponlas en un botón o ejecútalas desde un flujo.
- Play
- Reanuda la reproducción en el cliente.
- Pause
- Pausa la reproducción en el cliente.
- Toggle Play/Pause
- Alterna entre reproducir y pausar, y muestra el estado de reproducción en el botón.
- Detener
- Detiene la reproducción en el cliente.
- Next Track
- Salta al siguiente elemento.
- Previous Track
- Salta al elemento anterior.
- Refresh State
- Lee al momento el estado de reproducción actual.
- Seek
- Salta a una posición del elemento actual, en segundos.
- Avanzar
- Avanza en el elemento actual, 30 segundos de forma predeterminada.
- Retroceder
- Retrocede en el elemento actual, 10 segundos de forma predeterminada.
- Set Volume
- Ajusta el volumen del cliente, de 0 a 100 %.
- Volume Up
- Sube el volumen un 10 %.
- Volume Down
- Baja el volumen un 10 %.
- Silenciar
- Silencia el cliente.
- Quitar silencio
- Vuelve a activar el sonido del cliente.
- Alternar silencio
- Silencia el cliente o le quita el silencio.
- Toggle Shuffle
- Activa o desactiva el orden aleatorio, o lo alterna.
- Set Repeat Mode
- Establece la repetición en Off, Repeat Track o Repeat Album/Playlist.
- Mostrar mensaje
- Muestra en el cliente un mensaje con un título durante un número de segundos.
- Reproducir contenido
- Busca una película, un episodio, una canción o un álbum y lo inicia en el cliente, sustituyendo lo que se esté reproduciendo.
Disparadores9
Un botón o un flujo puede reaccionar a estos eventos.
- Reproducción iniciada
- Una sesión empezó a reproducir algo.
- Reproducción pausada
- Se pausó la reproducción en una sesión.
- Reproducción reanudada
- La reproducción pausada continuó en una sesión.
- Reproducción detenida
- Una sesión dejó de reproducir.
- Contenido en reproducción cambiado
- Una sesión pasó a otra película, otro episodio u otra pista.
- Sesión conectada
- Un cliente de Jellyfin abrió una sesión en el servidor.
- Sesión desconectada
- El servidor cerró la sesión de un cliente.
- Conectado
- Macro Deck se conectó al servidor.
- Desconectado
- Macro Deck perdió la conexión con el servidor.
Variables7
Muestra estos valores en botones y widgets, o úsalos en condiciones.
jellyfin_active_sessions- Las sesiones en reproducción o en pausa de todos los servidores juntos.
jellyfin_<server>_is_connected,jellyfin_<server>_active_sessions- Si Macro Deck llega a cada servidor y cuántas sesiones se reproducen en él.
jellyfin_<server>_<device>_is_playing,jellyfin_<server>_<device>_is_paused,jellyfin_<server>_<device>_is_active- Si algo se reproduce, está en pausa o está cargado en el dispositivo. Escribir en la variable de reproducción o de pausa reproduce o pausa.
jellyfin_<server>_<device>_title,jellyfin_<server>_<device>_series,jellyfin_<server>_<device>_album,jellyfin_<server>_<device>_media_type- El título, la serie, el álbum (o la temporada) y el tipo de contenido del elemento de cada dispositivo.
jellyfin_<server>_<device>_position,jellyfin_<server>_<device>_duration,jellyfin_<server>_<device>_progress_percent- La posición y la duración en segundos y el progreso en porcentaje. Escribir en la posición o en el progreso salta a ese punto.
jellyfin_<server>_<device>_user,jellyfin_<server>_<device>_client,jellyfin_<server>_<device>_device,jellyfin_<server>_<device>_is_transcoding- El usuario, el cliente y el dispositivo de cada sesión, y si el servidor convierte el contenido.
jellyfin_<server>_<device>_volume,jellyfin_<server>_<device>_is_muted- El volumen y el estado de silencio de cada dispositivo, cuando los informa. Escribir en ellas ajusta el volumen o silencia.
Widgets2
Añádelos a tu deck desde el selector de widgets.
- Reproductor de música
- Muestra lo que se reproduce en un servidor o un dispositivo, con carátula, progreso y botones para reproducir, pausar y saltar. Las líneas se adaptan a canciones, episodios y películas.
- Sesiones de Jellyfin
- Muestra lo que se reproduce en uno o en todos tus servidores, con la carátula o el póster, quién lo reproduce, en qué dispositivo y cuánto lleva.
Preguntas frecuentes
¿Uso una clave de API o un nombre de usuario y una contraseña?
Se recomienda una clave de API: así Macro Deck ve y controla todas las sesiones del servidor. Con un nombre de usuario y una contraseña, solo ve las sesiones que esa cuenta puede controlar. La contraseña se usa una vez para iniciar sesión y no se guarda; Macro Deck solo conserva el token de acceso que entrega Jellyfin.
¿Puedo conectar más de un servidor?
Sí. Añade una configuración por servidor. Cada una tiene sus propias variables, con el nombre de la configuración, y muestra si está conectada.
¿Por qué falla un comando en mi televisor o en el navegador?
No todos los clientes de Jellyfin admiten todos los comandos. Macro Deck solo envía lo que el cliente dice que puede hacer, así que un comando que no puede ejecutar falla con un mensaje. El volumen y el silencio suelen funcionar solo en las apps de Jellyfin, no en una pestaña del navegador.
¿Qué pasa cuando el servidor está sin conexión?
Macro Deck lo sigue intentando en segundo plano y, tras varios intentos fallidos, muestra el problema Servidor de Jellyfin no disponible en la página de Jellyfin de Integraciones. Las acciones para ese servidor fallan con un mensaje hasta que vuelva a estar disponible.
¿Uso los disparadores de Jellyfin o los de Music Player?
Los disparadores de Music Player, como Reproducción iniciada en Music Player, también se activan con Jellyfin, una vez para el servidor y otra para el dispositivo. Para las automatizaciones, los disparadores de Jellyfin son la mejor opción: se activan una vez por dispositivo e incluyen el usuario y el tipo de contenido.
Más en Música y audio
Spotify
Incluida en Macro DeckControla la reproducción de Spotify, marca canciones con me gusta, gestiona listas de reproducción y muestra en tu deck lo que suena.
YouTube Music Desktop App
Incluida en Macro DeckControla YouTube Music Desktop App desde tu deck: reproducción, volumen, valoraciones y lo que está sonando.
WebNowPlaying
Incluida en Macro DeckControla la música y los vídeos que suenan en tu navegador y muestra lo que se reproduce, mediante la extensión WebNowPlaying.
SoundPad
Incluida en Macro DeckReproduce sonidos de tu lista de SoundPad, controla las grabaciones y muestra en tu deck el sonido que suena.
Voicemeeter
Incluida en Macro DeckControla desde tu deck la ganancia, el silencio, el enrutamiento y los botones de macro de Voicemeeter, Banana o Potato.