media_preview_generator
Generación de miniaturas de video aceleradas por GPU para Plex, Emby y Jellyfin.
Ficha actualizada 23 sept 2026, 5:28 · upstream 23 sept 2026, 2:52 · release 4.4.2
Qué es media_preview_generator
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Media Preview Generator es una herramienta que genera miniaturas de video en tiempo real utilizando hardware acelerado (GPU). Permite generar thumbnails para Plex, Emby y Jellyfin sin necesidad de instalar software adicional. La herramienta se ejecuta fuera del servidor de medios, procesando archivos en paralelo y reutilizando resultados cuando múltiples servidores comparten el mismo contenido.
El problema principal es que la generación de miniaturas integrada en los servidores tiene limitaciones: Plex genera thumbnails solo con CPU (sin GPU), Emby no soporta aceleración por GPU en absoluto, y Jellyfin, aunque tiene hardware-accelerated trickplay, comparte recursos con la reproducción. Esta solución resuelve estos problemas al ejecutar el procesamiento off-server, aprovechando cada GPU disponible.
Además, la herramienta automatiza el flujo de trabajo mediante integraciones con Radarr, Sonarr, Tdarr y importes manuales por servidor, con un sistema de deduplicación inteligente que re-genera solo los archivos que realmente cambian. Incluye una panel de "Previews Readiness" para auditar cada flag del servidor afectado.
Soporta múltiples plataformas: Linux (NVIDIA, AMD, Intel), Windows (Docker Desktop con WSL2 o Docker Desktop puro) y macOS (Docker Desktop). En Windows, las GPUs NVIDIA funcionan a través de CUDA/NVENC en WSL2. Las GPU AMD e Intel en Windows y el VideoToolbox en macOS no son accesibles desde dentro del contenedor Linux, por lo que se ejecutan exclusivamente con CPU.
El sistema incluye un fallback automático: si una GPU falla (codec no soportado, error de hardware), la misma tarea se reintentará en modo CPU. Si hay muchos archivos que nunca decodifican en GPU, se pueden configurar workers dedicados para evitar bloqueos.
La interfaz web permite gestionar servidores, configurar opciones de generación por GPU, crear triggers automáticos (webhooks, cron, intervalos), y monitorear el estado de cada tarea con indicadores visuales.
- Generación automática de miniaturas de video para Plex, Emby y Jellyfin sin necesidad de instalar software adicional
- Automatización del flujo de trabajo con Radarr, Sonarr, Tdarr o importes manuales por servidor mediante un solo webhook universal
- Procesamiento paralelo en múltiples servidores que comparten el mismo contenido (deduplicación inteligente)
- Aceleración GPU para generar thumbnails rápidamente sin saturar los recursos del servidor de medios
- Auditoría y configuración de cada flag del servidor afectado con una interfaz web dedicada
- Soporte multi-archivo: generación por título, por episodio, por película o por archivo individual
- Procesa cada archivo solo una vez mediante un único paso de FFmpeg, independientemente de cuántos servidores lo contengan
- Aprovecha la aceleración por GPU (CUDA/NVENC/VAAPI) en plataformas que lo soportan: NVIDIA Linux, Windows WSL2, Intel/AMD Linux
- Fallback automático a CPU cuando una GPU falla o no es compatible con el codec del archivo
- Soporte de HDR y Dolby Vision tone mapping (incluyendo Profile 5 vía libplacebo)
- Deduplicación inteligente: re-genera solo archivos que realmente cambian tras un intercambio de calidad en Radarr/Sonarr/Tdarr
- Panel "Previews Readiness" para auditar cada flag del servidor afectado con una configuración por GPU
- Windows AMD y Intel no soportan aceleración por GPU desde Docker Desktop (solo CPU)
- macOS no soporta aceleración por GPU vía VideoToolbox desde dentro de Docker Desktop
- Docker Desktop WSL2 backend no es accesible para GPUs AMD e Intel en Windows
- No hay CLI independiente; toda la configuración y gestión se realiza a través de la interfaz web
- La generación de thumbnails puede consumir recursos significativos (GPU, CPU) dependiendo del contenido y la configuración
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.
Recomendado usar Docker con el contenedor `stevezzau/media_preview_generator:latest` en un entorno aislado (Docker Swarm, Kubernetes, Unraid, etc.),Configurar `/etc/localtime` para que los logs y cron jobs se registren en la zona horaria local del servidor,Alternativa de timezone: `-e TZ=America/New_York` si no desea usar el sistema local,Para Docker Compose, usar `docker-compose.example.yml` como base,Configurar los volúmenes `/media`, `/plex/config` y `/app/config` para almacenar las miniaturas generadas y la configuración del servidor,En producción, considerar un contenedor con escalabilidad (replicas) si el contenido crece exponencialmente
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.