Plex-Meta-Manager/docs/metadata/builders/mdblist.md

MdbList Builders

You can find items using the features of MdbList.com (MdbList).

Attribute	Description	Works with Movies	Works with Shows	Works with Playlists and Custom Sort
mdblist_list	Gets every movie/show in a MdbList List.	✅	✅	✅

MdbList List

Finds every item in a MdbList List.

The expected input is an MdbList List URL. Multiple values are supported as a list only a comma-separated string will not work.

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

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

You can also limit the number of items to search for by using the limit and url attributes under mdblist_list.

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

You can also sort the items by using the sort_by and url attributes under mdblist_list.

The default sort_by when it's not specified is rank.asc.

Sort Options

Option	Description
rank.asc rank.desc	Sort by MdbList Rank
score.asc score.desc	Sort by MdbList Score
score_average.asc score_average.desc	Sort by MdbList Average Score
released.asc released.desc	Sort by Release Date
imdbrating.asc imdbrating.desc	Sort by IMDb Rating
imdbvotes.asc imdbvotes.desc	Sort by IMDb Votes
imdbpopular.asc imdbpopular.desc	Sort by IMDb Popular
tmdbpopular.asc tmdbpopular.desc	Sort by TMDb Popular
rogerebert.asc rogerebert.desc	Sort by RogerEvert Score
rtomatoes.asc rtomatoes.desc	Sort by Rotten Tomatoes Score
metacritic.asc metacritic.desc	Sort by Metacritic Score
myanimelist.asc myanimelist.desc	Sort by MyAnimeList Score
budget.asc budget.desc	Sort by Budget
revenue.asc revenue.desc	Sort by Revenue
added.asc added.desc	Sort by Date Added

For these sorts to be reflected in your collection you must use collection_order: custom.

collections:
  Top 10 Movies of The Week:
    mdblist_list: 
      url: https://mdblist.com/lists/linaspurinis/top-watched-movies-of-the-week
      sort_by: imdbrating.desc
    collection_order: custom
    sync_mode: sync