Home

Kometa is a powerful tool designed to give you complete control over your media libraries. With Kometa, you can take your customization to the next level, with granular control over metadata, collections, overlays, and much more.

Transform your media library with Kometa and discover its full potential! Connect to third-party services like TMDb, Trakt, and IMDb, among others, to create one-of-a-kind collections, overlays and more. Your media library will stand out and be tailored to your specific needs.

What Can Kometa Do?¶

Collections created using the Kometa Defaults

Elevate your library with beautifully crafted metadata - customize artwork, titles, summaries, and more to create a stunning library.

Harness the power of Trakt, TMDb, IMDb and more to create collections and overlays. Take advantage of pre-made modular Collections & Overlays to reduce the manual effort and get to the good stuff with less effort! You can see some example Collection images above and some example Overlay images below.

Integrate with Sonarr and Radarr to automate your library growth.

Overlays created using the Kometa Defaults or by community created Overlay Files

Getting Started¶

To get started with Kometa, follow these simple steps:

Install Kometa on your device. You can find the installation instructions for a variety of platforms here.
Once you have installed Kometa, create your Configuration File. file contains important information such as URLs and credentials needed to connect to services like Plex and TMDb.
After creating the Configuration File, you can start updating Metadata and building automatic Collections by creating a Collection File for each Library you want to work with. If you'd rather use some of our pre-made Collection Files, take a look at the Kometa Defaults.
Finally, check out the Wiki, you'll find new and exciting ways to truly unlock the potential of your libraries.

Step-by-Step Guides¶

If you're a beginner to the concepts of Python, Git and/or Kometa and find the above steps challenging, don't worry. We've got some step-by-step guides that can help you get started. These guides will take you through the process of installing Kometa, creating your Configuration File and getting some basic Collections up and running.

For those who need full installation walkthroughs, please refer to the following walkthrough guides:

Local Walkthrough - follow this if you are running the script directly on Windows, OS X, or Linux.
Docker Walkthrough - this discusses using Docker at the command line.

If you are using unRAID, Kubernetes, QNAP, or Synology refer to the following basic guide to Docker container setup for each system:

This doesn't cover the Kometa setup specifics found in the guides above with regard to creating the config file and collection file, so you may want to go through the Docker Walkthrough first on your computer to gain that understanding.

Example Usage¶

Kometa puts you in control of your media library by letting you create custom Collections that make discovering and organizing your content a breeze. With powerful search and filtering options, you can build Collections based on popular builders like TMDb, IMDb, Trakt, and many more.

Imagine having Collections like these at your fingertips:

Trending and Popular (based on TMDb, IMDb, Trakt, etc.)
Streaming Services (like Netflix, Disney+, and more)
Networks
Studios
Genres
Actors
Decades

Kometa gives you endless possibilities to curate and organize your media library any way you want. Create custom Collections and Overlays that fit your unique preferences and make discovering your content effortless.

But if you don't want to spend time manually creating Collections and Overlays, we've got you covered. Check out the Kometa Defaults - a handcrafted selection of tried-and-tested Collections and Overlays made by the Kometa team.

Discord Support Server¶

If you're looking for support for any questions or issues you might have, or if you just want to be a part of our growing community, Join the Kometa Discord Server.

GitHub Sponsors¶

Maintenance of this project is made possible by all the contributors and sponsors. If you'd like to sponsor this project and have your avatar or company logo appear below click here. 💖