---
title: Sonobarr
created: 2026-06-07
updated: 2026-06-07
type: app
tags: [catalogue, arr, notifications, sonarr]
confidence: high
contested: false
sources: [https://selfh.st/apps/?tag=*arr, https://github.com/nicoolas/sonobarr]
---

# 🎬 Sonobarr

> Couche de notifications dédiée à Sonarr pour des alertes contextuelles et riches.

## 📋 Informations Générales
| Champ | Valeur |
|-------|--------|
| **Nom** | Sonobarr |
| **Développeur** | nicoolas |
| **Langage** | Python |
| **Licence** | MIT |
| **Catégorie** | Notifications |
| **Stack** | Sonarr |
| **Interface** | Web UI |

## 📝 Description
Sonobarr est un complément spécialisé pour Sonarr qui étend et enrichit le système de notifications natif. Il permet d'envoyer des alertes plus détaillées (avec affiches, synopsis, qualité, épisode) vers Discord, Telegram, Slack, Pushover et autres services compatibles webhook.

L'application écoute les webhooks émis par Sonarr lors d'événements clés (épisode capturé, import réussi, échec d'import, mise à niveau, etc.) puis les transforme en messages enrichis via des templates personnalisables. Elle ajoute également des fonctionnalités de filtrage et d'agrégation pour éviter le spam.

Idéal pour les utilisateurs qui trouvent les notifications Sonarr natives trop basiques et veulent un canal d'alerte homogène, lisible et informatif sans avoir à monter une stack de monitoring lourde.

## 🚀 Installation
### Via Docker (recommandé)
```yaml
# docker-compose.yml
services:
  sonobarr:
    image: ghcr.io/nicoolas/sonobarr:latest
    container_name: sonobarr
    ports:
      - "8765:8765"
    environment:
      - SONARR_URL=http://sonarr:8989
      - SONARR_API_KEY=your_api_key
      - WEBHOOK_SECRET=change_me
    volumes:
      - ./config:/app/config
    restart: unless-stopped
```

### Installation manuelle
Python 3.11+, cloner le repo, `pip install -r requirements.txt`, lancer `python -m sonobarr`.

## ⚙️ Configuration
- **Webhooks Sonarr** : pointer vers l'URL Sonobarr avec secret
- **Templates** : personnaliser le rendu par type d'événement
- **Destinations** : Discord, Telegram, Slack, Pushover, webhooks custom
- **Filtres** : seuils de qualité, genres à ignorer, anti-doublons

## 🔗 Alternatives
- **Notifiarr** — notifications multi-*arr polyvalentes
- **Pulsarr** — agrégateur multi-services
- **Apprise** — bibliothèque de notifications multi-canal

## 🔒 Sécurité
- Secret webhook obligatoire et rotaté
- Clé API Sonarr en variable d'environnement
- Exposition derrière reverse proxy authentifié
- Pas d'accès internet sortant non requis

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

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