Initial vault setup

This commit is contained in:
2026-06-09 18:40:21 +02:00
commit bda02d587f
3692 changed files with 402457 additions and 0 deletions
+107
View File
@@ -0,0 +1,107 @@
---
title: Unpackerr
created: 2026-06-07
updated: 2026-06-07
type: app
tags: [catalogue, arr, extraction, automation, sonarr, radarr]
confidence: high
contested: false
sources: [https://selfh.st/apps/?tag=*arr, https://github.com/Unpackerr/unpackerr]
---
# 🎬 Unpackerr
> Extracteur automatique d'archives pour la suite *arr : surveille les téléchargements terminés dans qBittorrent/Deluge/rTorrent/SABnzbd et décompresse RAR/ZIP/7z/ISO dès que possible, puis notifie Sonarr/Radarr.
## 📋 Informations Générales
| Attribut | Valeur |
|----------|--------|
| **Nom** | Unpackerr |
| **Slug** | unpackerr |
| **Description** | Service d'extraction d'archives en arrière-plan, dépendance de Sonarr/Radarr pour gérer correctement les releases compressées (RAR multi-parties, ISO, etc.) |
| **Site officiel** | https://unpackerr.zip |
| **Repository** | https://github.com/Unpackerr/unpackerr |
| **Stars** | 1 410 ⭐ |
| **Licence** | GPL-3.0 |
| **Langage principal** | Go |
| **Catégorie** | *arr (utilitaires) |
| **Tags** | [catalogue, arr, extraction, automation, sonarr, radarr] |
## 📝 Description
**Unpackerr** est l'un de ces outils **quasi-invisibles mais essentiels** qu'on découvre après avoir galéré : vous téléchargez une release de film, c'est un `.rar` avec 47 volumes. Sonarr/Radarr **ne peut pas** importer un fichier `.rar` (il faut du `.mkv` ou `.mp4`). Résultat : l'import échoue, l'épisode/le film reste en `stalled`, et vous devez extraire à la main.
Unpackerr se branche sur l'API de votre client download (qBittorrent, Deluge, rTorrent, SABnzbd, NZBGet, Transmission) et **détecte** les téléchargements terminés contenant des archives. Il :
- **Attend** la fin complète du download (toutes les parties).
- **Décompresse** avec `unrar` / `7z` (configurable, gestion des mots de passe).
- **Vérifie** l'intégrité via SFV/par2 si dispo.
- **Déplace** le contenu extrait dans le bon dossier `/library`.
- **Supprime** l'archive temporaire.
- **Notifie** Sonarr/Radarr qu'un nouveau fichier est dispo (via webhook ou polling).
Il gère aussi les **ISO**, les **archives chiffrées** (le mot de passe est dans la config), les **disc images** (BDMV), et les cas tordus de releases mal foutues.
**Dépendance forte** : Unpackerr est **fortement recommandé** dès qu'on consomme des releases issues de scènes privées (rar multi-parties = standard). Sans lui, Sonarr/Radarr perdent 20-30% des imports.
## 🚀 Installation
### Via Docker (recommandé)
```yaml
# docker-compose.yml
services:
unpackerr:
image: ghcr.io/hotio/unpackerr:latest
container_name: unpackerr
restart: unless-stopped
environment:
- TZ=Europe/Paris
- UN_LOG_LEVEL=info
volumes:
- ./config:/config
- /data/downloads:/downloads
- /data/movies:/movies
- /data/tv:/tv
ports:
- "5656:5656" # UI web optionnelle
```
### Installation manuelle
Binaire Go sur les releases GitHub (Linux x64/arm64, macOS, Windows, FreeBSD, Synology). Service systemd fourni.
## ⚙️ Configuration
- **Clients torrent** : qBittorrent (URL + user/pass), Deluge (password local), rTorrent (XMLRPC), SABnzbd, NZBGet, Transmission.
- **Dossiers surveillés** : pointer sur les chemins `/downloads` accessibles par Unpackerr.
- **Mots de passe archives** : `rTorrent,ScenePass1,AnotherPassword` — il teste dans l'ordre.
- **Path rules** : `Sonarr``/downloads/tv/*` → déplacer vers `/data/tv/`. Idem Radarr.
- **Cleanup** : supprimer `.rar`, `.part`, `.nfo` parasites après extraction.
- **Par2 / SFV** : activer la vérification, permet de détecter les archives corrompues avant extraction.
## 🔗 Alternatives
- **Sonarr/Radarr built-in extraction** — basique, ne gère que les cas simples (1 archive .zip, par exemple).
- **FileBot** — GUI lourde, pas d'automation, plutôt orientée renommage.
- **Scripts `unar`/`unrar` custom** — faisable, mais zéro UI ni gestion des imports ratés.
- **RARBG / 1337x communautés** — publient souvent des `.mkv` non archivés, contourne le problème en amont.
## 🔒 Sécurité
- **Droits fichiers** : doit lire `/downloads` et écrire dans `/library`, aligner PUID/PGID sur Sonarr/Radarr/qBittorrent.
- **Mots de passe archives en clair** dans `./config/unpackerr.conf` : **chiffrer le volume** de config.
- **Pas d'auth locale forte** sur l'UI : mettre derrière Authelia/Authentik, ou désactiver le port public.
- **Logs** : contiennent les noms de fichiers (et donc les contenus), modérer la verbosité.
- **CPU/RAM** : l'extraction d'une release 4K50GB peut consommer 2-4 Go de RAM temporaire et saturer un CPU faible ; dimensionner en conséquence.
## 📚 Ressources
- Site officiel : https://unpackerr.zip
- Documentation : https://unpackerr.zip/docs
- Wiki *arr : https://wiki.servarr.com
## 🔗 Pages Liées
- [[cat-arr]]
- [[app-sonarr]] — premier consommateur d'Unpackerr
- [[app-radarr]] — second consommateur
- [[app-qbittorrent]]
- [[app-sabnzbd]]
- [[app-nzbget]]
- [[app-filebot]]
- [[app-traefik]]
- [[app-authentik]]
- [[securisation-home-lab]]
- [[recettes-docker-compose]]