Skip to content

TheKevinatorX/Kometa

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🎬 Kometa Configuration

Clean libraries. Clear information.


This Kometa configuration enhances Plex Movie and TV Show libraries with useful poster overlays and automatic collections.


📌 Overview

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

🎞 Overlays

🎬 Movies

Movies will have the following overlays:

  • Resolution (4K, 1080p, etc.)
  • IMDb Rating
  • Runtime (H:M)

📺 TV Shows

TV Show libraries will have these overlays:

  • Resolution
  • IMDb Rating
  • Show Status
    • Streaming
    • Returning
    • Finished
    • Canceled

📸 Screenshots

Movie Overlays

Movie Overlays

TV Show Overlays

TV Show Overlays


📦 Collections

This configuration generates collections for Movies and TV Shows based on:

🎥 Streaming Services

Titles released by the same streaming platform are grouped in a single collection.

Examples:

  • Netflix
  • Amazon Prime Video
  • Disney+
  • Apple TV+

🔞 Content Ratings

Titles are also grouped by content rating.

Examples:

  • G
  • PG
  • PG-13
  • R
  • TV-MA

📸 Collection Screenshots

Movies and TV Show Collections

Movies and TV Show Collections


📋 Prerequisites

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.


⚙️ Setup Instructions

Below are the steps to apply this configuration:

  1. Clone this repository

    git clone https://github.com/TheKevinatorX/Kometa.git
  2. Configure your environment

    • Open the env.sample file.
    • Enter the appropriate values for your setup.

Note

Only KOMETA_PLEXTOKEN and KOMETA_TMDBAPI are required.

  1. Rename the file
    mv env.sample .env

Important

⚠️ Do not commit this file to GitHub

  1. 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.

📁 Repository Structure

.
├── 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

🔗 Useful Resources


📝 License

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.


About

This Kometa configuration enhances your Plex libraries by adding useful overlays and automatic collections.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors