Skip to content

Unraid - Comprehensive Guide to Enabling AV1 Encoding, Plex Deployment & GPU Management with Tdarr on Unraid 7.0

License

Notifications You must be signed in to change notification settings

plexguide/Unraid_Intel-ARC_Deployment

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

96 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Guide to Intel ARC AV1 Encoding on Unraid + Tdarr Node Killer + SAB Speed Control (Bonus)

Want to help? Click the ★ (Star) button in the upper-right corner!

This guide shows you how to optimize your media library with AV1 encoding on Unraid, while also managing GPU resources between Plex and Tdarr. You’ll learn how to shrink your video files, save a ton of storage space, and automatically free up your GPU for Plex users. On top of that, we’ll show you how to use a simple script to pause Tdarr when Plex needs the GPU, then restart Tdarr when Plex is done.

This guide covers:

  • Getting your Intel ARC GPU set up on Unraid.
  • Encoding videos to AV1 for huge space savings.
  • Dynamically managing your Tdarr node so Plex always has priority.
  • Backing up and restoring configurations.
  • Troubleshooting common issues.

Whether you’re an Unraid pro or new to the platform, we’ll walk you through it step-by-step.


BONUS: Enhance your SABnzbd experience with the SAB Speed Script. This tool dynamically adjusts your download speeds whenever someone is watching content from your Plex server, preventing bandwidth competition that could cause buffering and playback issues. By automatically slowing down your downloads during peak usage and offering a configurable “nighttime” mode for maximum speeds when your network is idle, the SAB Speed Script ensures a smoother, more efficient media streaming experience. The script can be found Here and requires Tautulli for Plex Monitoring.

image

For this script to run, you need to install - USER SCRIPTS - from the UNRAID APP STORE. Once you save the script, ensure it is setup to STARTUP AT ARRAY. Also, click RUN IN THE BACKGROUND just to get it going. NOT REQUIRED FOR TDARR AV1!

image

Table of Contents


Data Savings with AV1 Encoding

With AV1, you can drastically reduce storage usage. In tests with three Intel ARC GPUs, just encoding 10-15% of a large library saved about 37TB! For a 300TB collection, AV1 could potentially bring it down to 75-100TB.

image

In short, AV1 can save you tons of space and costs.


AV1 Drawbacks

AV1 isn’t perfect. Some devices can’t handle it natively yet, and the encoding process might be slower or more resource-intensive. For more details, check out the AV1 Drawbacks page.


Upgrading to Unraid 7.0 and Installing Required Plugins

Before setting up AV1 flows or using the Tdarr Node Killer Script, make sure you’re on Unraid 7.0 (or newer) and have the proper plugins to manage and monitor your Intel ARC GPU.

Installing Intel GPU TOP Plugin

Install Intel GPU TOP by ich777 from the Unraid Community Apps. This lets you monitor your Intel ARC GPU’s performance directly in Unraid.

Intel GPU TOP Plugin

Installing GPU Statistics Plugin

Install the GPU Statistics plugin by b3rs3rk for detailed GPU usage stats. With these two plugins, you’ll easily confirm that your GPU is being used when encoding or transcoding.

GPU Statistics Plugin

Once installed, you can see real-time GPU usage:

GPU in Use Example 1

GPU in Use Example 2


Deploying Plex with Intel ARC GPU Support

Adding the Intel ARC GPU to the Plex Docker Template

In your Plex Docker template, add the Intel ARC GPU as a device. Without this, Plex won’t know it can use your GPU.

Add Intel ARC GPU to Plex Template

Configuring Plex Settings

Enable GPU transcoding in Plex and, if needed, HDR tone mapping. If you have multiple identical GPUs, Plex lists them in order. Make sure you select the correct one.

image

Verifying GPU Transcoding

Play a file that needs transcoding. Check Plex’s dashboard and GPU stats. If the GPU is doing the work, you’ll see less CPU usage and a smooth playback experience.

Plex Transcoding with Intel ARC GPU


AV1 Tdarr Flow

Change Log:

  • v1: Original
  • v2: Remove B Frames
  • v3: Improved Quality Greatly
  • v4: Added remove image from files, this would cause about a 25% failure rate for your files to transcode. Adding this allows a 100% conversion rate for AV1.

JSON Script: This script can be found Here.

image

What is the AV1 Flow?

The AV1 Flow is a preset in Tdarr that converts your media to AV1. It’s straightforward: input → process → encode → output. This is where you get those huge file-size savings.

Importing the AV1 Flow in Tdarr

Import the provided AV1 Flow JSON into Tdarr. Then apply it to your libraries so Tdarr will start using your Intel ARC GPU for AV1 encoding (if configured).

Adding a New Flow in Tdarr

Scroll to the very bottom:

Scroll to Find the Import Option

Paste the JSON:

Copy the JSON Content

Once applied, Tdarr will begin shrinking your files to AV1 format.


Optimizing AV1 Encoding Settings

Experiment with quality (CRF) and bitrate settings until you find a good balance between file size and video quality. Also, ensure hardware acceleration is on so the GPU does most of the heavy lifting.


Tdarr Node Killer Script

Change Log

  • v1: Original Script
  • v2: Script monitors PLEX via Tautulli to simplify processes

Overview

This optional script frees up the GPU for Plex whenever Plex needs it. If Tdarr and Plex share the GPU, Tdarr might interfere with streaming performance. With this script:

  • When Plex starts transcoding: the script stops the Tdarr node, giving the GPU to Plex.
  • When Plex stops: after a short cooldown (e.g., 180 seconds), the script restarts Tdarr.

SCRIPT: The Tdarr Node Killer script can be found Here.

For this script to run, you need to install - USER SCRIPTS - from the UNRAID APP STORE. Once you save the script, ensure it is setup to STARTUP AT ARRAY. Also, click RUN IN THE BACKGROUND just to get it going.

image

Script Behavior

The script uses Tautulli’s API to detect when Plex is transcoding:

  • If Plex is transcoding: kill the Tdarr node.
  • After Plex stops, wait the cooldown period, then bring Tdarr back online.

This prevents rapid start/stop cycles if Plex users jump in and out often.

Step-by-Step Implementation for Unraid

  1. Tdarr node running, no Plex transcoding:

    Tdarr Node Running, No Plex Transcoding

  2. Script monitoring for Plex transcoding:

    image
  3. Plex user starts transcoding:

    Plex User Starts Transcoding

  4. Script detects Plex transcoding and stops Tdarr node:

    image

    Tdarr Node Stopped

  5. Tdarr node is completely stopped:

    Tdarr Node Dead

Script Behavior After Plex Transcoding Stops

The script doesn’t instantly bring Tdarr back up. It waits, say 3 minutes, to ensure Plex isn’t going to start transcoding again immediately.

  1. Countdown before restarting Tdarr node:

    Countdown Before Restarting Tdarr Node

  2. After the wait, Tdarr node is restarted:

    image

    Tdarr Node Coming Back Online

  3. Tdarr node fully online again:

    Tdarr Node Fully Online

Troubleshooting Common Issues

  • Plex not using GPU? Check your Docker template and Plex settings.
  • Tdarr not restarting? Ensure the script and Tautulli API are working correctly.
  • High CPU usage? Check if HDR tone mapping is enabled and supported. Also verify GPU drivers and plugins are up-to-date.

Experimental: Running the Script on Other Operating Systems

You can run this script on other Linux distros that support Docker and systemd. The process is basically the same: place the script, create a systemd service, and start it up.

Step-by-Step Implementation for Other OSes

  1. Save the Script: Save your Tdarr Node Killer Script as tdarr_node_killer.sh in /usr/local/bin/.

    sudo nano /usr/local/bin/tdarr_node_killer.sh
  2. Set the Proper Permissions:

    sudo chmod +x /usr/local/bin/tdarr_node_killer.sh
    sudo chown root:root /usr/local/bin/tdarr_node_killer.sh
  3. Create a Service File: Create a service file for the script:

    sudo nano /etc/systemd/system/tdarr_node_killer.service
  4. Add the Following Content:

    [Unit]
    Description=Tdarr Node Killer Script
    After=network.target
    
    [Service]
    Type=simple
    ExecStart=/bin/bash /usr/local/bin/tdarr_node_killer.sh
    Restart=on-failure
    
    [Install]
    WantedBy=multi-user.target
  5. Reload Systemd:

    sudo systemctl daemon-reload
  6. Start and Enable the Service:

    sudo systemctl start tdarr_node_killer.service
    sudo systemctl enable tdarr_node_killer.service

This ensures the script runs automatically and manages your GPU resources even if you’re not on Unraid.


Backup and Recovery Tips

Before making changes:

  • Backup Plex configs (metadata, watch history, etc.).
  • Backup Docker templates so you can quickly restore containers.
  • Backup your Unraid flash drive so you don’t lose your server setup.

Test your backups occasionally to ensure they work when you need them.


Summary

By setting up AV1 encoding with Intel ARC GPUs, you can achieve massive storage savings and still maintain great quality. Adding the optional Tdarr Node Killer Script ensures Plex always has priority access to the GPU when needed. With careful tuning and a bit of experimentation, you can streamline your server’s performance, reduce storage costs, and keep everyone happy with smooth, high-quality streams.

Found this useful? Consider clicking the star (★) button at the top!

About

Unraid - Comprehensive Guide to Enabling AV1 Encoding, Plex Deployment & GPU Management with Tdarr on Unraid 7.0

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages