# MdbList Builders

You can find items using the features of [MdbList.com](https://mdblist.com/) (MdbList).

| Attribute                       | Description                                                               | Works with Movies | Works with Shows | Works with Playlists and Custom Sort |
|:--------------------------------|:--------------------------------------------------------------------------|:-----------------:|:----------------:|:------------------------------------:|
| [`mdblist_list`](#mdblist-list) | Gets every movie/show in a [MdbList List](https://mdblist.com/toplists/). |      ✅      |     ✅      |               ✅                |

## MdbList List

Finds every item in a [MdbList List](https://mdblist.com/toplists/).

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.

```yaml
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`.

```yaml
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 `score.desc`.

### Sort Options

| Option                                  | Description              |
|:----------------------------------------|:-------------------------|
| `score.asc`<br>`score.desc`             | Sort by MdbList Score    |
| `released.asc`<br>`released.desc`       | Sort by Release Date     |
| `imdbrating.asc`<br>`imdbrating.desc`   | Sort by IMDb Rating      |
| `imdbvotes.asc`<br>`imdbvotes.desc`     | Sort by IMDb Votes       |
| `imdbpopular.asc`<br>`imdbpopular.desc` | Sort by IMDb Popular     |
| `tmdbpopular.asc`<br>`tmdbpopular.desc` | Sort by TMDb Popular     |
| `rogerebert.asc`<br>`rogerebert.desc`   | Sort by RogerEvert Score |
| `budget.asc`<br>`budget.desc`           | Sort by Budget           |
| `revenue.asc`<br>`revenue.desc`         | Sort by Revenue          |
| `added.asc`<br>`added.desc`             | Sort by Date Added       |

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

```yaml
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
```