170 lines
8.3 KiB
Markdown
170 lines
8.3 KiB
Markdown
---
|
|
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
|