Use YAML exports

A YAML export gives your library tool links to the artwork in a show, movie, or collection set.

Get the export

Open the set and find YAML export. Choose Open published YAML for its public URL, or Copy YAML or Download YAML for a snapshot. No account or API key is needed.

The public URL continues to identify the set when its artwork changes. A local snapshot stays as you saved it, and saving the YAML does not save the images it links to. Copy and download reuse the document loaded during that page visit; reload the page to fetch a newer snapshot.

Add it to Kometa

In your existing config.yml, add the set’s URL under metadata_files for the matching library. Replace the example URL with the one from your chosen set:

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

For a local snapshot, replace the url entry with a path Kometa can read:

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

Kometa’s file-block guide explains remote URLs and local paths.

Match your library

• Movies: matching uses TMDB IDs.
• Shows: matching uses TVDB IDs, falling back to IMDb when needed. Seasons and episodes follow TMDB numbering. Choose the corresponding TMDB episode order in your library before applying titlecards; other numbering is not converted.
• Collections: use a movie library. The export applies artwork to individual movies, excluding the collection’s own images. It does not create or edit a collection.

Check what is included

Exports include supported show and movie posters, backdrops, logos, and square art; season posters and backdrops; and episode titlecards. They link to original files. Thumbs are omitted, and game sets do not offer YAML exports.

An export needs supported artwork and a usable matching ID. A collection set containing only collection images has nothing to export. YAML changes artwork fields only, leaving other library metadata alone.