---
title: Youtarr
created: 2026-06-07
updated: 2026-06-07
type: app
tags: [catalogue, arr, youtube, telechargement, media]
confidence: high
contested: false
sources: [https://selfh.st/apps/?tag=*arr, https://github.com/DialmasterOrg/Youtarr]
---

# 🎬 Youtarr

> Téléchargeur de vidéos et de chaînes YouTube qui s'intègre nativement à Sonarr et Radarr : récupère automatiquement le contenu de vos abonnements, génère les métadonnées NFO et place les fichiers dans la bibliothèque *arr.

## 📋 Informations Générales

| Attribut | Valeur |
|----------|--------|
| **Nom** | Youtarr |
| **Slug** | youtarr |
| **Description** | Téléchargeur YouTube avec intégration Sonarr/Radarr, génération de métadonnées et NFO |
| **Site officiel** | https://youtarr.com |
| **Repository** | https://github.com/DialmasterOrg/Youtarr |
| **Stars** | 1 158 ⭐ |
| **Licence** | MIT |
| **Langage principal** | Node.js |
| **Catégorie** | *arr (téléchargement) |
| **Tags** | [catalogue, arr, youtube, telechargement, media] |

## 📝 Description

**Youtarr** fait le pont entre YouTube et l'écosystème *arr. L'idée : beaucoup de contenus (émissions, podcasts vidéo, documentaires, musique, tutoriels) sont **exclusifs** à YouTube et n'apparaissent jamais dans TMDB/TVDB. Youtarr permet de les rapatrier localement et de les gérer comme n'importe quel média *arr.

Fonctionnalités principales :
- **Surveillance de chaînes** : ajoute une ou plusieurs chaînes YouTube, Youtarr télécharge les nouvelles vidéos automatiquement.
- **Playlists supportées** : playlists publiques ou privées, sync périodique.
- **Filtres** : mots-clés, durée min/max, résolution, type (shorts exclus par défaut).
- **Métadonnées NFO** : génère des fichiers NFO compatibles Kodi/Jellyfin/Plex/Emby, avec jaquette, description, date, chaîne source.
- **Intégration Sonarr/Radarr** : déclenche l'indexeur et le renommage via des webhooks, range dans `/data/youtube/Series` ou `/Movies`.
- **Chapitres** : récupération automatique des chapitres YouTube dans le fichier final.
- **SponsorBlock** : option pour découper les segments sponsorisés/intros/outros.

Sous le capot : `yt-dlp` pour le téléchargement, `ffmpeg` pour le muxing, base SQLite pour l'état.

## 🚀 Installation
### Via Docker (recommandé)
```yaml
# docker-compose.yml
services:
  youtarr:
    image: ghcr.io/dialmasterorg/youtarr:latest
    container_name: youtarr
    restart: unless-stopped
    environment:
      - TZ=Europe/Paris
      - SONARR_URL=http://sonarr:8989
      - SONARR_API_KEY=xxxxxxxxxxxxxxxx
      - DOWNLOAD_PATH=/data/youtube
    volumes:
      - ./config:/app/config
      - /mnt/media/youtube:/data/youtube
    ports:
      - "3087:3087"
```
### Installation manuelle
Node.js 20+, `yt-dlp` dans le PATH, `ffmpeg` installé. `git clone`, `npm ci`, `npm run build`, `npm start`. Difficile à maintenir, préférer Docker.

## ⚙️ Configuration
- **Cookies YouTube** : fortement recommandé d'exporter les cookies de votre compte (extension `Get cookies.txt`) et de les monter dans `/config/cookies.txt` pour éviter les blocages anti-bot.
- **Quotas** : limiter le nombre de téléchargements simultanés et la bande passante horaire.
- **Format** : préférence `bestvideo+bestaudio` (1080p max) ou 4K selon stockage.
- **Chapitres SponsorBlock** : marquer "remove sponsor", "remove intro", "remove outro".
- **Reverse proxy** : `youtarr.example.com` avec HTTPS via Traefik.

## 🔗 Alternatives
- **TubeSync** — équivalent mature, plus orienté Podcast/Music que *arr.
- **yt-dlp en cron** — DIY, sans UI ni intégration *arr.
- **Jellyfin + plugin YouTube** — stream sans téléchargement, mais dépend de YouTube.
- **Piped/Po** — frontends alternatifs, pas de téléchargement.
- **TubeArchivist** — archive auto-hébergée de chaînes YouTube, plus complète mais sans lien direct Sonarr/Radarr.

## 🔒 Sécurité
- **Cookies YouTube** : critique,泄露 = vol de compte Google. À monter en read-only, jamais dans le repo.
- **HTTPS obligatoire** : le contenu révèle vos abonnements et vos goûts.
- **Volumes** : `/data/youtube` peut devenir volumineux, surveiller l'espace disque.
- **Rate limiting** : YouTube bloque les IP qui téléchargent trop, configurer des pauses.
- **Légalité** : téléchargement YouTube légal pour usage personnel dans beaucoup de juridictions, vérifier la vôtre.

## 📚 Ressources
- Site officiel : https://youtarr.com
- Documentation : https://docs.youtarr.com
- yt-dlp : https://github.com/yt-dlp/yt-dlp
- Wiki *arr : https://wiki.servarr.com

## 🔗 Pages Liées
- [[cat-arr]]
- [[app-sonarr]]
- [[app-radarr]]
- [[app-jellyfin]]
- [[app-plex]]
- [[app-emby]]
- [[app-tubearchivist]]
- [[app-tubesync]]
- [[app-traefik]]
- [[app-flaresolverr]]
- [[recettes-docker-compose]]
- [[securisation-home-lab]]