KOMETA_FILES

Built with these tools and technologies:

Table of Contents

• 📍 Overview
• 👾 Features
• 📂 Repository Structure
• 🚀 Getting Started
  • 🔖 Prerequisites
  • 📦 Installation
• 🤝 Contributing
• 🙌 Acknowledgments

---

📍 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

• Readme built with ReadMe.AI

---

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