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

📝 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)
Un token API Plex (généré depuis support.plex.tv)

Option 1 : Docker (recommandé)

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

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)

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

🔗 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

8.3 KiB Raw Permalink Blame History