FFmpeg-Easy-Unraid

Overview

FFmpeg-Easy-Unraid is a "Set and Forget" Batch Transcoder designed for Unraid. Features: * Run-Once Workflow: This container scans /import on startup, processes the queue, and stops. To process new files, simply restart the container. It does not monitor continuously. * Structure: Recursively scans directories and preserves the exact folder structure (Great for TV Series). * Codecs: H.265 (HEVC) and AV1. (Note: AV1 requires modern GPU hardware like RTX 40xx or Intel Arc). * Hardware: CPU, Nvidia (NVENC), Intel (QuickSync/Arc). * Safety: Detects CPU pinning. Limits threads to 50% if no pinning is detected to prevent server freeze. IMPORTANT FOR NVIDIA USERS: To enable GPU support, you MUST enable "Advanced View" (top right) and add --runtime=nvidia to the "Extra Parameters" field! You must also set the "Nvidia Visible Devices" variable. IMPORTANT FOR INTEL GPU USERS: To enable QuickSync/Arc support, you must pass the device /dev/dri to the container (Add Device -> /dev/dri).

Runtime arguments

Network: bridge
Shell: bash
Privileged: false
Extra Params: --cap-add=SYS_NICE

Template configuration

Input Path (Source)Pathrw

Path to source files. Originals move to /finished after success.

Target: /import
Default: /mnt/user/import/

Output Path (Destination)Pathrw

Destination for converted files.

Target: /export
Default: /mnt/user/export/

Encoding MethodVariable

cpu_h265 (Best Quality), cpu_av1, nvidia_h265, nvidia_av1 (Requires RTX 40xx), intel_h265, intel_av1

Target: ENCODE_METHOD
Default: cpu_h265

PresetVariable

'default' (recommended) or manual (slow, fast, p1-p7).

Target: ENCODE_PRESET
Default: default

Quality (CRF - CPU/Intel)Variable

Lower = Better. Empty = Smart Default (18/24).

Target: ENCODE_CRF

Quality (CQ - Nvidia)Variable

Lower = Better. Empty = Smart Default (19/24).

Target: ENCODE_CQ

CPU ThreadsVariable

0 = Auto (Safety Mode: 50% if no pinning). Set number to force.

Target: ENCODE_THREADS
Default: 0

Custom FFmpeg ArgsVariable

Override audio/sub args (Default: -c:a copy -c:s copy).

Target: FFMPEG_CUSTOM_ARGS

Nvidia Visible DevicesVariable

Set your GPU UUID here (e.g. GPU-xxxx) or leave as 'all'. REQUIRED for Nvidia encoding.

Target: NVIDIA_VISIBLE_DEVICES
Default: all

Nvidia Driver CapabilitiesVariable

Keep this as 'all' or 'compute,video,utility'.

Target: NVIDIA_DRIVER_CAPABILITIES
Default: all

Unraid User IDVariable

UID

Target: UNRAID_UID
Default: 99

Unraid Group IDVariable

GID

Target: UNRAID_GID
Default: 100

Links

Template Support Docker Hub Project

Details

Repository

metronade/ffmpeg-easy-unraid

Registry

https://hub.docker.com/r/metronade/ffmpeg-easy-unraid

Last Updated2026-01-05

First Seen2026-05-12

Run FFmpeg-Easy-Unraid on Unraid.

FFmpeg-Easy-Unraid is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.

Explore Unraid OS