MDBList Builders¶

Collect movies and shows from MDBList lists or its JustWatch streaming charts.

Choose a builder¶

Use collection_order: custom to retain the returned order and sync_mode: sync to keep collection membership synchronized as the source changes.

Lists¶

mdblist_list accepts a full MDBList list URL, or a dictionary with the options below. For multiple sources, use a YAML list; a comma-separated string will not work.

For episode lists, set builder_level: episode to create an episode collection. In mixed movie/show playlists, MDBList uses its unified endpoint: the response order is preserved, including any interleaving of movies and shows, without grouping by type.

collections:
  Top Watched Movies of the Week:
    mdblist_list: https://mdblist.com/lists/linaspurinis/top-watched-movies-of-the-week
    collection_order: custom
    sync_mode: sync

collections:
  Top 10 Weekly Picks by IMDb Rating:
    mdblist_list:
      url: https://mdblist.com/lists/linaspurinis/top-watched-movies-of-the-week
      limit: 10
      sort_by: imdbrating.desc
    collection_order: custom
    sync_mode: sync

collections:
  Combined MDBList Picks:
    mdblist_list:
      - https://mdblist.com/lists/linaspurinis/top-watched-movies-of-the-week
      - https://mdblist.com/lists/your_username/your-list
    collection_order: custom
    sync_mode: sync

Sort options¶

Append .asc for ascending or .desc for descending order, such as imdbrating.desc. If omitted, the source list's saved order is used. Set collection_order: custom for the returned order to be reflected in Plex.

External lists¶

External MDBList lists mirror lists from another site. For example, https://mdblist.com/lists/chazlarson/external/2868 mirrors https://imdb.com/list/ls089009459.

An external list is accessible when either:

• The owner of your MDBList API key also owns the external list.
• The external list's owner has unchecked Make your external lists private in their account settings.

This example follows the mirrored Esquire list, provided one of those access conditions is met. External lists do not support the usort or added sort fields.

collections:
  Esquire 60 Scariest Movies of All Time:
    mdblist_list: https://mdblist.com/lists/chazlarson/external/2868
    collection_order: custom
    sync_mode: sync

Watchlists¶

mdblist_watchlist: true fetches the authenticated MDBList user's watchlist. The active library determines whether the movie or show endpoint is queried. Use collection_order: custom to preserve the watchlist order and sync_mode: sync to remove items no longer on the watchlist.

collections:
  MDBList Watchlist:
    mdblist_watchlist: true
    collection_order: custom
    sync_mode: sync

Streaming charts¶

mdblist_streaming selects entries from MDBList's JustWatch streaming chart. The library type determines whether it requests movies or shows. Playlists are not supported because they have no single media type.

Use a dictionary of options, or {} for the defaults. Values are case-insensitive; use a code or displayed name, and country values also accept a locale.

collections:
  Daily Streaming Picks:
    mdblist_streaming: {}
    collection_order: custom
    sync_mode: sync

collections:
  Weekly Netflix Action Shows:
    mdblist_streaming:
      country: United Kingdom
      period: 7
      provider: Netflix
      genre: Action
    collection_order: custom
    sync_mode: sync

collections:
  Weekly Netflix Action Picks:
    mdblist_streaming:
      country: en_GB
      period: 7d
      provider: nfx
      genre: act
    collection_order: custom
    sync_mode: sync

Streaming values¶