media-preview-generator
media-preview-generator
Aplicación Docker from stevezau's Repository
Visión general
Generate video preview thumbnails for Plex, Emby and Jellyfin with GPU acceleration support. One FFmpeg pass writes the right format for each server (Plex BIF bundle, Emby sidecar BIF, Jellyfin trickplay tiles).
This template seeds a Plex connection below; add Emby/Jellyfin servers (any mix) from the web UI after first start.
Features:
- Web UI with setup wizard for easy configuration
- Plex OAuth authentication (no manual token needed)
- GPU acceleration (NVIDIA, Intel QuickSync, AMD)
- Background processing with job queue
- Real-time progress display
- Scheduled generation via cron expressions
- Browser notifications when jobs complete
The web interface is available at http://[IP]:8080 after starting the container.
A setup wizard will guide you through connecting to your Plex server.
IMPORTANT - NETWORKING:
If your Plex container uses a custom network (like br1 or macvlan), this container
must use the SAME network to communicate with Plex. Change the Network Type setting
to match your Plex container's network.
GPU SETUP — pick ONE path:
[Intel / AMD]
Pass /dev/dri through (already configured below — no further action needed).
[NVIDIA] — REQUIRED STEPS, in this order:
- Install the Nvidia-Driver plugin from Community Applications (bundles the NVIDIA driver and nvidia-container-toolkit needed for --runtime=nvidia).
- Add --runtime=nvidia to "Extra Parameters" on this template (NOT --gpus all).
- Set the NVIDIA_VISIBLE_DEVICES and NVIDIA_DRIVER_CAPABILITIES variables below.
- Optional: if your host has no Intel iGPU and the container fails with a /dev/dri error, remove the Intel GPU Device field.
Common error: "docker: Error response from daemon: AMD CDI spec not found"
-> You're using --gpus all on Unraid. Replace it with --runtime=nvidia.
Why NVIDIA_DRIVER_CAPABILITIES=all? The 'graphics' capability is required for
Dolby Vision Profile 5 thumbnails (libplacebo Vulkan tone-mapping).
'compute,video,utility' alone covers only CUDA/NVDEC and nvidia-smi.
Argumentos en tiempo de ejecución
- Interfaz web
http://[IP]:[PORT:8080]/- Red
bridge- Concha
bash- Privilegiado
- false
- Parámetros adicionales
--restart=unless-stopped
Configuración de plantillas
Port for the web interface
- Objetivo
- 8080
- Por defecto
- 8080
- Valor
- 8080
URL to your Plex Media Server (use IP address, not localhost)
- Objetivo
- PLEX_URL
- Por defecto
- http://192.168.1.100:32400
Plex authentication token. Find it at: https://support.plex.tv/articles/204059436-finding-an-authentication-token-x-plex-token/ (or use OAuth via Web UI)
- Objetivo
- PLEX_TOKEN
Path to your media files on Unraid (read-only)
- Objetivo
- /media
- Por defecto
- /mnt/user/media
- Valor
- /mnt/user/media
Path to Plex application data where previews will be stored
- Objetivo
- /plex
- Por defecto
- /mnt/user/appdata/plex/Library/Application Support/Plex Media Server
- Valor
- /mnt/user/appdata/plex/Library/Application Support/Plex Media Server
Path to store configuration, schedules, and job history
- Objetivo
- /config
- Por defecto
- /mnt/user/appdata/media-preview-generator
- Valor
- /mnt/user/appdata/media-preview-generator
How this container sees media (usually /media)
- Objetivo
- PLEX_LOCAL_VIDEOS_PATH_MAPPING
- Por defecto
- /media
- Valor
- /media
How Plex sees media (if different from this container's path)
- Objetivo
- PLEX_VIDEOS_PATH_MAPPING
Seconds between each preview frame (default: 5). Migrated to settings.json on first start.
- Objetivo
- PLEX_BIF_FRAME_INTERVAL
- Por defecto
- 5
- Valor
- 5
Preview image quality 1-10, higher = better quality but larger files (default: 4). Migrated to settings.json on first start.
- Objetivo
- THUMBNAIL_QUALITY
- Por defecto
- 4
- Valor
- 4
Number of parallel CPU workers for fallback (default: 1). Migrated to settings.json on first start. GPU config (enable/disable, workers per GPU) is in Web UI Settings.
- Objetivo
- CPU_THREADS
- Por defecto
- 1
- Valor
- 1
Optional: Override the authentication token. If empty, use the token set during the setup wizard (or auto-generated if skipped)
- Objetivo
- WEB_AUTH_TOKEN
Internal port for web server (usually matches Web UI Port)
- Objetivo
- WEB_PORT
- Por defecto
- 8080
- Valor
- 8080
User ID for file permissions (99 = nobody on Unraid)
- Por defecto
- 99
- Valor
- 99
Group ID for file permissions (100 = users on Unraid)
- Por defecto
- 100
- Valor
- 100
File permission mask
- Por defecto
- 022
- Valor
- 022
Pass through Intel GPU for QuickSync acceleration
- Objetivo
- /dev/dri
- Por defecto
- /dev/dri
- Valor
- /dev/dri
REQUIRES --runtime=nvidia in Extra Parameters — without it, this variable is ignored and the container will either fail to start (e.g. 'AMD CDI spec not found') or fall back to CPU. Recommended value: 'all' (includes the 'graphics' capability needed for Dolby Vision Profile 5 thumbnails via libplacebo Vulkan tone-mapping). 'compute,video,utility' alone covers only CUDA/NVDEC and will NOT give you DV5 support.
- Objetivo
- NVIDIA_DRIVER_CAPABILITIES
- Por defecto
- all
- Valor
- all
REQUIRES --runtime=nvidia in Extra Parameters — without it, this variable is ignored. Which NVIDIA GPUs to expose to the container, e.g. 'all' or a specific GPU UUID. Do NOT use --gpus all on Unraid; that triggers CDI resolution and fails with 'AMD CDI spec not found'.
- Objetivo
- NVIDIA_VISIBLE_DEVICES
Logging level: DEBUG, INFO, WARNING, ERROR
- Objetivo
- LOG_LEVEL
- Por defecto
- INFO
- Valor
- INFO
Categorías
Descargar estadísticas
Detalles
stevezzau/media_preview_generator:latestEjecute media-preview-generator en Unraid.
media-preview-generator se encuentra en Community Apps para Unraid OS. Explore Unraid para crear un servidor doméstico flexible, un NAS o un laboratorio doméstico.