Skip to content
Plex Docs

Kometa (PMM)

Kometa (Plex Meta Manager)

Section titled “Kometa (Plex Meta Manager)”

Kometa automates collection creation, overlays, and metadata management.

Installation

Section titled “Installation”
Section titled “Docker (Recommended)”
kometa:
  image: kometateam/kometa:latest
  container_name: kometa
  restart: unless-stopped
  environment:
    - TZ=America/New_York
    - KOMETA_RUN=true
    - KOMETA_TIME=05:00
  volumes:
    - ./kometa:/config

Python

Section titled “Python”
Terminal window
git clone https://github.com/Kometa-Team/Kometa.git
cd Kometa
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

Configuration

Section titled “Configuration”

Create config/config.yml:

libraries:
  Movies:
    collection_files:
      - pmm: basic
      - pmm: imdb
    overlay_files:
      - pmm: resolution
      - pmm: audio_codec
  TV Shows:
    collection_files:
      - pmm: basic
      - pmm: imdb


plex:
  url: http://plex:32400
  token: YOUR_PLEX_TOKEN


tmdb:
  apikey: YOUR_TMDB_API_KEY

Built-in Collections

Section titled “Built-in Collections”

Movies

Section titled “Movies”
  • pmm: basic - Decades, genres
  • pmm: imdb - Top 250, Popular
  • pmm: streaming - Netflix, Disney+
  • pmm: franchise - Movie series

TV Shows

Section titled “TV Shows”
  • pmm: basic - Decades, genres
  • pmm: network - Network collections
  • pmm: streaming - Streaming services

Overlays

Section titled “Overlays”

Add visual badges to posters:

overlay_files:
  - pmm: resolution  # 4K, 1080p badges
  - pmm: audio_codec # Dolby Atmos, DTS-X
  - pmm: ratings     # IMDb, RT scores
  - pmm: streaming   # Netflix, Hulu logos

Custom Collections

Section titled “Custom Collections”
collections:
  My Favorites:
    smart_label: random
    summary: My all-time favorite movies
    plex_search:
      any:
        title:
          - "Inception"
          - "The Matrix"
          - "Interstellar"

Running Kometa

Section titled “Running Kometa”
Terminal window
# Docker
docker compose up kometa


# Manual
python kometa.py --run


# Scheduled (Docker)
# Set KOMETA_TIME=05:00 for daily 5 AM runs

Get Your Tokens

Section titled “Get Your Tokens”

Plex Token

Section titled “Plex Token”
Terminal window
# From Plex Web browser console, or:
curl -u "user:pass" "https://plex.tv/users/sign_in.xml" -X POST -H "X-Plex-Client-Identifier: Kometa"

TMDB API Key

Section titled “TMDB API Key”
  1. Create account at themoviedb.org
  2. Go to Settings → API
  3. Request API key

Next Steps

Section titled “Next Steps”