quality-gate-encoder
quality-gate-encoder es el componente de codificación del plugin Quality Gate para Jellyfin. Automatiza la creación de versiones 720p en HEVC, H.264 o AV1 con aceleración por hardware (NVIDIA NVENC, Intel QSV) y software.
Ficha actualizada 26 sept 2026, 7:44 · upstream 26 sept 2026, 7:36 · release v1.5.0
Qué es quality-gate-encoder
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
quality-gate-encoder actúa como el motor de codificación del plugin Quality Gate para Jellyfin, automatizando la generación de versiones optimizadas de 720p para bibliotecas multimedia. Su objetivo principal es facilitar el streaming eficiente en dispositivos móviles y remotos mediante la creación proactiva de archivos comprimidos que evitan la carga de transcoding en tiempo real durante la reproducción.
- Optimización del ancho de banda para streaming móvil mediante versiones 720p pre-codificadas.
- Reducción de la carga CPU/GPU del servidor Jellyfin al evitar transcoding en tiempo real.
- Gestión de bibliotecas híbridas manteniendo archivos originales y versiones comprimidas accesibles simultáneamente.
- Automatización de migración a codecs modernos como AV1 o HEVC sin intervención manual.
- Normalización de pistas de audio y subtítulos para garantizar compatibilidad en clientes heterogéneos.
- Soporte nativo para aceleración por hardware NVIDIA NVENC e Intel QSV con fallback automático a software.
- Monitorización de carpetas compatible con sistemas de archivos de red (NFS, CIFS) mediante polling.
- Gestión segura de limpieza con guardas contra borrado masivo accidental y verificación de salud del montaje.
- Compatibilidad multi-contenedor (MP4 para H.264/AAC, MKV para HEVC/AV1) con gestión de enlaces simbólicos.
- Lógica inteligente de salto basada en heurísticas de nombre de archivo y análisis de resolución ffprobe.
- Requiere acceso explícito a dispositivos GPU (/dev/dri o NVIDIA Container Toolkit) para aceleración hardware.
- La monitorización utiliza polling, lo que introduce un ligero retraso en la detección de cambios respecto a eventos en tiempo real.
- No soporta bloqueo cruzado entre contenedores; evitar apuntar dos instancias al mismo subdirectorio destino.
- Pérdida de pistas de subtítulos bitmap (PGS, DVB) al convertir a MP4, que solo admiten texto (mov_text).
- La lógica de salto puede fallar si los metadatos o nombres de archivo no coinciden con las heurísticas esperadas.
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.
Configurar variables de entorno para definir codec (hevc/h264/av1), calidad y tipo de aceleración. Asignar GPU vía dispositivos Docker o reservas en Compose. Asegurar espacio libre mínimo en destino (DEST_MIN_FREE_GB). Usar PRIORITY_FILE para priorizar carpetas específicas. Verificar compatibilidad del sistema operativo con drivers NVIDIA o QSV antes de iniciar.
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.