Jellyfin

Conecta Crow a Jellyfin para explorar tu biblioteca multimedia, buscar contenido y controlar la reproducción a través de tu asistente de IA.

Qué obtienes

• Buscar en tu biblioteca multimedia (películas, series, música, audiolibros)
• Explorar colecciones y contenido agregado recientemente
• Controlar la reproducción en dispositivos conectados
• Ver qué se está reproduciendo actualmente
• Pestaña automática de Biblioteca en el panel Media Hub

Configuración

Crow soporta dos modos para Jellyfin: autoalojamiento vía Docker o conexión a una instancia existente.

Opción A: Docker (autoalojado)

Instala Jellyfin como un bundle de Crow. Esto ejecuta Jellyfin en Docker junto a tu gateway de Crow.

"Crow, instala el bundle de Jellyfin"

O instálalo desde el panel de Extensiones en el Crow's Nest.

Si lo dejas vacío al instalar, Jellyfin empieza con una biblioteca vacía en la carpeta de Crow (media/jellyfin). Para usar tus archivos, configura la ruta en Configurar (o en el .env del bundle):

# En tu archivo .env
JELLYFIN_MEDIA_PATH=/ruta/a/tus/multimedia

Reinicia el bundle para que los cambios surtan efecto:

"Crow, reinicia el bundle de Jellyfin"

Jellyfin estará disponible en http://tu-servidor:8096 para la configuración inicial (crea una cuenta de administrador y configura las bibliotecas).

Opción B: Conectar a Jellyfin existente

Si ya tienes un servidor Jellyfin funcionando, conecta Crow directamente a él.

Paso 1: Obtener tu clave de API

1. Abre la interfaz web de Jellyfin
2. Ve a Panel de control > Claves de API (en la sección Avanzado)
3. Haz clic en Agregar (el botón +)
4. Ponle un nombre (ej., "Crow")
5. Copia la clave de API generada

Paso 2: Agregar a Crow

Configura lo siguiente en tu archivo .env o vía Crow's Nest > Ajustes > Integraciones:

JELLYFIN_URL=http://tu-servidor-jellyfin:8096
JELLYFIN_API_KEY=tu-clave-api-aqui

Herramientas de IA

Una vez conectado, puedes interactuar con Jellyfin a través de tu IA:

"¿Qué películas he agregado recientemente?"

"Busca documentales en mi biblioteca"

"¿Qué se está reproduciendo ahora?"

"Reproduce el siguiente episodio de The Expanse en la TV de la sala"

Integración con Media Hub

Cuando Jellyfin está instalado, una pestaña de Biblioteca aparece automáticamente en el panel Media Hub del Crow's Nest. Esto te da una interfaz visual para explorar tu biblioteca junto a otras fuentes multimedia.

Referencia de Docker Compose

Si prefieres una configuración manual de Docker en lugar del instalador de bundles:

services:
  jellyfin:
    image: jellyfin/jellyfin:latest
    container_name: crow-jellyfin
    ports:
      - "8096:8096"
    volumes:
      - jellyfin-config:/config
      - jellyfin-cache:/cache
      - ${JELLYFIN_MEDIA_PATH:-/media}:/media:ro
    restart: unless-stopped

volumes:
  jellyfin-config:
  jellyfin-cache:

Solución de problemas

"Conexión rechazada" o tiempo de espera agotado

Asegúrate de que la JELLYFIN_URL sea accesible desde la máquina que ejecuta Crow. Si Jellyfin está en otra máquina, usa la IP o el nombre de host correcto.

"401 No autorizado"

Es posible que la clave de API haya sido eliminada. Crea una nueva desde Panel de control > Claves de API en Jellyfin.

Los archivos multimedia no aparecen

Jellyfin necesita escanear tu biblioteca multimedia después de configurar JELLYFIN_MEDIA_PATH. Abre la interfaz web de Jellyfin y activa un escaneo de biblioteca desde Panel de control > Bibliotecas.