106 lines
5.1 KiB
Markdown
106 lines
5.1 KiB
Markdown
---
|
|
title: Cleanuparr
|
|
created: 2026-06-07
|
|
updated: 2026-06-07
|
|
type: app
|
|
tags: [catalogue, arr, cleanup, torrent, automation, qbittorrent]
|
|
confidence: high
|
|
contested: false
|
|
sources: [https://selfh.st/apps/?tag=*arr, https://github.com/Cleanuparr/Cleanuparr]
|
|
---
|
|
|
|
# 🎬 Cleanuparr
|
|
|
|
> Nettoyeur automatique de torrents orphelins et de fichiers *arr mal gérés : détecte les torrents bloqués, les imports ratés, les fichiers dupliqués, et libère l'espace disque intelligemment.
|
|
|
|
## 📋 Informations Générales
|
|
|
|
| Attribut | Valeur |
|
|
|----------|--------|
|
|
| **Nom** | Cleanuparr |
|
|
| **Slug** | cleanuparr |
|
|
| **Description** | Outil de nettoyage et maintenance pour Sonarr/Radarr/qBittorrent : suppression de torrents bloqués, gestion des imports échoués, optimisation disque |
|
|
| **Site officiel** | https://cleanuparr.github.io |
|
|
| **Repository** | https://github.com/Cleanuparr/Cleanuparr |
|
|
| **Stars** | 2 296 ⭐ |
|
|
| **Licence** | GPL-3.0 |
|
|
| **Langage principal** | C# (.NET) |
|
|
| **Catégorie** | *arr (utilitaires) |
|
|
| **Tags** | [catalogue, arr, cleanup, torrent, automation, qbittorrent] |
|
|
|
|
## 📝 Description
|
|
|
|
**Cleanuparr** est l'outil que vous installez 6 mois après avoir monté votre stack *arr complète, quand vous réalisez que vous avez 200 torrents en `stalled`, 50GB de fichiers `.partial~`, des saisons 3 téléchargées en triple parce qu'un épisode était mal nommé, et 3 jobs Sonarr bloqués depuis 3 semaines sur "Already imported but found in download client".
|
|
|
|
Les fonctionnalités principales :
|
|
|
|
- **Détection des torrents bloqués** : un torrent est `stalled`/`error`/`missing` depuis plus de X jours → action configurable (supprimer, hard-delete, mettre en pause, notifier).
|
|
- **Imports échoués *arr** : scan de la queue Sonarr/Radarr, identification des jobs coincés, retry ou suppression.
|
|
- **Fichiers partiels** : nettoyage des `.partial~`, `*.!qB`, fichiers sans extension dans `/downloads`.
|
|
- **Doublons** : hash-based dedup, garde le fichier de meilleure qualité, supprime les autres.
|
|
- **Hardlinks cassés** : détection et réparation des hardlinks entre `/downloads` et `/library`.
|
|
- **Règles personnalisables** : planifier via cron intégré, dry-run obligatoire, logs détaillés.
|
|
|
|
Cleanuparr est **non-destructif par défaut** : tout part en dry-run, on valide, on bascule en mode actif. C'est appréciable vu qu'il touche à des données irremplaçables.
|
|
|
|
## 🚀 Installation
|
|
### Via Docker (recommandé)
|
|
```yaml
|
|
# docker-compose.yml
|
|
services:
|
|
cleanuparr:
|
|
image: ghcr.io/cleanuparr/cleanuparr:latest
|
|
container_name: cleanuparr
|
|
restart: unless-stopped
|
|
environment:
|
|
- TZ=Europe/Paris
|
|
- LOG_LEVEL=info
|
|
volumes:
|
|
- ./config:/app/config
|
|
- /data/downloads:/downloads
|
|
- /data/movies:/movies
|
|
- /data/tv:/tv
|
|
ports:
|
|
- "6868:6868"
|
|
```
|
|
### Installation manuelle
|
|
.NET 8 SDK requis, binaire self-contained sur les releases GitHub (Linux x64, arm64, Windows).
|
|
|
|
## ⚙️ Configuration
|
|
- **Connexion qBittorrent** : URL, user/pass (pas le cookie). Activer l'API Web dans qBittorrent.
|
|
- **Connexion Sonarr/Radarr** : API key + URL, pour lire la queue d'imports.
|
|
- **Règles de blocage** : par défaut `stalled > 7 jours ET ratio < 1.0 → notifier ; > 14 jours → supprimer avec fichiers`. Ajuster selon votre usage (Fibre + VPN → seuil de 30 jours raisonnable).
|
|
- **Dry-run** : **toujours** activé en premier passage, désactiver seulement après validation.
|
|
- **Notifications** : Discord, Telegram, Apprise (multi-canaux), webhook.
|
|
- **Schedule** : cron intégré, ex `0 3 * * *` (3h du matin tous les jours).
|
|
|
|
## 🔗 Alternatives
|
|
- **Sonarr/Radarr built-in Queue Cleaner** — minimaliste, intégré, mais pas de cross-service.
|
|
- **Maintainerr** — orienté règles de suppression métier (cf. fiche dédiée), pas maintenance technique.
|
|
- **Traktarr** — suppression basée sur watchlist, cas d'usage différent.
|
|
- **Scripts bash custom** — pour les bricoleurs, mais aucune UI ni logs centralisés.
|
|
|
|
## 🔒 Sécurité
|
|
- **Droits fichiers** : Cleanuparr **supprime** des fichiers réels, le user Docker (PUID) doit avoir les droits sur `/downloads` et `/library` — équivalents à Sonarr/Radarr/qBittorrent.
|
|
- **Dry-run avant prod** : tester 1 semaine en mode simulation pour vérifier qu'il n'efface rien d'important.
|
|
- **Pas d'auth locale forte** : mettre derrière Authelia/Authentik, jamais exposé en clair.
|
|
- **Backup** : faire un snapshot de `/downloads` et `/library` avant la première activation, **rien n'est récupérable après suppression**.
|
|
- **Logs** : conserver 30 jours minimum, le service peut faire des erreurs de jugement (garder un torrent qui aurait dû être supprimé est moins grave que l'inverse).
|
|
|
|
## 📚 Ressources
|
|
- Site officiel : https://cleanuparr.github.io
|
|
- Documentation : https://cleanuparr.github.io/docs
|
|
- Wiki *arr : https://wiki.servarr.com
|
|
|
|
## 🔗 Pages Liées
|
|
- [[cat-arr]]
|
|
- [[app-sonarr]]
|
|
- [[app-radarr]]
|
|
- [[app-qbittorrent]]
|
|
- [[app-maintainerr]] — autre outil de suppression, plus orienté règles métier
|
|
- [[app-traktarr]]
|
|
- [[app-traefik]]
|
|
- [[app-gluetun]] — VPN
|
|
- [[securisation-home-lab]]
|
|
- [[recettes-docker-compose]]
|