Skip to content

Repository files navigation

KOMETA_FILES

Built with these tools and technologies:




Table of Contents


πŸ“ Overview

❯ My files' artwork are based on the positioning of the overlays I use. You may prefer different overlays in different positions. Feel free to use these files as a template. Just replace the image urls with your prefered links. See you in the rabbit hole!

❯ ?foo=bar: What does that mean? I can't always find premade posters that I like. When I don't, I make my own. Once they are in Plex, sometimes I don't like them as much as I thought and I do little tweeks. MediUX does not generate a new link when updating a file. I apply the ?foo=bar (thanks to a mod in the Kometa Reddit for the idea). This then fools the Kometa cache that its a new link and will download the updated poster.


πŸ‘Ύ Features

❯ Prebuilt Kometa files that pull everything together for a well groomed media server. Pulling the respective files will create a collection and add custom matching (as much as possible) posters. With collections like MonsterVerse or Lord of The Rings there is a corisponding TV Shows collection as well and can all be viewed in one easy collection.


πŸ“‚ Repository Structure

└── kometa_files/
    β”œβ”€β”€ .github
    β”‚   └── ISSUE_TEMPLATE
    β”œβ”€β”€ images
    β”œβ”€β”€ libraries
    β”‚   β”œβ”€β”€ movies
    β”‚   β”‚     β”œβ”€β”€ collections
    β”‚   β”‚     β”œβ”€β”€ metadata
    β”‚   β”‚     └── overlays
    β”‚   └── series
    β”‚         β”œβ”€β”€ collections
    β”‚         β”œβ”€β”€ metadata
    β”‚         └── overlays    
    β”œβ”€β”€ playlists
    β”œβ”€β”€ README.md 
    └── config.yml.template

πŸš€ Getting Started

πŸ”– Prerequisites

Plex Media Server

Kometa

πŸ“¦ Kometa Configuration

Sample Kometa Config File

Kometa MediUX Resolver (fast-runner)

This repository now includes the Kometa MediUX Resolver β€” a small CLI tool that discovers MediUX artwork (title cards, posters, backdrops) and proposes safe additions to existing Kometa metadata YAML files.

Quick usage (from repository root):

# dry-run
python3 scripts/kometa_mediux_resolver/kometa_mediux_resolver.py --root . --output /tmp/changes.json

# or use the convenience wrapper (tries .venv if present)
scripts/kometa-resolver --root . --output /tmp/changes.json

# apply changes (creates timestamped backups)
scripts/kometa-resolver --root . --apply --require-probe-ok --output /tmp/changes.json

Notes:

  • The resolver updates existing metadata files only; it will not create new files.
  • For Docker usage, mount the folder containing your Kometa YAMLs and pass that mount path to --root so the tool can modify files in-place.

🀝 Contributing

Contributions are welcome! Here are several ways you can contribute:

  • Report Issues: Submit bugs found or log feature requests for the kometa_files project.
  • Join the Discussions: Share your insights, provide feedback, or ask questions.
Contributor Graph


πŸ™Œ Acknowledgments


Buy Me A Coffee

Support is not necessary, but greatly appriciated. It goes to expanding the server to test requests. If you fave a request, submit it here.

About

a repository of premade kometa collections, metadata, and playlist files

Topics

Resources

Stars

26 stars

Watchers

4 watching

Forks

Contributors