Initial vault setup

2026-06-09 18:40:21 +02:00
commit bda02d587f
3692 changed files with 402457 additions and 0 deletions
@@ -0,0 +1,110 @@
+---
+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é)
+```yaml
+# 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
+- Repository : https://github.com/jorenn92/Maintainerr
+- Documentation : https://github.com/jorenn92/Maintainerr/wiki
+- Wiki *arr : https://wiki.servarr.com
+
+## 🔗 Pages Liées
+- [[cat-arr]]
+- [[app-sonarr]]
+- [[app-radarr]]
+- [[app-qbittorrent]]
+- [[app-overseerr]]
+- [[app-cleanuparr]] — autre outil de suppression
+- [[app-traktarr]]
+- [[app-traefik]]
+- [[app-authentik]]
+- [[securisation-home-lab]]
+- [[recettes-docker-compose]]