Clean libraries. Clear information.
This Kometa configuration enhances Plex Movie and TV Show libraries with useful poster overlays and automatic collections.
This Kometa setup focuses on:
- Minimal and informative overlays for Movies and TV Shows
- Automatically generating collections based on:
- Streaming services
- Content ratings
- Clean poster artwork
Movies will have the following overlays:
- Resolution (4K, 1080p, etc.)
- IMDb Rating
- Runtime (H:M)
TV Show libraries will have these overlays:
- Resolution
- IMDb Rating
- Show Status
- Streaming
- Returning
- Finished
- Canceled
This configuration generates collections for Movies and TV Shows based on:
Titles released by the same streaming platform are grouped in a single collection.
Examples:
- Netflix
- Amazon Prime Video
- Disney+
- Apple TV+
Titles are also grouped by content rating.
Examples:
- G
- PG
- PG-13
- R
- TV-MA
Before using this configuration, you should already have:
- A working Plex Media Server.
- Kometa installed (Docker or native).
- Plex libraries already created and all media scanned.
Note
This repository is intended for users who already have Kometa installed. If you don't, visit the Kometa Wiki.
Below are the steps to apply this configuration:
-
Clone this repository
git clone https://github.com/TheKevinatorX/Kometa.git
-
Configure your environment
- Open the
env.samplefile. - Enter the appropriate values for your setup.
- Open the
Note
Only KOMETA_PLEXTOKEN and KOMETA_TMDBAPI are required.
- Rename the file
mv env.sample .env
Important
- Redeploy Kometa
- Restart or redeploy your Kometa container.
- Review the Kometa container logs to confirm overlays and collections are applied correctly.
- Alternatively, test Kometa against a small library first and verify results before applying it to your main Plex libraries.
.
├── assets/
│ ├── Kometa-Movie-Overlays.png
│ ├── Kometa-Collections.png
│ ├── Kometa-Show-Overlays.png
│ └── Kometa-Logo.png
│
├── overlays/
│ ├── fonts/
│ │ └── AvenirNextLTPro-Bold.ttf
│ ├── images/
│ │ ├── audience_score_high.png
│ │ ├── audience_score_low.png
│ │ ├── audience_score_mid.png
│ │ └── gradient.png
│ ├── gradient_code.yml
│ └── rating_code.yml
│
├── config.yml
└── env.sample
- Kometa Wiki
- Kometa Github
- Kometa Discord
- Plex Media Server - Discord
- Plex Media Server - Download
- Plex Media Server - Installation
This configuration is provided as-is for personal use. Please respect the licenses and terms of Kometa, Plex, and all metadata providers. See LICENSE for details.


