title: Tdarr created: 2026-06-07 updated: 2026-06-07 type: app tags: [catalogue, arr, transcoding, video, ffmpeg, automation] confidence: high contested: false sources: [https://selfh.st/apps/?tag=*arr, https://github.com/HaveAGitGat/Tdarr]

🎬 Tdarr

Transcodage vidéo automatisé pour la suite *arr : convertit massivement les fichiers en H.264/H.265/AV1 via FFmpeg + GPU, optimise la bibliothèque Plex/Jellyfin.

📋 Informations Générales

Attribut	Valeur
Nom	Tdarr
Slug	tdarr
Description	Transcodage vidéo distribué et automatisé : transcode, remuxe, encode la bibliothèque *arr via FFmpeg + accélération GPU (NVENC, QSV, VAAPI)
Site officiel	https://tdarr.io
Repository	https://github.com/HaveAGitGat/Tdarr
Stars	4 154 ⭐
Licence	GPL-3.0
Langage principal	TypeScript (Node.js) + FFmpeg
Catégorie	*arr
Tags	[catalogue, arr, transcoding, video, ffmpeg, automation]

📝 Description

Tdarr est l'outil de transcodage vidéo de référence pour les utilisateurs avancés de la suite *arr. Son rôle : prendre une bibliothèque brute (fichiers volumineux, codecs obsolètes, mauvaise qualité, mal réencodés) et la transformer en une bibliothèque optimisée pour le streaming (Plex, Jellyfin, Emby) en utilisant FFmpeg avec accélération GPU (NVENC NVIDIA, QSV Intel, VAAPI AMD).

L'architecture est distribuée : un serveur (Tdarr Server) gère la planification et l'UI, un ou plusieurs nœuds (Tdarr Node) exécutent les jobs FFmpeg. On peut ainsi répartir le transcodage sur plusieurs machines (un serveur puissant + des workers modestes, ou un cluster avec GPU).

La logique de transcodage est définie par des plugins (Tdarr Plugins) : community plugins (Tdarr_Plugin_00tdarrcore_main) et plugins custom. Chaque plugin applique une flow (chaîne d'actions) : scan → analyze → decide → transcode. Les cas typiques : réencoder en H.265 pour gagner 50% d'espace, normaliser l'audio (5.1 AC3 → EAC3 Atmos), supprimer les pistes inutiles, ou transrater à 1080p pour économiser du CPU à la lecture.

Tdarr s'intègre nativement avec Sonarr/Radarr : un plugin peut déclencher un re-scan après transcodage pour mettre à jour la bibliothèque.

🚀 Installation

Via Docker (recommandé)

# docker-compose.yml
services:
  tdarr_server:
    image: ghcr.io/haveagitgat/tdarr_server:latest
    container_name: tdarr_server
    restart: unless-stopped
    ports:
      - "8265:8265"   # UI web
      - "8266:8266"   # API
    volumes:
      - ./server:/app/server
      - ./configs:/app/configs
      - /data/movies:/movies
      - /data/tv:/tv
    environment:
      - TZ=Europe/Paris

  tdarr_node:
    image: ghcr.io/haveagitgat/tdarr_node:latest
    container_name: tdarr_node
    restart: unless-stopped
    depends_on:
      - tdarr_server
    volumes:
      - /data/movies:/movies
      - /data/tv:/tv
    environment:
      - TZ=Europe/Paris
      - nodeID=MainNode
    devices:
      - /dev/dri:/dev/dri  # pour VAAPI
    deploy:
      resources:
        reservations:
          devices:
            - capabilities: [gpu]  # pour NVIDIA

Installation manuelle

Binaires Linux/macOS/Windows sur le site officiel et la page Releases.

⚙️ Configuration

Libraries : pointer vers les dossiers de /movies et /tv montés depuis la suite *arr.
Transcode cache : disque SSD rapide, idéalement 100+ Go pour éviter les IO bottleneck.
Plugins : Tdarr_Plugin_00tdarrcore_main_community (transcode H.265 générique) + plugins custom.
Hardware acceleration : NVIDIA (NVENC), Intel QSV, AMD VAAPI selon la config.
Plex/Jellyfin : activer "remove HDR/DV" selon vos besoins, attention à la compatibilité TV.
Flow scheduling : worker count, heures creuses, quotas CPU/GPU.

🔗 Alternatives

Unmanic — concurrent direct, UI plus simple, mais moins de plugins communautaires.
FileBot — renommage et conversion de conteneurs, pas de transcodage réel.
HandBrake (CLI) — transcodage manuel, pas d'automatisation.
AV1 hardware — pas encore supporté largement (à venir sur RTX 40+).

🔒 Sécurité

Pas d'auth par défaut sur l'UI Tdarr : impérativement derrière reverse proxy avec Authelia/Authentik.
GPU : le transcodage intensif peut chauffer le hardware, monitoring température recommandé.
Espace disque : le transcode cache peut doubler la taille de la bibliothèque pendant le traitement.
Backup des fichiers sources avant tout transcodage destructif (utiliser --backup dans Tdarr).
fail2ban sur l'API.

📚 Ressources

Site officiel : https://tdarr.io
Documentation : https://docs.tdarr.io
Plugins Hub : https://github.com/HaveAGitGat/Tdarr_Plugins

🔗 Pages Liées

cat-arr
app-sonarr — déclenche des re-scans après Tdarr
app-radarr
app-jellyfin
app-plex
app-traefik
app-authelia
recettes-docker-compose
securisation-home-lab

5.0 KiB Raw Blame History