Tdarr

https://docs.tdarr.io/
Admin
Tdarr is a conditional transcoding application for processing large media libraries with...
Tokens:19,249
Snippets:282
Trust Score:7.8
Update:1 month ago
Show doc for...
Tokens:
Raw
### HandBrake Installation Verification Output

Source: https://docs.tdarr.io/blog/how-to-install-handbrake

Example output shown after successfully installing HandBrake on Linux/Ubuntu, confirming the version and successful initialization.

```text
[18:21:41] Nvenc version 11.1  

[18:21:41] hb_init: starting libhb thread  
[18:21:41] thread 7f45593a4700 started ("libhb")  
HandBrake 1.3.3  

HandBrake has exited.
```

--------------------------------

### Install FFprobe on Linux/Ubuntu

Source: https://docs.tdarr.io/blog/how-to-install-ffprobe-and-gather-data-from-a-media-file

Installs FFprobe using the apt package manager. Verifies the installation by checking the FFprobe version.

```bash
sudo apt-get update
sudo apt-get install ffprobe
ffprobe -version
```

--------------------------------

### Run Tdarr Node Container

Source: https://docs.tdarr.io/docs/installation/docker/run-compose

Example command to start a standalone Tdarr node container with GPU support.

```bash
docker run -ti \
    -v /docker/tdarr/configs:/app/configs \
    -v /docker/tdarr/logs:/app/logs \
    -v /media:/media \
    -v /transcode_cache:/temp \
    -e "nodeName=MyExternalNode" \
    -e "serverIP=0.0.0.0" \
    -e "serverPort=8266" \
    -e "inContainer=true" \
    -e "ffmpegVersion=7" \
    -e "nodeType=mapped" \
    -e "priority=-1" \
    -e "cronPluginUpdate=" \
    -e "apiKey=" \
    -e "maxLogSizeMB=10" \
    -e "pollInterval=2000" \
    -e "startPaused=false" \
    -e "transcodegpuWorkers=1" \
    -e "transcodecpuWorkers=2" \
    -e "healthcheckgpuWorkers=1" \
    -e "healthcheckcpuWorkers=1" \
    --network bridge \
    -e "TZ=Europe/London" \
    -e PUID=1000 \
    -e PGID=1000 \
    -e "NVIDIA_DRIVER_CAPABILITIES=all" \
    -e "NVIDIA_VISIBLE_DEVICES=all" \
    --gpus=all \
    --device=/dev/dri:/dev/dri \
    --log-opt max-size=10m \
    --log-opt max-file=5 \
    ghcr.io/haveagitgat/tdarr_node  
```

--------------------------------

### Run Tdarr Server Container

Source: https://docs.tdarr.io/docs/installation/docker/run-compose

Example command to start the Tdarr server container with internal node enabled.

```bash
docker run -ti \
    -v /docker/tdarr/server:/app/server \
    -v /docker/tdarr/configs:/app/configs \
    -v /docker/tdarr/logs:/app/logs \
    -v /media:/media \
    -v /transcode_cache:/temp \
    -e "serverIP=0.0.0.0" \
    -e "serverPort=8266" \
    -e "webUIPort=8265" \
    -e "internalNode=true" \
    -e "inContainer=true" \
    -e "ffmpegVersion=7" \
    -e "nodeName=MyInternalNode" \
    -e "auth=false" \
    -e "openBrowser=true" \
    -e "maxLogSizeMB=10" \
    -e "cronPluginUpdate=" \
    --network bridge \
    -p 8265:8265 \
    -p 8266:8266 \
    -e "TZ=Europe/London" \
    -e PUID=1000 \
    -e PGID=1000 \
    -e "NVIDIA_DRIVER_CAPABILITIES=all" \
    -e "NVIDIA_VISIBLE_DEVICES=all" \
    --gpus=all \
    --device=/dev/dri:/dev/dri \
    --log-opt max-size=10m \
    --log-opt max-file=5 \
    ghcr.io/haveagitgat/tdarr  
```

--------------------------------

### File Path Translation Examples

Source: https://docs.tdarr.io/docs/installation/windows-linux-macos

Examples showing how a file path is transformed as it moves between the Server and the Node during the transcoding process.

```json
{
  "file": "/media/Sample1.mp4"
}
```

```json
{
  "file": "W:/media/Sample1.mp4"
}
```

```json
{
  "file": "W:/tcache/Sample1-TdarrCacheFile-afjlsdfl.mp4"
}
```

```json
{
  "file": "/tcache/Sample1-TdarrCacheFile-afjlsdfl.mp4"
}
```

--------------------------------

### Create a Video Sample with Specific Start Time and Duration

Source: https://docs.tdarr.io/blog/how-to-create-a-sample-of-a-video-using-ffmpeg

This command creates a video sample starting at 11 seconds and running for 43 seconds. It's useful for isolating specific parts of a video.

```bash
ffmpeg -ss 00:00:11 -i "C:\Transcode\input.mkv" -t 00:00:43 -map 0:v? -map 0:a? -map 0:s? -map 0:d? -c copy "C:\Transcode\output.mkv"
```

--------------------------------

### Install FFmpeg on Linux/Ubuntu

Source: https://docs.tdarr.io/blog/how-to-install-ffmpeg

Use apt-get to update package lists and install FFmpeg on Debian-based Linux distributions.

```bash
sudo apt-get update
sudo apt-get install ffmpeg
ffmpeg -version
```

--------------------------------

### Install Dependencies on Linux

Source: https://docs.tdarr.io/docs/installation/windows-linux-macos

Commands to install required tools like mkvtoolnix and HandBrake on Linux systems.

```bash
sudo apt-get install mkvtoolnix       (For mkvpropedit)  
sudo apt-get install libtesseract-dev (Optional - if wanting to use CCExtractor to check files for closed captions)  
sudo apt-get install handbrake-cli  
sudo apt-get install ffmpeg           (Optional - if not wanting to use the ffmpeg that Tdarr comes with)  

```

--------------------------------

### Install HandBrake on Linux/Ubuntu

Source: https://docs.tdarr.io/blog/how-to-install-handbrake

Installs HandBrake CLI and GTK on Linux/Ubuntu systems using a PPA. This is useful for users who prefer to manage software through apt.

```bash
sudo add-apt-repository ppa:stebbins/handbrake-releases
sudo apt-get update
sudo apt-get install handbrake-cli handbrake-gtk
HandBrakeCLI --version
```

--------------------------------

### Install FFmpeg (includes FFprobe) on macOS

Source: https://docs.tdarr.io/blog/how-to-install-ffprobe-and-gather-data-from-a-media-file

Installs FFmpeg, which includes FFprobe, using the Homebrew package manager. Verifies the installation by checking the FFprobe version.

```bash
brew install ffmpeg
ffprobe -version
```

--------------------------------

### Custom Queue Tags Input Examples

Source: https://docs.tdarr.io/docs/plugins/flow-plugins/index/tools/Tags-%20Requeue

Provides examples of custom queue tags, including required worker types and additional tags. Note the format and the use of user variables.

```text
requireGPU:nvenc,tag1,tag2
requireCPUorGPU,tag1,tag2
requireCPU,tag1,tag2
requireGPU,tag1,tag2,tag3
requireGPU,tag1
requireGPU,{{{args.userVariables.global.test}}}
requireCPUorGPU,tag1,tag2
```

--------------------------------

### Customized Docker Run Command

Source: https://docs.tdarr.io/docs/installation/docker/volume-mapping

An example showing how to add multiple media source mappings to the Docker run command.

```bash
docker run -ti \
    -v /home/Tdarr/server:/app/server \
    -v /home/Tdarr/configs:/app/configs \
    -v /home/Tdarr/logs:/app/logs \
    -v /media:/media \
    -v /home/Movies:/home/Tdarr/Media/Movies \
    -v /home/TVShows:/home/Tdarr/Media/TVShows \
    -v /transcode_cache:/temp \
    -e "serverIP=0.0.0.0" \
    -e "serverPort=8266" \
    -e "webUIPort=8265" \
    --network bridge \
    -p 8265:8265 \
    -p 8266:8266 \
    -e "TZ=Europe/London" \
    -e PUID=1000 \
    -e PGID=1000 \
    --log-opt max-size=10m \
    --log-opt max-file=5 \
    ghcr.io/haveagitgat/tdarr  
```

--------------------------------

### HandBrake Transcode Command Examples

Source: https://docs.tdarr.io/docs/library-setup/transcode-options/simple-audio-video

Configure transcoding using HandBrake presets and encoder flags.

```text
-e x264 -q 20 -B  
-Z "Very Fast 1080p30"  
-Z "Fast 1080p30" -e nvenc_h265  
-Z "Very Fast 1080p30" --all-subtitles --all-audio  
-Z "Very Fast 480p30"  
--preset-import-file "C:/Users/HaveAGitGat/Desktop/testpreset.json" -Z "My Preset"  
```

--------------------------------

### Install Latest NodeJS 16

Source: https://docs.tdarr.io/blog/how-to-install-nodejs

Installs the latest available version of NodeJS under the 16 major version. After installation, follow the terminal's prompt to use this version.

```bash
nvm install 16
```

--------------------------------

### Install FFmpeg on macOS using Homebrew

Source: https://docs.tdarr.io/blog/how-to-install-ffmpeg

Install FFmpeg on macOS using the Homebrew package manager and link it for use.

```bash
brew install ffmpeg
brew link ffmpeg
ffmpeg -version
```

--------------------------------

### Check NodeJS Installation

Source: https://docs.tdarr.io/blog/how-to-install-nodejs

Verifies that NodeJS has been installed and is accessible in the current terminal session by displaying the active version.

```bash
node -v
```

--------------------------------

### Create a 30-Second Video Sample

Source: https://docs.tdarr.io/blog/how-to-create-a-sample-of-a-video-using-ffmpeg

Use this command to create a video sample starting from the beginning (00:00:00) and lasting for 30 seconds. It copies the streams without re-encoding.

```bash
ffmpeg -ss 00:00:0 -i "C:\Transcode\input.mkv" -t 00:00:30 -map 0:v? -map 0:a? -map 0:s? -map 0:d? -c copy "C:\Transcode\output.mkv"
```

--------------------------------

### Install HandBrake on macOS using HomeBrew

Source: https://docs.tdarr.io/blog/how-to-install-handbrake

Installs HandBrake on macOS using the HomeBrew package manager. This command also includes a check for successful installation.

```bash
brew install handbrake
HandBrakeCLI --version
```

--------------------------------

### Install and Use NodeJS 14

Source: https://docs.tdarr.io/blog/how-to-install-nodejs

Installs NodeJS version 14 and then sets it as the active version for the current terminal session. This demonstrates switching to a different major version.

```bash
nvm install 14
nvm use 14.19.3
```

--------------------------------

### HandBrake Command with Preset Import

Source: https://docs.tdarr.io/docs/library-setup/transcode-options/handbrake-presets

Example of a HandBrake command that imports a custom preset file. Ensure the preset file path is accessible on the server.

```bash
--preset-import-file "Y:/media/testpreset.json" -Z "My Preset"  

```

--------------------------------

### FFmpeg Transcode Command Examples

Source: https://docs.tdarr.io/docs/library-setup/transcode-options/simple-audio-video

Use the <io> tag to separate input and output parameters when configuring FFmpeg transcode rules.

```text
-r 1<io>-r 24  
<io>-sn -c:v copy -c:a copy  
<io>-c:v libx265 -crf 23 -ac 6 -c:a aac -preset veryfast  
<io>-map 0 -c copy -c:v libx265 -c:a aac  
-c:v h264_cuvid<io>-c:v hevc_nvenc -preset slow -c:a copy  
```

--------------------------------

### Example FFmpeg Encoder Output

Source: https://docs.tdarr.io/blog/how-to-install-ffmpeg

Sample output from the 'ffmpeg -encoders' command, showing available video encoders and their capabilities.

```text
V..... libx265              libx265 H.265 / HEVC (codec hevc)
V..... nvenc_hevc           NVIDIA NVENC hevc encoder (codec hevc)
V..... hevc_nvenc           NVIDIA NVENC hevc encoder (codec hevc)
```

--------------------------------

### Verify Tdarr Binary and Scanner Tests

Source: https://docs.tdarr.io/docs/installation/windows-linux-macos

Example output logs confirming that required binaries and scanners are correctly detected and functional.

```text
[INFO] Tdarr_Server - Binary test 1: handbrakePath working  
[INFO] Tdarr_Server - Binary test 2: ffmpegPath working  
[INFO] Tdarr_Server - Binary test 3: mkvpropeditPath working  
  
[INFO] Tdarr_Server - Scanner test 1: FFprobe working  
[INFO] Tdarr_Server - Scanner test 2: Exiftool working  
[INFO] Tdarr_Server - Scanner test 3: Mediainfo working  
[INFO] Tdarr_Server - Scanner test 4: CCExtractor working  
[INFO] Tdarr_Node - Binary test 1: handbrakePath working  
[INFO] Tdarr_Node - Binary test 2: ffmpegPath working  
[INFO] Tdarr_Node - Binary test 3: mkvpropeditPath working  

```

--------------------------------

### Example Development Tag Format

Source: https://docs.tdarr.io/docs/releases/changing-version

The format used for development tags in the WebUI updater.

```text
dev_2.82.01_2026_06_27T13_01_36z  

```

--------------------------------

### Start Tdarr Services

Source: https://docs.tdarr.io/docs/installation/windows-linux-macos

Commands to launch the Tdarr Server and Node executables from a terminal.

```bash
/Tdarr_Server/Tdarr_Server
/Tdarr_Node/Tdarr_Node
```

--------------------------------

### Set Flow Variable - Variable Input Example

Source: https://docs.tdarr.io/docs/plugins/flow-plugins/index/tools/Set%20Flow%20Variable

Example of how to set the 'Variable' input for the Set Flow Variable plugin. This variable can be referenced later using the 'Check Flow Variable' plugin.

```text
transcodeStage
```

--------------------------------

### Run Tdarr with authentication and seeded API key in Docker

Source: https://docs.tdarr.io/docs/other/authentication

Example command for deploying Tdarr via Docker with authentication enabled and a pre-seeded API key.

```bash
docker run -ti \
    -e "auth=true" \
    -e "seededApiKey=tapi_my_secure_api_key_123" \
    ghcr.io/haveagitgat/tdarr  
```

--------------------------------

### Audio Stream Channel Count Example

Source: https://docs.tdarr.io/blog/how-to-remove-audio-channels-based-on-channel-count-using-ffmpeg

This JSON snippet shows an example of audio stream data, indicating the channel count. 7.1 surround sound is represented as 8 channels, and 5.1 as 6 channels.

```json
{
     "channels": 8
 }
```

--------------------------------

### Use Specific NodeJS Version

Source: https://docs.tdarr.io/blog/how-to-install-nodejs

Activates a previously installed NodeJS version for the current terminal session. Ensure the version number matches an installed version.

```bash
nvm use 16.15.0
```

--------------------------------

### Execute Tdarr Server and Node Binaries

Source: https://docs.tdarr.io/docs/installation/windows-linux-macos

Run the server and node executables from separate terminal windows to start the application.

```bash
./Tdarr_Server/Tdarr_Server  
./Tdarr_Node/Tdarr_Node  

```

--------------------------------

### Set Flow Variable - Value Input Examples

Source: https://docs.tdarr.io/docs/plugins/flow-plugins/index/tools/Set%20Flow%20Variable

Examples of values that can be assigned to a flow variable using the Set Flow Variable plugin. These values can be strings or numbers.

```text
1
```

```text
nvenc
```

--------------------------------

### Configure Node Directory Paths

Source: https://docs.tdarr.io/docs/releases/auto-updates

Example of directory structures for running multiple Tdarr Nodes on a single machine to prevent file conflicts during auto-updates.

```text
C:/Users/Bob/Documents/Tdarr1/Tdarr_Node/Tdarr_Node.exe  
C:/Users/Bob/Documents/Tdarr2/Tdarr_Node/Tdarr_Node.exe  
```

--------------------------------

### Path Translator Configuration for Linux Node

Source: https://docs.tdarr.io/docs/library-setup/transcode-options/handbrake-presets

Example of a path translator configuration to map server paths to Node paths. This is crucial for cross-device compatibility.

```json
    {
      "server": "Y:/media/",
      "node": "/share/media"
    }


```

--------------------------------

### Check Available FFmpeg Encoders

Source: https://docs.tdarr.io/blog/how-to-install-ffmpeg

Command to list all available encoders in your FFmpeg installation, useful for verifying hardware support.

```bash
ffmpeg -encoders
```

--------------------------------

### Set seeded API key environment variable

Source: https://docs.tdarr.io/docs/other/authentication

Use this environment variable to automatically create an API key upon server startup. The key must start with 'tapi_' and be at least 14 characters long.

```bash
export seededApiKey=tapi_my_secure_api_key_123  
```

--------------------------------

### Verify FFmpeg NVENC Transcoding

Source: https://docs.tdarr.io/docs/installation/docker/hardware-transcoding

Uses the NVIDIA container toolkit to run a test transcode with NVENC. Ensure the NVIDIA container toolkit is installed on the host.

```bash
docker run \
    -e "NVIDIA_DRIVER_CAPABILITIES=all" \
    -e "NVIDIA_VISIBLE_DEVICES=all" \
    --gpus=all \
    ghcr.io/haveagitgat/tdarr_node:latest \
    /bin/bash -e \
    -c 'curl \
            -o /tmp/sample.mkv \
            -l https://samples.tdarr.io/api/v1/samples/sample__1080__libx264__aac__30s__video.mkv; \
        ffmpeg \
            -i /tmp/sample.mkv \
            -c:v:0 hevc_nvenc \
            /tmp/sample-out.mkv'
```

--------------------------------

### Verify FFmpeg QSV Transcoding

Source: https://docs.tdarr.io/docs/installation/docker/hardware-transcoding

Tests Intel Quick Sync Video (QSV) hardware acceleration using a generated color source.

```bash
docker run \
    --device=/dev/dri:/dev/dri \
    ghcr.io/haveagitgat/tdarr_node:latest \
    /bin/bash -e \
    -c 'ffmpeg \
            -hwaccel qsv -f lavfi -i color=c=black:s=256x256:d=1:r=30 \
            -c:v:0 hevc_qsv \
            -f null /dev/null'
```

--------------------------------

### Configure Path with Forward Slashes

Source: https://docs.tdarr.io/docs/installation/windows-linux-macos

Alternative method for specifying Windows paths using forward slashes.

```json
{
  "ffmpegPath": "C:/ffmpeg/ffmpeg.exe"
}
```

--------------------------------

### Remove Second Stream by Index

Source: https://docs.tdarr.io/blog/how-to-remove-media-file-streams-using-ffmpeg

Use this command to remove the second stream (index 1) from a media file. Ensure FFmpeg is installed and accessible.

```bash
ffmpeg -i "C:\Transcode\input.mkv" -map 0 -map -0:1 -c copy "C:\Transcode\output.mkv"
```

--------------------------------

### Configuration Files

Source: https://docs.tdarr.io/docs/installation/docker/run-compose

The configuration files found in the mapped configs directory.

```text
Tdarr_Node_Config.json  
Tdarr_Server_Config.json  
```

--------------------------------

### Docker Pre-release Image Tags

Source: https://docs.tdarr.io/docs/releases/changing-version

Image references for Tdarr pre-release builds using the acceptance repository.

```text
ghcr.io/haveagitgat/tdarr_acc:dev  
ghcr.io/haveagitgat/tdarr_node_acc:dev  
ghcr.io/haveagitgat/tdarr_acc:{version}  
ghcr.io/haveagitgat/tdarr_node_acc:{version}  

```

--------------------------------

### Tdarr Plugin for Data Stream Removal

Source: https://docs.tdarr.io/blog/how-to-remove-data-streams-using-ffmpeg

This Tdarr plugin can automate the process of removing data streams from your media files. Ensure you have Tdarr installed and configured with the appropriate plugins.

```bash
Tdarr_Plugin_vdka_Remove_DataStreams
```

--------------------------------

### Pre-release Docker Image References

Source: https://docs.tdarr.io/docs/releases/changing-version

Available image tags for pre-release Tdarr Server and Node deployments on ghcr.io and docker.io.

```text
ghcr.io/haveagitgat/tdarr_acc:dev  
ghcr.io/haveagitgat/tdarr_acc:latest  
ghcr.io/haveagitgat/tdarr_acc:{version}  
ghcr.io/haveagitgat/tdarr_node_acc:dev  
ghcr.io/haveagitgat/tdarr_node_acc:latest  
ghcr.io/haveagitgat/tdarr_node_acc:{version}  
docker.io/haveagitgat/tdarr_acc:dev  
docker.io/haveagitgat/tdarr_acc:latest  
docker.io/haveagitgat/tdarr_acc:{version}  
docker.io/haveagitgat/tdarr_node_acc:dev  
docker.io/haveagitgat/tdarr_node_acc:latest  
docker.io/haveagitgat/tdarr_node_acc:{version}  

```

--------------------------------

### Chowned Directories

Source: https://docs.tdarr.io/docs/installation/docker/run-compose

Directories that are chowned on container start-up.

```text
/home/Tdarr  
/temp  
/logs  
/app  
```

--------------------------------

### Remove Title Metadata with FFmpeg CLI

Source: https://docs.tdarr.io/blog/how-to-clean-remove-video-title-data-using-ffmpeg

Use this FFmpeg command to remove the title metadata from a video file. Ensure FFmpeg is installed and accessible in your system's PATH.

```bash
ffmpeg -i "C:\Transcode\input.mkv" -metadata title= -map 0 -c copy "C:\Transcode\output.mkv"
```

--------------------------------

### Verify HandBrake NVENC Transcoding

Source: https://docs.tdarr.io/docs/installation/docker/hardware-transcoding

Tests NVENC hardware acceleration using the HandBrakeCLI tool within the container.

```bash
docker run \
    -e "NVIDIA_DRIVER_CAPABILITIES=all" \
    -e "NVIDIA_VISIBLE_DEVICES=all" \
    --gpus=all \
    ghcr.io/haveagitgat/tdarr_node:latest \
    /bin/bash -e \
    -c 'curl \
            -o /tmp/sample.mkv \
            -l https://samples.tdarr.io/api/v1/samples/sample__1080__libx264__aac__30s__video.mkv; \
        HandBrakeCLI \
            -i "/tmp/sample.mkv" \
            -o "/tmp/sample-out.mkv" \
            -e nvenc_h265'
```

--------------------------------

### Remove Data Streams with FFmpeg CLI

Source: https://docs.tdarr.io/blog/how-to-remove-data-streams-using-ffmpeg

Use this command to remove data streams from a media file. The -dn flag automatically detects and removes data streams. Ensure FFmpeg is installed and accessible in your system's PATH.

```bash
ffmpeg -i "C:\\Transcode\\input.mkv" -map 0 -c copy -dn "C:\\Transcode\\output.mkv"
```

--------------------------------

### Verify FFmpeg VAAPI Transcoding

Source: https://docs.tdarr.io/docs/installation/docker/hardware-transcoding

Maps the host DRI device to the container to enable VAAPI hardware acceleration.

```bash
docker run \
    --device=/dev/dri:/dev/dri \
    ghcr.io/haveagitgat/tdarr_node:latest \
    /bin/bash -e \
    -c 'curl \
            -o /tmp/sample.mkv \
            -l https://samples.tdarr.io/api/v1/samples/sample__1080__libx264__aac__30s__video.mkv; \
        ffmpeg \
            -hwaccel vaapi -hwaccel_device /dev/dri/renderD128 \
            -hwaccel_output_format vaapi \
            -i /tmp/sample.mkv \
            -c:v:0 hevc_vaapi \
            /tmp/sample-out.mkv'
```

--------------------------------

### Stable Docker Image References

Source: https://docs.tdarr.io/docs/releases/changing-version

Available image tags for stable Tdarr Server and Node deployments on ghcr.io and docker.io.

```text
ghcr.io/haveagitgat/tdarr:latest  
ghcr.io/haveagitgat/tdarr:{version}  
ghcr.io/haveagitgat/tdarr_node:latest  
ghcr.io/haveagitgat/tdarr_node:{version}  
docker.io/haveagitgat/tdarr:latest  
docker.io/haveagitgat/tdarr:{version}  
docker.io/haveagitgat/tdarr_node:latest  
docker.io/haveagitgat/tdarr_node:{version}  

```

--------------------------------

### Configure Unmapped Node Environment Variables

Source: https://docs.tdarr.io/docs/nodes/nodes

Set these environment variables to enable unmapped node functionality. Ensure the cache directory is dedicated to Tdarr to prevent data loss.

```text
nodeType=unmapped  
unmappedNodeCache=/cache  
```

--------------------------------

### Thorough Health Check Command (VAAPI Hardware)

Source: https://docs.tdarr.io/docs/library-setup/healthcheck

Goes through each frame of the file with FFmpeg. Uses VAAPI hardware acceleration for VAAPI nodes.

```bash
-stats -v error -hwaccel vaapi -hwaccel_output_format vaapi  

```

--------------------------------

### Thorough Health Check Command (Any Hardware)

Source: https://docs.tdarr.io/docs/library-setup/healthcheck

Goes through each frame of the file with FFmpeg. Uses NVDEC hardware acceleration for any node hardware type.

```bash
-stats -v error -hwaccel nvdec -hwaccel_output_format cuda  

```

--------------------------------

### Re-order Streams by Type using FFmpeg

Source: https://docs.tdarr.io/blog/how-to-re-order-streams-using-ffmpeg

Specify streams by type (e.g., audio 'a', video 'v') and index within that type to re-order them. This offers more precise control than using overall stream indices.

```bash
ffmpeg -i "C:\Transcode\input.mkv" -map 0:a:0 -map 0:v:0 -map 0:a:1 -c copy "C:\Transcode\output.mkv"
```

--------------------------------

### Gather Media File Information with FFprobe

Source: https://docs.tdarr.io/blog/how-to-install-ffprobe-and-gather-data-from-a-media-file

Use this FFprobe command to extract detailed information about a media file, such as video and audio streams, codecs, resolution, and duration. The output is formatted as JSON for easy parsing.

```bash
ffprobe -v quiet -print_format json -show_format -show_streams "C:\\Transcode\\input.mkv"
```

--------------------------------

### Default Docker Run Command

Source: https://docs.tdarr.io/docs/installation/docker/volume-mapping

The standard command to launch the Tdarr container with default volume mappings and environment variables.

```bash
docker run -ti \
    -v /docker/tdarr/server:/app/server \
    -v /docker/tdarr/configs:/app/configs \
    -v /docker/tdarr/logs:/app/logs \
    -v /media:/media \
    -v /transcode_cache:/temp \
    -e "serverIP=0.0.0.0" \
    -e "serverPort=8266" \
    -e "webUIPort=8265" \
    --network bridge \
    -p 8265:8265 \
    -p 8266:8266 \
    -e "TZ=Europe/London" \
    -e PUID=1000 \
    -e PGID=1000 \
    --log-opt max-size=10m \
    --log-opt max-file=5 \
    ghcr.io/haveagitgat/tdarr  
```

--------------------------------

### Sample ffprobe JSON Output

Source: https://docs.tdarr.io/blog/how-to-install-ffprobe-and-gather-data-from-a-media-file

This JSON output is generated by ffprobe and contains detailed information about a media file, including stream details, format, and metadata tags.

```json
{
    "streams": [
        {
            "index": 0,
            "codec_name": "h264",
            "codec_long_name": "H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10",
            "profile": "High",
            "codec_type": "video",
            "codec_time_base": "1/50",
            "codec_tag_string": "avc1",
            "codec_tag": "0x31637661",
            "width": 1920,
            "height": 1080,
            "coded_width": 1920,
            "coded_height": 1088,
            "closed_captions": 0,
            "has_b_frames": 2,
            "pix_fmt": "yuv420p",
            "level": 40,
            "color_range": "tv",
            "color_space": "bt709",
            "color_transfer": "bt709",
            "color_primaries": "bt709",
            "chroma_location": "left",
            "field_order": "progressive",
            "refs": 1,
            "is_avc": "true",
            "nal_length_size": "4",
            "r_frame_rate": "25/1",
            "avg_frame_rate": "25/1",
            "time_base": "1/12800",
            "start_pts": 0,
            "start_time": "0.000000",
            "duration_ts": 38400,
            "duration": "0.030000",
            "bit_rate": "1000000",
            "bits_per_raw_frame": "8",
            "nb_frames": "1",
            "extradata_size": 36,
            "tags": {
                "ENCODER": "Lavc57.107.100 libx264",
                "DURATION": "00:00:00.040000000"
            }
        },
        {
            "index": 1,
            "codec_name": "aac",
            "codec_long_name": "AAC (Advanced Audio Coding)",
            "codec_type": "audio",
            "codec_time_base": "1/48000",
            "codec_tag_string": "0x41303041",
            "codec_tag": "0x41303041",
            "sample_fmt": "fltp",
            "sample_rate": "48000",
            "channels": 2,
            "channel_layout": "stereo",
            "bits_per_sample": 0,
            "initial_padding": 0,
            "real_flush_buffer": 0,
            "duration_ts": 1440000,
            "duration": "30.000000",
            "bit_rate": "128000",
            "bits_per_channel": 0,
            "nb_frames": "1440000",
            "extradata_size": 7,
            "tags": {
                "HANDLER_NAME": "GPAC ISO Audio Handler",
                "ENCODER": "Lavc57.107.100 aac",
                "DURATION": "00:00:30.021000000"
            }
        }
    ],
    "format": {
        "filename": "C:\\Transcode\\input.mkv",
        "nb_streams": 3,
        "nb_programs": 0,
        "format_name": "matroska,webm",
        "format_long_name": "Matroska / WebM",
        "start_time": "0.000000",
        "duration": "30.021000",
        "size": "2601666",
        "bit_rate": "693292",
        "probe_score": 100,
        "tags": {
            "title": "Big Buck Bunny, Sunflower version",
            "GENRE": "Animation",
            "MAJOR_BRAND": "isom",
            "MINOR_VERSION": "1",
            "COMPATIBLE_BRANDS": "isomavc1",
            "COMPOSER": "Sacha Goedegebure",
            "ARTIST": "Blender Foundation 2008, Janus Bager Kristensen 2013",
            "COMMENT": "Creative Commons Attribution 3.0 - http://bbb3d.renderfarming.net",
            "ENCODER": "Lavf57.83.100"
        }
    }
}

```

--------------------------------

### Quick Health Check Command

Source: https://docs.tdarr.io/docs/library-setup/healthcheck

Uses HandBrake to check file headers. Available for CPU workers only.

```bash
--scan  

```

--------------------------------

### Normalize Audio Plugin Inputs

Source: https://docs.tdarr.io/docs/plugins/flow-plugins/index/audio/Normalize%20Audio

Defines the input parameters for the Normalize Audio plugin: 'i' for loudnorm pass, 'lra' for desired loudness range, and 'tp' for desired true peak. Default values are provided for each.

```text
Name: i   
  
Type: string   
  
Tooltip:   
  
"i" value used in loudnorm pass 
  
              defaults to -23.0  
```

```text
Name: lra   
  
Type: string   
  
Tooltip:   
  
Desired lra value. 
 Defaults to 7.0    
              


```

```text
Name: tp   
  
Type: string   
  
Tooltip:   
  
Desired "tp" value. 
 Defaults to -2.0   
                


```

--------------------------------

### Basic Queue Tags Input

Source: https://docs.tdarr.io/docs/plugins/flow-plugins/index/tools/Tags-%20Requeue

Specifies whether to use basic or custom queue tags for requeuing files.

```json
{
  "name": "Use Basic Queue Tags",
  "type": "boolean",
  "tooltip": "Use basic queue tags or custom tags."
}
```

--------------------------------

### Server File Volume Mapping

Source: https://docs.tdarr.io/docs/installation/docker/volume-mapping

Specific volume mapping configuration for Tdarr server files like plugins and backups.

```bash
-v /home/h/Desktop/server:/app/server \  
```

```bash
-v /home/h/Documents/Tdarr:/app/server \  
```

--------------------------------

### Check Video Resolution Output Codes

Source: https://docs.tdarr.io/docs/plugins/flow-plugins/index/video/Check%20Video%20Resolution

This snippet lists the numerical output codes for the Check Video Resolution plugin, indicating the detected video resolution.

```text
1: File is 480p
2: File is 576p
3: File is 720p
4: File is 1080p
5: File is 1440p
6: File is 4KUHD
7: File is DCI4K
8: File is 8KUHD
9: File is Other
```

--------------------------------

### Configure Path with Escaped Backslashes

Source: https://docs.tdarr.io/docs/installation/windows-linux-macos

Use double backslashes when specifying Windows paths in JSON to prevent corruption.

```json
{
  "ffmpegPath": "C:\\ffmpeg\\ffmpeg.exe"
}
```

--------------------------------

### Common FFmpeg Hardware Transcoding Encoders

Source: https://docs.tdarr.io/blog/how-to-install-ffmpeg

Lists common hardware encoders for Nvidia, AMD, and Intel GPUs used with FFmpeg for accelerated transcoding.

```bash
# For Nvidia GPUs
nvenc_h264
nvenc_h265

# For AMD GPUs
h264_amf
hevc_amf

# For Intel iGPUs (6000 series onwards)
hevc_vaapi
hevc_qsv
```

--------------------------------

### Path Translator Configuration

Source: https://docs.tdarr.io/docs/installation/windows-linux-macos

Defines the mapping between server-side paths and node-side paths to ensure files are accessible across different operating systems.

```json
{
  "pathTranslators": [
    {
      "server": "/media",
      "node": "W:/media"
    },
    {
      "server": "/tcache",
      "node": "W:/tcache"
    }
  ]
}
```

```json
{
  "pathTranslators": [
    {
      "server": "/home/Tdarr/Media/",
      "node": "\\\\10.0.0.200/mnt/storage/media"
    },
    {
      "server": "/transcode",
      "node": "\\\\10.0.0.200/mnt/storage/.transcode"
    }
  ]
}
```

```json
{
  "pathTranslators": [
    {
      "server": "/home/user/shared_folder/",
      "node": "\\\\fileserver/shared_folder"
    }
  ]
}
```

```json
{
  "pathTranslators": [
    {
      "server": "/mnt/data",
      "node": "/Volumes/Data"
    }
  ]
}
```

```json
{
  "pathTranslators": [
    {
      "server": "D:/files",
      "node": "/mnt/server-files"
    }
  ]
}
```

```json
{
  "pathTranslators": [
    {
      "server": "F:/media",
      "node": "/Volumes/Media"
    }
  ]
}
```

--------------------------------

### Basic Queue Tags Input Field

Source: https://docs.tdarr.io/docs/plugins/flow-plugins/index/tools/Tags-%20Requeue

Defines the input field for specifying basic tags to requeue a file with.

```json
{
  "name": "Basic Queue Tags",
  "type": "string",
  "tooltip": "Specify tags to requeue file with."
}
```

--------------------------------

### Tdarr Server Configuration File

Source: https://docs.tdarr.io/docs/installation/windows-linux-macos

Default structure for the Tdarr_Server_Config.json file used to define ports and binary paths.

```json
{
  "serverPort": "8266",
  "webUIPort": "8265",
  "serverIP": "0.0.0.0",
  "serverBindIP": false,
  "handbrakePath": "",
  "ffmpegPath": "",
  "mkvpropeditPath": "",
  "ccextractorPath": "",
  "openBrowser": true,
  "cronPluginUpdate": "",
  "auth": false,
  "authSecretKey": "",
  "maxLogSizeMB": 10
}
```

--------------------------------

### Map Configuration Volume

Source: https://docs.tdarr.io/docs/installation/docker/run-compose

Volume mapping for the configuration directory to enable path translators.

```bash
-v /tdarr_configs:/app/configs \  
```

--------------------------------

### Tdarr Folder Structure

Source: https://docs.tdarr.io/docs/installation/getting-started

This is the typical folder structure for Tdarr applications, regardless of the operating system or Docker usage. It shows the location of configuration files, logs, and the main application executables.

```bash
.  
├──configs  
    ├──Tdarr_Node_Config.json  
    ├──Tdarr_Server_Config.json  
    ├──Tdarr_Updater_Config.json  
├──logs  
├──server  
    ├──Tdarr  
├──Tdarr_Node  
    ├──Tdarr_Node.exe  
├──Tdarr_Server  
    ├──Tdarr_Server.exe  
├──Tdarr_Updater.exe  

```

--------------------------------

### Normalize Audio Plugin Outputs

Source: https://docs.tdarr.io/docs/plugins/flow-plugins/index/audio/Normalize%20Audio

Specifies the output of the Normalize Audio plugin, which is a signal to continue processing with the next plugin.

```text
1: Continue to next plugin  


```

--------------------------------

### Re-order Streams by Index using FFmpeg

Source: https://docs.tdarr.io/blog/how-to-re-order-streams-using-ffmpeg

Use the `-map` option with stream indices to re-order streams. The order of the `-map` arguments determines the stream order in the output file.

```bash
ffmpeg -i "C:\Transcode\input.mkv" -map 0:1 -map 0:0 -map 0:3 -c copy "C:\Transcode\output.mkv"
```

--------------------------------

### Docker Image Tags for Tdarr

Source: https://docs.tdarr.io/docs/releases/changing-version

Use these image tags in your container configuration to specify the desired Tdarr version.

```text
ghcr.io/haveagitgat/tdarr:latest  
ghcr.io/haveagitgat/tdarr_node:latest  
ghcr.io/haveagitgat/tdarr:{version}  
ghcr.io/haveagitgat/tdarr_node:{version}  
```
Tokens:
Raw