title: Recyclarr created: 2026-06-07 updated: 2026-06-07 type: app tags: [catalogue, downloads, arr, sonarr, radarr, trash-guides, automation, go, quality-profiles] confidence: high contested: false sources: [https://selfh.st/apps/?tag=downloads, https://github.com/recyclarr/recyclarr]

♻️ Recyclarr

Synchronise automatiquement les profils de qualité, custom formats et score releases de Sonarr/Radarr/Lidarr/Readarr depuis les TRaSH Guides — la référence communautaire. Fini le copier-coller de 200 lignes de custom formats : Recyclarr le fait pour vous, et le refait à chaque release des guides.

Métadonnée	Valeur
Site web	https://recyclarr.dev
GitHub	https://github.com/recyclarr/recyclarr
License	MIT
Langage	Go
Étoiles	34 ⭐
Dernière MAJ	2025-12
Catégorie	cat-downloads

Description

Les TRaSH Guides sont devenus la référence incontournable pour configurer correctement Sonarr/Radarr : ils recommandent des profils de qualité précis, des custom formats (règles de scoring pour Atmos, HDR10+, DV, x265, etc.) et des filtres de release qui font la différence entre une médiathèque propre et un cimetière de doublons. Mais suivre les guides "à la main" est fastidieux : plusieurs centaines de custom formats à créer un par un, scoring à régler au millimètre, et les guides évoluent toutes les semaines.

Recyclarr automatise tout ça. On déclare dans un fichier YAML recyclarr.yml les profils Sonarr/Radarr/Lidarr/Readarr qu'on veut, et on précise pour chacun quel "TRaSH Guide Profile" appliquer (ex. "HD-1080p", "4K", "Anime"). Recyclarr :

Télécharge la dernière version des TRaSH Guides depuis le repo Git.
Compare avec l'état actuel de l'instance *arr.
Crée/met à jour les custom formats, profiles, quality definitions, et release profiles.
Affiche un diff clair de ce qu'il a modifié.
Idempotent : relancer = aucune modification si rien n'a changé.

Le résultat : un Sonarr/Radarr configuré "comme la communauté" en 5 minutes, et qui reste à jour automatiquement quand les TRaSH Guides évoluent. Recyclarr supporte aussi la synchronisation des Release Profiles (regex, must-contain, must-not-contain) et la gestion des Quality Definitions (tailles de palier par qualité).

Points forts : MIT, binaire Go (1 seul exécutable, ultra-léger), CLI-first (parfait pour cron), maintient la qualité de la médiathèque à jour sans effort.

Points faibles : pas d'UI web (CLI/headless), dépendant des TRaSH Guides (si le projet ralentit, Recyclarr perd sa raison d'être), pas de support natif de Whisparr/Eros (encore en bêta).

Installation

Via Docker (recommandé)

# docker-compose.yml
services:
  recyclarr:
    image: ghcr.io/recyclarr/recyclarr:latest
    container_name: recyclarr
    restart: unless-stopped
    environment:
      - TZ=Europe/Paris
    volumes:
      - ./config:/config
    # Pas de port exposé : CLI only

Exemple de config/recyclarr.yml minimal :

sonarr:
  base_url: http://sonarr:8989
  api_key: xxxxxxxxxxxxxxxxxxxxxxxx
  delete_old_custom_formats: true
  quality_profiles:
    - name: HD-1080p
      trash_id: hd-1080p

Installation manuelle

Binaire Go sur GitHub Releases (Linux/macOS/Windows, x86/ARM). chmod +x recyclarr, lancer ./recyclarr sync. Cron recommandé :

0 4 * * * /usr/local/bin/recyclarr sync >> /var/log/recyclarr.log 2>&1

Configuration

API keys : dans Sonarr/Radarr, Settings → General → API Key.
Fichier YAML : un seul recyclarr.yml à la racine de ./config, structure sonarr: / radarr: / lidarr: / readarr:.
trash_id : copier depuis cette liste — le projet recycle les noms canoniques.
delete_old_custom_formats: true : recommandé pour éviter l'accumulation de CFs obsolètes.
Cron quotidien : 0 4 * * * (4h du matin, après le passage des TRaSH Guides).
Logs : rediriger vers un fichier, superviser via app-grafana / app-loki / app-prometheus.
Pas de reverse-proxy : CLI/headless, on s'y connecte via SSH.

Alternatives

Open source

TRaSH Guides "à la main" — la base de Recyclarr, mais à faire manuellement. Recyclarr n'est qu'un wrapper qui les applique.
app-sonarr / app-radarr / app-lidarr / app-readarr — les consommateurs de la config Recyclarr.
app-prowlarr — agrégateur d'indexers, complémentaire.
app-autobrr — capture IRC, complémentaire.
Notifiarr — notifications Discord/Discord, complémentaire.

Propriétaires

Profil Quality "Default" Sonarr — conservateur, peu optimisé, ne suit pas l'évolution des formats (Atmos, AV1, etc.).
SickRage / CouchPotato — forks historiques sans communauté de guides.
Synology Download Station — propriétaire Synology, sans qualité communautaire.

Sécurité

✅ Aucune exposition réseau : Recyclarr parle en sortant vers l'API *arr (HTTP/HTTPS local), surface d'attaque nulle.
⚠️ API keys *arr : stockées en clair dans recyclarr.yml — chmod 600 et ne pas versionner dans Git public.
✅ Pas de credentials distants : Recyclarr ne parle qu'à votre *arr local + lit le repo Git public des TRaSH Guides.
✅ Idempotent : une erreur d'exécution ne corrompt pas la config *arr, Recyclarr est read-mostly (sauf delete_old_custom_formats).
⚠️ Suppression de custom formats : delete_old_custom_formats: true supprime les CFs non référencés par un profile synchronisé — vérifier qu'aucun profile "manuel" n'utilise un CF que vous voulez garder.
✅ Sauvegardes : recyclarr.yml est minuscule, à inclure dans le backup de ./config.

Ressources

Pages Liées

cat-downloads — Catégorie parente
app-sonarr / app-radarr / app-lidarr / app-readarr — Consommateurs
app-prowlarr — Agrégateur d'indexers
app-nzbget / app-sabnzbd — Backends Usenet
recettes-docker-compose — Templates Docker
securisation-home-lab — Bonnes pratiques

6.7 KiB Raw Blame History