# HaveAGitGat/Tdarr

Tdarr - Distributed transcode automation using FFmpeg/HandBrake + Audio/Video library analytics + video health checking (Windows, macOS, Linux & Docker)

Repository: https://github.com/HaveAGitGat/Tdarr
Canonical: https://ross.abutalabs.com/products/tdarr
Language: Makefile
License: NOASSERTION
License Family: other
Topics: transcode, automation, video, audio, ffmpeg, handbrake
Last push: 2026-08-05T07:37:45+00:00

## Health v2 (maintenance only)
Score: 66/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 96, release rhythm 8, longevity 100
- inputs: {"age_days": 2546, "days_push": 28, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 4284, forks 120 (observed 2026-08-28T04:08:41.262064+00:00)

## What it is
Tdarr is a distributed, web-based transcode automation application for audio/video libraries, using FFmpeg and HandBrake with CPU/GPU workers. It consists of a central server and cross-platform nodes that process files according to conditional rules, with library analytics, health checking, scheduling, and plugin support.

## Use cases
- convert my media library from h264 to h265 to save disk space
- automate transcoding of new files added by sonarr and radarr
- check video files for corruption across a large library
- run transcode workers on multiple machines in parallel
- enforce codec, container, and language rules across a media collection
- use spare GPU hardware for hardware-accelerated video encoding
- monitor a folder and automatically process new media files

## When to choose
- you need automated, rule-based transcoding or remuxing of a large media library
- you want to distribute encoding work across multiple devices with CPU/GPU workers
- you want library analytics, health checking, and scheduling in one self-hosted web app
- you use Sonarr/Radarr and want a companion media processing tool

## When to avoid
- you only need a one-off batch conversion of a few files - use FFmpeg or HandBrake directly
- you need a simple desktop GUI without a server/node setup - consider HBBatchBeast
- you want to transcode non-audio/video file types

## Facets
- artifact type: application
- maturity: active
- function: video-processing, audio-processing, workflow-automation, scheduling, plugin-system
- domain: media, self-hosted, developer-tools
- platform: windows, self-hosted
- tags: transcoding, ffmpeg, handbrake, media-library, distributed, h265, health-check, sonarr-radarr, video, automation, macos, linux, docker, web-server

## Member repositories
- HaveAGitGat/Tdarr (main) score 66

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:08:41.262064+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:21:57.087867+00:00, confidence not recorded.
  - readme: https://github.com/HaveAGitGat/Tdarr (fetched 2026-08-28T04:08:41.262064+00:00, sha ca4481eacb43)
- Data as of 2026-08-30T08:39:29.467469+00:00.