ephyra
Dashboard de estadísticas rápido y auto-alojado para Jellyfin. Proporciona análisis de bibliotecas, historial de visualización y candidatos a limpieza. Es una única binaria en Go con frontend incrustado, diseñada para ejecutarse junto a Jellyfin en Docker con carga mínima en el servidor.
Ficha actualizada 27 sept 2026, 13:36 · upstream 27 sept 2026, 13:18 · release v0.5.0
Qué es ephyra
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Ephyra es un panel de estadísticas rápido y auto-alojado para Jellyfin, diseñado para proporcionar análisis detallados de bibliotecas, historial de visualización y candidatos a limpieza sin sobrecargar el servidor principal. Se distribuye como una única binaria en Go con el frontend incrustado, lo que facilita su despliegue junto a Jellyfin en entornos Docker o nativos con una huella de recursos mínima.
- Visualizar el desglose de la biblioteca (géneros, décadas y crecimiento).
- Monitorizar historial de visualización y estadísticas de reproducción por usuario.
- Identificar candidatos a limpieza para optimizar el almacenamiento local.
- Analizar perfiles de usuarios y consumo de contenido en tiempo real.
- Ver qué se está reproduciendo ahora mismo (Now Playing) en la red.
- Binaria Go única con frontend embebido, sin dependencias externas ni contenedores pesados.
- Carga mínima en el servidor Jellyfin principal al leer bases de datos SQLite en modo solo lectura.
- Supervivencia a actualizaciones de Jellyfin (10.11 a 12.0) sin cambios de código.
- Persistencia propia de eventos de reproducción independiente del plugin Playback Reporting.
- Soporte nativo para despliegue en Docker y sistemas operativos nativos con systemd.
- Mecanismo de detección de cambios (mtime) que evita refrescos innecesarios de la biblioteca.
- Estado Alpha: Puede tener bordes ásperos y cambios sin aviso oficial.
- Requiere clave API de Jellyfin para iniciar; sin ella, el servicio no arranca.
- Algunas páginas (Stats, Profiles) requieren el plugin Playback Reporting instalado en Jellyfin.
- Lectura de bases de datos SQLite requiere copias o permisos específicos para evitar bloqueos WAL.
- No incluye autenticación propia; debe protegerse mediante red local o proxy inverso existente.
Capturas del proyecto
Imágenes reales detectadas en la documentación del repositorio.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Despliega en Docker usando `docker compose up -d` con un volumen bind-mounted de solo lectura hacia la configuración de Jellyfin. Configura obligatoriamente la variable `EPHYRA_JELLYFIN_API_KEY` antes de iniciar el contenedor. Asegura que el UID del contenedor (65532) tenga permisos de lectura en los archivos SQLite de Jellyfin, añadiendo grupos si es necesario (`group_add`). Para despliegues nativos, utiliza binarias estáticas y configura un servicio systemd ejecutándose como usuario `jellyfin`. Nunca expongas el puerto 8097 directamente a internet sin un proxy inverso que gestione la autenticación.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.