Skip to content

MDBList Builders

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

Builder Description Works with Movies Works with Shows Works with Playlists and Custom Sort
mdblist_list Gets every movie/show in a MDBList List.
Note on mdb sources

MDBList is not a live reflection of third-party sites such as CommonSense and Trakt. The data on MDBList is often days, weeks and months out of date as it is only periodically refreshed. As such, the data that Kometa fetches and applies from MDBList may not be the same as you see if you visit those third-party sources directly.

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 Setting are recommended since the lists are continuously updated and in a specific order.

Example MDBList List Builder(s)

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.

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

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
releasedigital.asc
releasedigital.desc
Sort by Digital 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 RogerEbert Score
rtomatoes.asc
rtomatoes.desc
Sort by Rotten Tomatoes Score
rtaudience.asc
rtaudience.desc
Sort by Rotten Tomatoes Audience Score
metacritic.asc
metacritic.desc
Sort by Metacritic Score
myanimelist.asc
myanimelist.desc
Sort by MyAnimeList Score
letterrating.asc
letterrating.desc
Sort by Letterboxd Rating
lettervotes.asc
lettervotes.desc
Sort by Letterboxd Votes
last_air_date.asc
last_air_date.desc
Sort by Last Air Date
watched.asc
watched.desc
Sort by Last Watched Date
rating.asc
rating.desc
Sort by Users Rating
download.asc
download.desc
Sort by Downloaded
usort.asc
usort.desc
Sort by User Sort
added.asc
added.desc
Sort by Date Added
runtime.asc
runtime.desc
Sort by Runtime
budget.asc
budget.desc
Sort by Budget
revenue.asc
revenue.desc
Sort by Revenue
title.asc
title.desc
Sort by Title
random.asc
random.desc
Sort by Random (Randomized Daily)

Example MDBList List Builder(s) with Sort Option

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