---
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