Skip to content

Simkl DVD

Finds movies and TV shows from Simkl's DVD release lists.

The list is filtered automatically to match your library type: movie libraries receive movies, show libraries receive TV shows, and playlists receive both.

The sync_mode: sync and collection_order: custom Setting are recommended since the lists are continuously updated and in a specific order.

Playlist ordering for DVD

The DVD release endpoint returns a single flat list of items. When used in a playlist (mixed library), each item is evaluated individually and API order is preserved -- movies and shows appear in the same sequence returned by Simkl.

Attribute

Attribute Description Required Default
limit Maximum number of items to return. Must be between 1 and 500. No 20

Note

The Simkl service provides lists of the top 100 items (small) or top 500 items (large). Kometa automatically selects the appropriate list size based on your limit value: small is used when limit is 100 or fewer, large when limit is greater than 100.

Example Simkl DVD Builder(s)

Simple usage with just a limit:

collections:
  New on DVD:
    simkl_dvd: 20
    collection_order: custom
    sync_mode: sync

Using a dict:

collections:
  New on DVD:
    simkl_dvd:
      limit: 50
    collection_order: custom
    sync_mode: sync