107 lines
4.7 KiB
Markdown
107 lines
4.7 KiB
Markdown
---
|
|
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]]
|