Built with these tools and technologies:
Table of Contents
- π Overview
- πΎ Features
- π Repository Structure
- π Getting Started
- π€ Contributing
- π Acknowledgments
β― 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.
β― 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.
βββ kometa_files/
βββ .github
β βββ ISSUE_TEMPLATE
βββ images
βββ libraries
β βββ movies
β β βββ collections
β β βββ metadata
β β βββ overlays
β βββ series
β βββ collections
β βββ metadata
β βββ overlays
βββ playlists
βββ README.md
βββ config.yml.templateThis 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
--rootso the tool can modify files in-place.
Contributions are welcome! Here are several ways you can contribute:
- Report Issues: Submit bugs found or log feature requests for the
kometa_filesproject. - Join the Discussions: Share your insights, provide feedback, or ask questions.
- 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.
