Files
wiki/Catalogue-Self-Hosted/apps/app-maintainerr.md
T
2026-06-09 18:40:21 +02:00

5.6 KiB


title: Maintainerr created: 2026-06-07 updated: 2026-06-07 type: app tags: [catalogue, arr, automation, deletion, sonarr, radarr] confidence: high contested: false sources: [https://selfh.st/apps/?tag=*arr, https://github.com/jorenn92/Maintainerr]

🎬 Maintainerr

Gestionnaire de règles de suppression automatique pour Sonarr et Radarr : applique des politiques custom (âge, watched, exclusion, requêtes Overseerr) pour nettoyer votre bibliothèque selon vos critères.

⚠️ TRIGGER WARNING : Maintainerr supprime des médias (fichiers + entrées bibliothèque) selon des règles automatiques. Une mauvaise configuration peut effacer définitivement votre bibliothèque. Toujours tester en mode "log only" avant activation.

📋 Informations Générales

Attribut Valeur
Nom Maintainerr
Slug maintainerr
Description Moteur de règles de suppression pour Sonarr/Radarr, basé sur l'âge, le statut watched, les critères métier et les requêtes Overseerr/Jellyseerr
Site officiel https://github.com/jorenn92/Maintainerr
Repository https://github.com/jorenn92/Maintainerr
Stars 2 016
Licence GPL-3.0
Langage principal TypeScript / Node.js
Catégorie *arr (maintenance)
Tags [catalogue, arr, automation, deletion, sonarr, radarr]

📝 Description

Maintainerr est à la gestion de bibliothèque ce que Maintainerr est à la procrastination : il fait ce que vous n'avez jamais le courage de faire à la main — supprimer les films et séries que vous ne regardez pas, qui sont vieux, qui sont doublonnés, ou que personne n'a demandés.

Le concept repose sur les Règles : chaque règle est un ensemble de conditions (âge > X mois, watched status, type, genres, note Trakt, présence dans une collection, demande Overseerr) liées par AND/OR, et un seuils (combien de jours après l'événement déclencheur la suppression se produit). Quand une règle matche, Maintainerr supprime le média du client torrent et de Sonarr/Radarr (donc de Jellyfin/Plex après le prochain scan).

Les règles prédéfinies couvrent les cas courants : "supprimer les films non visionnés 1 an après ajout", "supprimer les séries terminées 3 mois après le dernier épisode regardé", "respecter les exclusions manuelles pendant 6 mois", "ne pas supprimer ce qui est dans la watchlist Trakt", etc.

⚠️ Important : la suppression inclut :

  • Le torrent dans qBittorrent/Deluge (suppression avec fichiers).
  • L'entrée dans Sonarr/Radarr.
  • Le fichier dans la bibliothèque (Jellyfin/Plex verra le fichier disparaître).

L'UI est claire, le système de periodes de grâce (rule delay) est bien pensé pour annuler une suppression pendant 7-30 jours.

🚀 Installation

Via Docker (recommandé)

# docker-compose.yml
services:
  maintainerr:
    image: ghcr.io/jorenn92/maintainerr:latest
    container_name: maintainerr
    restart: unless-stopped
    environment:
      - TZ=Europe/Paris
      - PORT=6246
    volumes:
      - ./config:/app/config
    ports:
      - "6246:6246"
    depends_on:
      - sonarr
      - radarr

Installation manuelle

Node.js 20+ requis. git clone, npm ci, npm run build, npm start.

⚙️ Configuration

  • Connexion Sonarr/Radarr : URL + API key, accès complet (lecture + écriture).
  • Connexion qBittorrent : user/pass pour pouvoir supprimer le torrent côté client.
  • Période de grâce globale : délai minimum avant toute suppression (24h par défaut, recommandé : 7 jours).
  • Règles : commencer par 1-2 règles simples en mode Log only pendant 2 semaines, observer, affiner, puis activer Delete.
  • Exclusions : possibilité d'exclure manuellement un film/série pour X mois.
  • Webhook Overseerr : si la série est demandée par un utilisateur Overseerr, ne pas supprimer.
  • Notifications : Discord, Telegram, Gotify — avertir 7j, 1j avant suppression effective.

🔗 Alternatives

  • Cleanuparr — orienté maintenance technique (torrents bloqués), pas règles métier.
  • Sonarr/Radarr built-in — pas de système de règles de suppression équivalent.
  • Traktarr — ajoute/supprime via watchlist Trakt, cas d'usage différent.
  • Scripts custom — TRaSH dispose de quelques exemples, mais sans UI.

🔒 Sécurité

  • HTTPS + SSO obligatoire : l'UI permet de déclencher des suppressions manuelles, jamais en clair.
  • Mode Log only au début : impératif, tester chaque règle au moins 2 semaines avant d'activer.
  • Backup : maintenir un snapshot de /library (Borg, Restic, snapshots ZFS/Btrfs) au cas où une règle trop agressive détruit un contenu aimé.
  • Droits fichiers : doit avoir accès en écriture à /downloads et /library pour les suppressions, mêmes droits que Sonarr/Radarr.
  • Audit log : conserver les logs Maintainerr (les actions de suppression), prouver à la famille qu'on n'a pas effacé sa série préférée par accident.
  • ⚠️ Suppression définitive : une fois effacé du client torrent, le fichier est perdu ; Maintainerr ne re-télécharge pas automatiquement.

📚 Ressources

🔗 Pages Liées