Jellyfin.Xtream en Jellyfin

1) Requisitos

• Jellyfin 10.8+ en marcha (con acceso de administrador).

• Un endpoint Xtream compatible (URL base, usuario y contraseña).

• Acceso al panel de administración de Jellyfin.

El plugin integra contenidos de una API Xtream-compatible dentro de Jellyfin. GitHub

2) Instalación del plugin (vía repositorio personalizado)

1. Entra a Panel admin → Plugins → Repositories.

2. Pulsa + para añadir un repositorio:

   • Name: Jellyfin.Xtream

   • URL: https://kevinjil.github.io/Jellyfin.Xtream/repository.json

   • Save. GitHub

3. Ve a Plugins → Catalog → sección Live TV → Jellyfin Xtream → Install.

4. (Opcional) Elige la versión que prefieras antes de instalar.

5. Reinicia el servidor Jellyfin para completar la instalación. Este paso es obligatorio. GitHub

La versión estable más reciente figura en Releases del repo (a fecha de hoy aparece v0.8.0). GitHub

3) Configuración del plugin

Después de reiniciar: Panel admin → Plugins → Jellyfin Xtream.

3.1 Credenciales (pestaña Credentials)

• Base URL: URL del endpoint incluyendo protocolo (http/https) y sin barra final.
  Ejemplo: https://mi-servidor-xtream.com:8080

• Username: tu usuario Xtream.

• Password: tu contraseña Xtream. GitHub

3.2 TV en directo (Live TV)

1. Abre la pestaña Live TV.

2. Selecciona categorías o canales concretos que quieras exponer.

3. (Opcional) En TV Overrides ajusta número de canal, nombre e iconos.

4. Pulsa Save al final. GitHub

3.3 Películas/Series bajo demanda

• Video On-Demand: Activa “Show this channel to users”, elige categorías/vídeos y Save. GitHub

• Series: Activa “Show this channel to users”, elige categorías/series y Save. GitHub

3.4 Catch-up (TV a la carta)

• En Live TV, activa “Show the catch-up channel to users” y Save. GitHub

4) Ajuste de red recomendado en Jellyfin

Para que clientes externos encuentren correctamente tu servidor y los enlaces funcionen fuera de tu LAN:

• Panel admin → Networking → Published server URIs
  Añade una línea tipo:
  all=https://tuservidor.ejemplo.com
  (Ajusta a tu dominio/URL pública). GitHub+1

5) Dónde aparece el contenido

• Live TV: los canales Xtream quedan disponibles como fuente de TV (sintonizador virtual).

• Películas/Series: verás entradas según lo que hayas activado en Video On-Demand / Series dentro del plugin. (Si no aparecen, revisa el apartado de problemas.)

6) Seguridad importante (credenciales en rutas)

El formato Xtream incluye usuario/contraseña en las URLs remotas. Jellyfin muestra rutas remotas en su API y en algunas vistas, así que cualquiera con acceso al servidor podría verlas. Si compartes tu servidor con otros usuarios, úsalo con precaución (o limita el acceso). GitHub

7) Problemas comunes y soluciones

• No aparece nada tras configurar

  • Asegúrate de haber hecho el reinicio del servidor Jellyfin tras instalar/actualizar el plugin. GitHub

  • Revisa Credentials (URL base correcta, usuario/clave).

  • En Live TV / VOD / Series, confirma que has marcado categorías o elementos y pulsado Save. GitHub

  • Comprueba Networking → Published server URIs cuando accedes desde fuera de la LAN. GitHub+1

• Canales se ven, pero reproducción falla desde fuera

  • Verifica que tu servidor Jellyfin es accesible por la URL pública y que no hay bloqueo de puertos/cortafuegos (según tu despliegue).

• Orden/íconos de canales

  • Usa TV Overrides para ordenar/renumerar y asignar logos. GitHub

8) Buenas prácticas

• Reinicia Jellyfin tras instalar o actualizar el plugin y cuando hagas cambios grandes en la selección de categorías (si ves que no refresca). GitHub

• Documenta tu Base URL / credenciales Xtream y guarda copia segura.

• Si compartes tu Jellyfin, restringe qué usuarios ven las vistas de Xtream, dadas las advertencias de confidencialidad. GitHub