I maintain this and other Home Assistant add-ons in my free time: keeping up with upstream changes, HA changes, and testing on real hardware takes a lot of time (and some money). I use around 5-10 of my >110 addons so regularly I install test machines (and purchase some test services such as vpn) that I don't use myself to troubleshoot and improve the addons

If this add-on saves you time or makes your setup easier, I would be very grateful for your support!

Addon informations

Thanks to everyone having starred my repo! To star it click on the image below, then it will be on top right. Thanks!

About

Tdarr is a distributed transcoding system for automating media library transcode/remux management using FFmpeg/HandBrake. It ensures your files are exactly how you need them to be in terms of codecs, streams, and containers. Tdarr supports distributed processing, allowing you to put your spare hardware to use with Tdarr Nodes for Windows, Linux (including ARM), and macOS.

Key features:

Distributed transcoding across multiple nodes
Automated media library management
Support for FFmpeg and HandBrake
Hardware acceleration support
Web-based management interface
Plugin-based workflow system

This addon is based on the docker image from hurlenko.

Installation

The installation of this add-on is pretty straightforward and not different in comparison to installing any other Hass.io add-on.

Add my Hass.io add-ons repository to your Hass.io instance.
Install this add-on.
Click the Save button to store your configuration.
Start the add-on.
Check the logs of the add-on to see if everything went well.
Carefully configure the add-on to your preferences, see the official documentation for that.

Configuration

Web UI can be found at <your-ip>:8265 or through the sidebar using Ingress. The server port is 8266 for connecting external Tdarr nodes.

Options

Option	Type	Default	Description
`CONFIG_LOCATION`	str	`/config/addons_config/tdarr`	Path where Tdarr config is stored
`TZ`	str		Timezone (e.g., `Europe/London`)
`localdisks`	str		Local drives to mount (e.g., `sda1,sdb1,MYNAS`)
`networkdisks`	str		SMB shares to mount (e.g., `//SERVER/SHARE`)
`cifsusername`	str		SMB username for network shares
`cifspassword`	str		SMB password for network shares
`cifsdomain`	str		SMB domain for network shares

Example Configuration

CONFIG_LOCATION: "/config/addons_config/tdarr"
TZ: "Europe/London"
localdisks: "sda1,sdb1"
networkdisks: "//192.168.1.100/media,//nas.local/transcoding"
cifsusername: "mediauser"
cifspassword: "password123"
cifsdomain: "workgroup"

Setting up Distributed Transcoding

Configure the Server:
- Access the Web UI at <your-ip>:8265
- Set up your media libraries and transcoding settings
- Configure plugins and workflows as needed
Add External Nodes:
- Install Tdarr Node on additional machines
- Point them to your Home Assistant IP on port 8266
- Nodes will automatically register and appear in the Web UI
Hardware Acceleration:
- The addon includes hardware acceleration support
- Configure GPU transcoding in the Tdarr Web UI settings
- Supported acceleration: Intel QuickSync, NVIDIA NVENC, AMD VCE

Mounting Drives

This addon supports mounting both local drives and remote SMB shares:

Local drives: See Mounting Local Drives in Addons
Remote shares: See Mounting Remote Shares in Addons

Custom Scripts and Environment Variables

This addon supports custom scripts and environment variables through the addon_config mapping:

Custom scripts: See Running Custom Scripts in Addons
env_vars option: Use the add-on env_vars option to pass extra environment variables (uppercase or lowercase names). See https://github.com/alexbelgium/hassio-addons/wiki/Add-Environment-variables-to-your-Addon-2 for details.

Hardware Acceleration Notes

The addon includes device access for hardware acceleration:

Intel QuickSync: /dev/dri devices are mapped
NVIDIA: Environment variables are set for GPU detection
AMD: Hardware acceleration supported through available devices

Configure hardware acceleration in the Tdarr Web UI under Settings > FFmpeg/HandBrake settings.

Support

Official Tdarr documentation: https://docs.tdarr.io/
Create an issue on GitHub
Ask on the Home Assistant Community thread