emby-playback-guardian
Contenedor Docker ligero para Emby/Jellyfin que protege la reproducción pausando tareas de biblioteca, matando escaneos atascados y limitando descargas durante streaming activo mediante monitoreo de I/O y API.
Ficha actualizada 23 sept 2026, 20:27 · upstream 23 sept 2026, 19:51 · release v1.3.2
Qué es emby-playback-guardian
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este proyecto es un contenedor Docker diseñado para homelabs que resuelve el conflicto entre tareas de mantenimiento de fondo (escaneos, metadatos) y la reproducción activa en servidores Emby o Jellyfin. Al monitorizar sesiones activas a través de la API y el uso del disco, interviene automáticamente para evitar buffering o stuttering causados por saturación de I/O.
La herramienta pausa tareas configurables como escaneos de biblioteca o descargas de subtítulos cuando detecta reproducción, y aplica throttling a clientes de descarga como qBittorrent o SABnzbd. Incluye detección de tareas atascadas mediante progreso o tiempo absoluto, restaurando la operación normal al finalizar el streaming.
Destaca por su ligereza (64 MB, sin base de datos), soporte multiplataforma para monitoreo de I/O (Linux, Windows, macOS) y endpoints de salud para Prometheus. Ofrece modo dry-run para pruebas seguras antes de activar acciones reales en la infraestructura.
- Evitar buffering durante reproducción activa en servidores domésticos
- Automatizar la pausa de escaneos de biblioteca sin intervención manual
- Limitar velocidad de descargas (qBittorrent/SABnzbd) cuando el disco está saturado o hay reproducción
- Monitoreo de salud del sistema para scraping Prometheus
- Detección y terminación automática de procesos de escaneo atascados
- Gestión de notificaciones vía Discord o webhooks genéricos sobre eventos críticos
- Arquitectura ligera en Python sin base de datos persistente
- Soporte nativo para monitoreo de I/O en Linux, Windows y macOS
- Endpoints /health y /metrics integrados para observabilidad
- Modo dry-run para validar detección antes de ejecutar acciones
- Detección dual de tareas atascadas (por progreso o tiempo absoluto)
- Retries automáticos al inicio para conectar con el servidor de medios
- Requiere configuración manual de dispositivos I/O según el sistema operativo
- Dependencia de credenciales API del servidor Emby/Jellyfin
- Latencia de detección basada en polling (intervalo por defecto 30s)
- Configuración de throttling requiere acceso a clientes de descarga externos
- No incluye interfaz gráfica, solo gestión vía contenedor y env vars
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.
Iniciar con DRY_RUN=true para validar la detección antes de activar acciones reales. Configurar DISK_DEVICES según el SO (ej. sda,sdb en Linux o M:,7 en Windows). Asegurar que los puertos 8095 estén libres si se usan endpoints de salud. Usar mem_limit: 64m para mantener la ligereza.
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.