Repolode
Submit
Kometa-Team

Kometa-Team/Kometa

Python script that updates Plex media metadata and automatically builds collections and playlists using TMDb, IMDb and other sources.

View on GitHubWebsite
Stars
3,460
Forks
376
Open issues
18
Last commit
11 hours ago

What is it?

Kometa is a Python script for Plex media servers. It updates metadata such as artwork, titles and summaries for movies, shows and music, and builds collections and playlists automatically from sources including TMDb and IMDb.

Collections and overlays are defined in configuration files. The project ships modular pre-made collection and overlay files called Kometa Defaults, so users can apply curated sets without writing each one by hand. It can also integrate with Sonarr and Radarr to automate library growth.

Because metadata is kept outside the media server, customizations can be reapplied after a database loss or moved between servers. Kometa is installable on Windows, macOS, Linux, and via Docker, with walkthroughs for unRAID, Kubernetes, QNAP and Synology.

Key features

  • 01Updates Plex metadata such as artwork, titles and summaries.
  • 02Builds collections and playlists from TMDb, IMDb and other sources.
  • 03Provides pre-made modular collection and overlay files (Kometa Defaults).
  • 04Creates overlays on posters to display show or movie status.
  • 05Integrates with Sonarr and Radarr.
  • 06Runs locally or in Docker.

Use cases

  • Organizing a Plex library into trending, genre, decade or studio collections.
  • Keeping custom artwork and metadata safe from media server database loss.
  • Adding poster overlays that show status or ratings across a large library.
  • Automating library growth by linking Plex with Sonarr and Radarr.

Quick start

  1. 1

    Install Kometa on your device using the installation instructions in the Kometa Wiki

  2. 2

    Create your Configuration File with URLs and credentials for Plex and TMDb

  3. 3

    Create a Collection File for each library you want to work with

  4. 4

    Explore the Kometa Wiki to learn more features

Things to know

  • Requires a Plex media server and TMDb API access to be useful.
  • Setup needs a configuration file and collection files, which takes effort to learn.
  • The develop branch is beta and may contain bugs.

In collections

Home media servers

Topics

#plex#metadata#media-library#automation#home-server#docker#kometa

FAQ

What is Kometa?
Python script that updates Plex media metadata and automatically builds collections and playlists using TMDb, IMDb and other sources. Kometa is a Python script for Plex media servers. It updates metadata such as artwork, titles and summaries for movies, shows and music, and builds collections and playlists automatically from sources including TMDb and IMDb.
Is Kometa free to use? What license does it have?
Kometa is open source under the MIT license. Check the license terms before using it in commercial products.
Is Kometa still maintained?
Actively maintained. The last commit to Kometa was on Nov 6, 2026.
What can I use Kometa for?
Organizing a Plex library into trending, genre, decade or studio collections. Keeping custom artwork and metadata safe from media server database loss. Adding poster overlays that show status or ratings across a large library. Automating library growth by linking Plex with Sonarr and Radarr.
How do I install Kometa?
Install Kometa on your device using the installation instructions in the Kometa Wiki Create your Configuration File with URLs and credentials for Plex and TMDb Create a Collection File for each library you want to work with Explore the Kometa Wiki to learn more features
Where can I get Kometa?
The source code and installation instructions are on GitHub: https://github.com/Kometa-Team/Kometa

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects