---
title: Rangarr
created: 2026-06-07
updated: 2026-06-07
type: app
tags: [catalogue, arr, fichiers, tri]
confidence: high
contested: false
sources: [https://selfh.st/apps/?tag=*arr, https://github.com/l3uddz/rangarr]
---

# 🎬 Rangarr

> Outil de tri et de renommage intelligent des fichiers pour Sonarr et Radarr selon vos conventions.

## 📋 Informations Générales
| Champ | Valeur |
|-------|--------|
| **Nom** | Rangarr |
| **Développeur** | l3uddz |
| **Langage** | Go |
| **Licence** | GPL-3.0 |
| **Catégorie** | Gestion de fichiers |
| **Stack** | Sonarr, Radarr, Lidarr, Readarr |
| **Interface** | CLI + API REST |

## 📝 Description
Rangarr est un utilitaire complémentaire à Sonarr/Radarr qui prend en charge le tri, le déplacement et le renommage de fichiers médias en dehors du cycle d'import standard. Il complète les *arr en traitant les cas où un fichier est mal classé, mal nommé ou placé dans un répertoire inadéquat.

L'outil scanne vos bibliothèques, compare aux métadonnées TMDB/TVDB et propose (ou applique) des opérations de renommage et de déplacement conformes aux conventions de nommage. Il supporte les regex, les wildcards et des règles de mapping personnalisées pour les cas exotiques.

Idéal pour reprendre en main une bibliothèque existante mal organisée, pour harmoniser des fichiers importés manuellement ou pour appliquer un nouveau schéma de nommage après une mise à jour des TRaSH Guides.

## 🚀 Installation
### Via Docker (recommandé)
```yaml
# docker-compose.yml
services:
  rangarr:
    image: ghcr.io/l3uddz/rangarr:latest
    container_name: rangarr
    environment:
      - SONARR_URL=http://sonarr:8989
      - SONARR_API_KEY=***      - RADARR_URL=http://radarr:7878
      - RADARR_API_KEY=***    volumes:
      - /mnt/media:/media:ro
      - ./config:/app/config
    restart: unless-stopped
```

### Installation manuelle
Go 1.21+, `go install github.com/l3uddz/rangarr@latest`, configurer `config.yaml`.

## ⚙️ Configuration
- **Sources** : chemins de bibliothèques à scanner
- **Conventions** : templates de nommage (saison/épisode, qualité, groupe)
- **Mode dry-run** : prévisualisation sans toucher aux fichiers
- **Cible** : déplacement vers arborescence standardisée

## 🔗 Alternatives
- **Sonarr/Radarr natifs** — renommage limité à l'import
- **FileBot** — renommage media payant, hors Docker
- **TRaSH Guides naming** — convention à appliquer manuellement

## 🔒 Sécurité
- Accès lecture seule aux médias par défaut
- Confirmation explicite requise pour opérations destructives
- Logs d'audit des opérations effectuées
- Pas d'accès réseau sortant autre que les API *arr

## 📚 Ressources
- [GitHub Rangarr](https://github.com/l3uddz/rangarr)
- [Selfh.st *arr](https://selfh.st/apps/?tag=*arr)

## 🔗 Pages Liées
- [[cat-arr]]
- [[app-sonarr]]
- [[app-radarr]]
- [[app-filebot]]
- [[recettes-docker-compose]]
- [[securisation-home-lab]]
