Repolode
Submit
HaveAGitGat

HaveAGitGat/Tdarr

Distributed media library automation tool that transcodes and remuxes video and audio files with FFmpeg or HandBrake using conditional plugin rules.

View on GitHub
Stars
4,386
Forks
124
Open issues
49
Last commit
4 days ago

What is it?

Tdarr is a web-based system for automating transcode and remux work across a media library. A central Tdarr Server coordinates Tdarr Nodes running on Windows, macOS, Linux (including arm and arm64) or Docker, and each node picks up tasks and processes files with FFmpeg or HandBrake.

Processing is driven by plugin stacks. Each plugin pairs filters (codec, container, resolution, size, age) with actions such as transcoding, removing subtitles, standardising audio tracks or remuxing containers, so files are only changed when they need it. Common use is converting H.264 video to H.265 (HEVC) to reduce file size, or normalising files for better playback compatibility on devices.

Each library has its own settings, schedule (7-day, 24-hour scheduler), and worker limits split across transcode and health-check workers on CPU or GPU. The project also includes a folder watcher, a stall detector, load balancing across drives, a property search over file metadata, and library statistics.

Key features

  • 01Distributed server and node architecture across Windows, macOS, Linux and Docker.
  • 02Plugin stacks combining filters and actions, with JavaScript plugins you can write or modify.
  • 03Transcoding and remuxing via HandBrake or FFmpeg, with CPU and GPU workers.
  • 04Per-library schedules, worker limits and load balancing between drives.
  • 05Folder watcher, worker stall detector and property-based file search.

Use cases

  • Converting a large H.264 video library to H.265 to reduce storage use.
  • Removing unwanted subtitle, commentary or closed caption tracks from files.
  • Standardising containers and audio tracks so media plays reliably on different devices.
  • Using spare CPU or GPU capacity across several machines to process a media library in the background.

Quick start

  1. 1

    Download and set up Tdarr from the official installation guide linked in the README

Things to know

  • The license is not clearly stated in the metadata, so check the project's terms before use.
  • Tdarr runs as a server with separate node workers, so self-hosting takes some setup effort.
  • Transcoding relies on FFmpeg or HandBrake, which you must have available for the work to run.

In collections

Self-hosted apps

Topics

#transcoding#ffmpeg#handbrake#media-library#video#audio#automation#hevc#self-hosted#transcode

FAQ

What is Tdarr?
Distributed media library automation tool that transcodes and remuxes video and audio files with FFmpeg or HandBrake using conditional plugin rules. Tdarr is a web-based system for automating transcode and remux work across a media library. A central Tdarr Server coordinates Tdarr Nodes running on Windows, macOS, Linux (including arm and arm64) or Docker, and each node picks up tasks and processes files with FFmpeg or HandBrake.
Is Tdarr free to use? What license does it have?
Tdarr is open source under the Other license. Check the license terms before using it in commercial products.
Is Tdarr still maintained?
Actively maintained. The last commit to Tdarr was on Nov 3, 2026.
What can I use Tdarr for?
Converting a large H.264 video library to H.265 to reduce storage use. Removing unwanted subtitle, commentary or closed caption tracks from files. Standardising containers and audio tracks so media plays reliably on different devices. Using spare CPU or GPU capacity across several machines to process a media library in the background.
How do I install Tdarr?
Download and set up Tdarr from the official installation guide linked in the README
Where can I get Tdarr?
The source code and installation instructions are on GitHub: https://github.com/HaveAGitGat/Tdarr

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects