Initial vault setup

2026-06-09 18:40:21 +02:00
commit bda02d587f
3692 changed files with 402457 additions and 0 deletions
@@ -0,0 +1,106 @@
+---
+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]]