---
title: SuggestArr
created: 2026-06-07
updated: 2026-06-07
type: app
tags: [catalogue, arr, recommandation, suggestion, ia]
confidence: high
contested: false
sources: [https://selfh.st/apps/?tag=*arr, https://github.com/giuseppe99barchitta/SuggestArr]
---

# 🎬 SuggestArr

> Moteur de suggestions automatiques pour Sonarr et Radarr : analyse votre historique, vos notes et vos genres préférés, puis recommande films et séries cohérents avec vos goûts.

## 📋 Informations Générales

| Attribut | Valeur |
|----------|--------|
| **Nom** | SuggestArr |
| **Slug** | suggestarr |
| **Description** | Système de recommandation IA pour Sonarr/Radarr basé sur l'historique, les notes et les genres |
| **Site officiel** | https://github.com/giuseppe99barchitta/SuggestArr |
| **Repository** | https://github.com/giuseppe99barchitta/SuggestArr |
| **Stars** | 1 170 ⭐ |
| **Licence** | MIT |
| **Langage principal** | Python |
| **Catégorie** | *arr (recommandation) |
| **Tags** | [catalogue, arr, recommandation, suggestion, ia] |

## 📝 Description

**SuggestArr** répond à une frustration classique des utilisateurs de Sonarr/Radarr : après des mois d'utilisation, on a vu tout ce qui nous tentait, et on ne sait plus quoi ajouter. Les watchlists Trakt et Letterboxd aident, mais SuggestArr va plus loin en **analysant automatiquement** ce que vous avez déjà consommé.

Fonctionnalités principales :
- **Analyse de l'historique** : récupère les séries regardées (Sonarr) et les films vus (Radarr), calcule des statistiques par genre, acteur, réalisateur, époque.
- **Scoring de compatibilité** : note chaque candidat sur 100 selon la proximité avec vos préférences.
- **Sources multiples** : TMDB, TVDB, Trakt, Letterboxd export, IMDb lists.
- **Interface web simple** : top N suggestions filtrables (genre, année, score minimum).
- **Webhooks optionnels** : envoie les meilleures trouvailles vers Discord/Slack/Telegram.
- **Auto-add** : peut pousser automatiquement les meilleures suggestions dans Sonarr/Radarr avec qualité monitorée.

L'algorithme est volontairement simple et explicable (pas de boîte noire type réseau de neurones lourd), ce qui le rend rapide et peu gourmand.

## 🚀 Installation
### Via Docker (recommandé)
```yaml
# docker-compose.yml
services:
  suggestarr:
    image: ghcr.io/giuseppe99barchitta/suggestarr:latest
    container_name: suggestarr
    restart: unless-stopped
    environment:
      - TZ=Europe/Paris
      - SONARR_URL=http://sonarr:8989
      - SONARR_API_KEY=xxxxxxxxxxxxxxxx
      - RADARR_URL=http://radarr:7878
      - RADARR_API_KEY=xxxxxxxxxxxxxxxx
      - TMDB_API_KEY=xxxxxxxxxxxxxxxx
    volumes:
      - ./config:/app/config
    ports:
      - "9876:9876"
```
### Installation manuelle
Python 3.11+, `git clone`, `pip install -r requirements.txt`, `python -m suggestarr`. Nécessite accès réseau vers Sonarr, Radarr et TMDB.

## ⚙️ Configuration
- **API keys Sonarr/Radarr** : réglages > général > API key, copier-coller dans l'env.
- **TMDB API key** : gratuite sur `themoviedb.org/settings/api`, utilisée pour les métadonnées enrichies.
- **Pondération** : ajuster les poids genre/acteur/réalisateur/époque dans `config.yaml`.
- **Cache** : TTL des recherches TMDB configurable, 24h par défaut.
- **Reverse proxy** : `suggestarr.example.com` via Traefik/Caddy.

## 🔗 Alternatives
- **Maintainerr** — gestion de règles "à supprimer" et de qualité, pas de recommandation.
- **Trakt "Recommended"** — suggestions cloud basées sur la communauté, pas votre historique local.
- **Letterboxd Pro** — excellentes recos cinéma mais pas d'intégration *arr native.
- **Overseerr** — workflow de demandes utilisateur, pas de scoring automatique.
- **Recombee** — service payant de recommandation, plus puissant mais externalisé.

## 🔒 Sécurité
- **API keys** en variables d'environnement, jamais commit dans Git, rotation recommandée annuelle.
- **Pas d'auth utilisateur par défaut** : à exposer derrière un reverse proxy avec Authelia/Authentik.
- **Webhook Discord/Slack** : URL avec secret, ne pas logger en clair.
- **Volumes** : `./config` peut contenir des caches de préférences, à protéger au repos (chiffrement LUKS).
- **Logs** : modérés, contiennent les titres suggérés et les scores, pas de données personnelles.

## 📚 Ressources
- Repository : https://github.com/giuseppe99barchitta/SuggestArr
- Wiki *arr : https://wiki.servarr.com
- TMDB API : https://www.themoviedb.org/settings/api

## 🔗 Pages Liées
- [[cat-arr]]
- [[app-sonarr]]
- [[app-radarr]]
- [[app-traktarr]]
- [[app-overseerr]]
- [[app-jellyseerr]]
- [[app-maintainerr]]
- [[app-traefik]]
- [[app-authelia]]
- [[recettes-docker-compose]]
- [[securisation-home-lab]]
