---
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]]
