Skip to content
MediuxDocs

Use Set YAML with Kometa

Every show, movie and collection Set has a YAML document that Kometa reads to apply the Set’s artwork. No account or key is needed.

On mediux.io, open the Set and find YAML export: Open published YAML gives its URL, and Copy YAML or Download YAML give a snapshot. The URL follows the Set’s type and ID:

SetYAMLAlways the original files
Show Sethttps://api.mediux.io/show-set/{id}.yamlhttps://api.mediux.io/show-set/{id}.original.yaml
Movie Sethttps://api.mediux.io/movie-set/{id}.yamlhttps://api.mediux.io/movie-set/{id}.original.yaml
Collection Sethttps://api.mediux.io/collection-set/{id}.yamlhttps://api.mediux.io/collection-set/{id}.original.yaml

The URL always reflects the Set’s current artwork. A snapshot stays as you saved it, and links to the images rather than containing them.

In your config.yml, add the URL under metadata_files for the matching library:

libraries:
Movies:
metadata_files:
- url: https://api.mediux.io/movie-set/321.yaml

For a saved snapshot, point at the file instead:

- file: config/metadata/mediux-movie-set-321.yaml

Kometa’s file-block guide covers both.

  • Movies match by TMDB ID.
  • Shows match by TVDB ID, falling back to IMDb. Seasons and episodes follow TMDB numbering, so pick the TMDB episode order in your library before applying titlecards.
  • Collection Sets go in a movie library. They apply artwork to the collection’s movies, not to a collection itself.

Show and movie posters, backdrops, logos and square art; season posters and backdrops; and episode titlecards. Thumbs aren’t included, and game Sets have no YAML. YAML only changes artwork, never other library metadata.

The document is cached like other Set responses: revalidate it with its ETag (see Caching).