108 lines
5.0 KiB
Markdown
108 lines
5.0 KiB
Markdown
---
|
|
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]]
|