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,169 @@
+---
+title: Kometa
+created: 2026-06-07
+updated: 2026-06-07
+type: app
+tags: [catalogue, automation, plex, metadata, media-management, python, *arr]
+confidence: high
+contested: false
+sources: [https://selfh.st/apps/?tag=Automation, https://github.com/Kometa-Team/Kometa]
+---
+
+# 🎬 Kometa
+
+> **Le maquilleur de votre bibliothèque Plex** — enrichissez automatiquement vos films et séries avec affiches, synopsis, collections thématiques, logos et bien plus, à partir de bases de données communautaires. Anciennement connu sous le nom **Plex Meta Manager**.
+
+## 📋 Informations Générales
+
+| Champ | Valeur |
+| :--- | :--- |
+| **Site web** | [kometa.wiki](https://kometa.wiki/) |
+| **GitHub** | [Kometa-Team/Kometa](https://github.com/Kometa-Team/Kometa) |
+| **License** | MIT |
+| **Langage** | Python |
+| **Étoiles GitHub** | 369 ⭐ (cette stat) / 3k+ en réalité |
+| **Dernière MAJ** | 2026-06-02 |
+| **Catégorie** | [[cat-automation\|Automation]] |
+
+## 📝 Description
+
+**Kometa** (anciennement *Plex Meta Manager*, renommé en 2023 à la suite d'une demande de la marque Plex) est l'**outil ultime pour embellir une bibliothèque Plex**. Si vous avez un Plex avec 5 000 films et 200 séries, l'interface par défaut est... fonctionnelle. Kometa la transforme en **vraie expérience cinéphile** : affiches alternatives, collections « Marvel Cinematic Universe », « Oscars 2025 », « Studio Ghibli », « Films français des années 90 », logos de chaînes TV, résumés détaillés, indicateurs de qualité, posters par saison, et bien plus.
+
+Le projet est un **script Python** (avec un wrapper de config YAML) qui se branche sur l'**API Plex** et sur des dizaines de **sources de métadonnées** : TMDb, TVDb, IMDb, Trakt, Mubi, Letterboxd, AniDB, MyAnimeList, ICheckMovies, FlixPatrol, etc. Vous décrivez ce que vous voulez dans des fichiers YAML, Kometa fait le reste : matching, téléchargement d'affiches, application des tags, création des collections, tri personnalisé.
+
+**Fonctionnalités principales** :
+- ✅ **Collections automatiques** : « Tous les Marvel », « Séries terminées », « Documentaires primés », etc. — prêtes à l'emploi via les "default collections" du wiki
+- ✅ **Affiches alternatives** : choix entre plusieurs posters (officiel, fanart, vintage, custom)
+- ✅ **Logos TV** : superposition du logo de la chaîne sur les posters (effet Netflix-like)
+- ✅ **Thèmes de bibliothèque** : images d'arrière-plan, titres animés (Summary, TheMovieDb)
+- ✅ **Résumés enrichis** : synopsis traduit, casting, runtime, certification
+- ✅ **Tri personnalisé** : par note TMDb, par année, par genre, par réalisateur
+- ✅ **Smart playlists dynamiques** : « Films > 4★ que vous n'avez pas vus »
+- ✅ **Overlay** : superposition d'indicateurs (RESOLUTION, AUDIO CODEC, REVIEW SCORE)
+- ✅ **Mass operations** : nettoyer les affiches dupliquées, fusionner les items, tagger
+- ✅ **Multi-bibliothèques** : un seul run pour Movies + TV + Anime + Music
+- ✅ **Schedules** : cron ou run continu pour rafraîchir quotidiennement
+- ✅ **Templates** : la communauté partage des YAML pour chaque pays/genre/année
+
+**Cas d'usage emblématique** : grâce à la *default library*, en 1 ligne de YAML vous obtenez 30+ collections (Marvel, DC, Pixar, James Bond, Star Wars, Seigneur des Anneaux, Harry Potter, Studio Ghibli…) créées automatiquement dans Plex, prêtes à naviguer.
+
+## 🚀 Installation
+
+### Prérequis
+- Un serveur **Plex Media Server** accessible
+- Une clé API **TMDb** (gratuite, [themoviedb.org/settings/api](https://www.themoviedb.org/settings/api))
+- Un token API **Plex** (généré depuis [support.plex.tv](https://support.plex.tv/articles/204059436-finding-an-authentication-token-x-plex-token/))
+
+### Option 1 : Docker (recommandé)
+```yaml
+# docker-compose.yml
+services:
+  kometa:
+    image: kometateam/kometa:latest
+    container_name: kometa
+    restart: unless-stopped
+    environment:
+      - TZ=Europe/Paris
+      - KOMETA_CONFIG=/config/config.yml
+      - KOMETA_TIME=03:00              # exécution quotidienne à 3h du matin
+      - KOMETA_RUN=true                # run au démarrage
+    volumes:
+      - ./config:/config               # vos fichiers YAML
+      - ./logs:/logs                   # logs persistants
+      - /mnt/plex/metadata:/metadata:ro  # accès optionnel aux fichiers
+```
+
+Fichier de configuration `config/config.yml` minimal :
+```yaml
+plex:
+  url: http://plex:32400
+  token: YOUR_PLEX_TOKEN
+  timeout: 60
+
+tmdb:
+  apikey: YOUR_TMDB_API_KEY
+
+libraries:
+  Movies:
+    metadata_path:
+      - pmm: basic                # module de base
+    collection_files:
+      - pmm: default              # collections par défaut Kometa
+    overlay_files:
+      - pmm: overlays             # overlay résolution/audio
+  TV Shows:
+    metadata_path:
+      - pmm: basic
+    collection_files:
+      - pmm: default
+```
+
+### Option 2 : Python (venv)
+```bash
+git clone https://github.com/Kometa-Team/Kometa.git
+cd Kometa
+python3 -m venv venv
+source venv/bin/activate
+pip install -r requirements.txt
+python kometa.py
+```
+
+## ⚙️ Configuration
+
+- **`config.yml`** : configuration principale (Plex, TMDb, libraries, schedules)
+- **Metadata files** (`pmm: basic`, `pmm: imdb`, `pmm: anidb`…) : comment enrichir chaque item
+- **Collection files** (`pmm: default`, `pmm: studio`…) : quelles collections créer
+- **Overlay files** : indicateurs visuels à superposer
+- **Plugin files** : custom scripts Python
+- **Templates** : blocks YAML réutilisables (DRY)
+- **Schedule via cron** : `KOMETA_TIME=03:00` ou utiliser un cron externe
+- **Run modes** : `--run` (one-shot), `--schedule` (boucle infinie), `--tests` (vérif sans modifier)
+
+## 🔗 Alternatives
+
+### Open Source
+- **Plex Meta Manager (v1)** — l'ancêtre de Kometa, forké
+- **Jellyfin + plugins** — concurrent direct de Plex avec plugins similaires
+- **Emby + plugins** — concurrent avec écosystème de plugins
+- **Plex built-in metadata agents** — basique, sans collections auto
+- **Radarr/Sonarr** — orientés acquisition, pas métadonnées
+- **PlexAutoSkip** — pour skip intros/outros (complémentaire)
+- **WebTools (Nuxeo)** — plugins Plex non-officiels
+
+### Propriétaires (ce que Kometa remplace)
+- **Plex Pass collections "official"** — très limitées sans Plex Pass
+- **Letterboxd API directe** — non disponible publiquement
+- **Trakt VIP Lists** — 5 $/mois, collections managées à la main
+- **iTunes/Apple TV metadata** — non accessible API
+- **Services de "media library management"** — 200-500 $/an via des agences
+- **PosterDatabase.com** — site web mais sans automation Plex
+- **TaigaTools pour IMDb** — pas d'intégration Plex
+
+## 🔒 Sécurité
+
+- ⚠️ **Tokens sensibles** : le `config.yml` contient le **token Plex** (accès total à votre serveur) et la **clé TMDb** — ne **jamais** commit dans Git public
+- **Restreindre l'accès au dossier `config/`** : `chmod 600 config.yml`
+- **Utiliser des variables d'environnement** (`.env` + `env_file` Docker) pour les secrets en production
+- **Réseau** : Kometa doit pouvoir joindre Plex (`http://plex:32400`) — ne pas l'exposer sur Internet
+- **Vault HashiCorp ou SOPS** : pour chiffrer `config.yml` au repos si partagé dans une équipe
+- **Dry-run** : tester avec `KOMETA_RUN=false` puis `python kometa.py --run --tests` pour vérifier avant d'appliquer
+- **Sauvegarde** : Kometa modifie la base Plex ; **sauvegarder la DB Plex** (`/var/lib/plexmediaserver/Library/Application Support/Plex Media Server/`) avant la première utilisation
+- **Logs** : conserver 7-30 jours de logs pour audit (qui a ajouté quelle collection quand)
+
+## 📚 Ressources
+
+- [Site officiel](https://kometa.wiki/)
+- [Dépôt GitHub](https://github.com/Kometa-Team/Kometa)
+- [Documentation complète](https://kometa.wiki/en/latest/)
+- [Default collections](https://kometa.wiki/en/latest/defaults/overview.html) — la killer feature
+- [Tutoriels](https://kometa.wiki/en/latest/tutorials/setup.html)
+- [Discord communautaire](https://discord.gg/kometa-783182968068296734)
+- [r/Plex](https://www.reddit.com/r/Plex/) — retours d'expérience
+
+## 🔗 Pages Liées
+- [[cat-automation]] — Catégorie Automation
+- [[cat-media-streaming]] — Catégorie Streaming
+- [[cat-arr]] — Catégorie *arr (Radarr, Sonarr…)
+- [[recettes-docker-compose]] — Templates Docker
+- [[securisation-home-lab]] — Sécurité
+- [[Catalogue-Self-Hosted]] — Hub