mirror of
https://github.com/meisnate12/Plex-Meta-Manager
synced 2024-12-23 11:23:06 +00:00
58 lines
No EOL
3.3 KiB
Markdown
58 lines
No EOL
3.3 KiB
Markdown
# Letterboxd Builders
|
||
|
||
You can find items using the lists on [Letterboxd.com](https://letterboxd.com/) (Letterboxd).
|
||
|
||
No configuration is required for these builders.
|
||
|
||
| Attribute | Description | Works with Movies | Works with Shows | Works with Playlists and Custom Sort |
|
||
|:----------------------------------------------|:----------------------------------------------------------------------------------------------------------------|:-----------------:|:-----------------:|:------------------------------------:|
|
||
| [`letterboxd_list`](#letterboxd-list) | Finds every movie in the Letterboxd List | ✅ | ❌ | ✅ |
|
||
| [`letterboxd_list_details`](#letterboxd-list) | Finds every movie in the Letterboxd List and updates the collection with the description of the Letterboxd list | ✅ | ❌ | ✅ |
|
||
|
||
## Letterboxd List
|
||
|
||
Finds every movie in the Letterboxd List or [Letterboxd Films Search](https://letterboxd.com/films/).
|
||
|
||
The expected input is a Letterboxd List URL or Letterboxd Film Search URL. Multiple values are supported as either a list or a comma-separated string.
|
||
|
||
The `sync_mode: sync` and `collection_order: custom` Details are recommended since the lists are continuously updated and in a specific order.
|
||
|
||
Using the `limit` filter attribute is recommended when using a Letterboxd Film Search as the number of results returned could be very large.
|
||
|
||
```yaml
|
||
collections:
|
||
Vulture’s 101 Best Movie Endings:
|
||
letterboxd_list: https://letterboxd.com/brianformo/list/vultures-101-best-movie-endings/
|
||
collection_order: custom
|
||
sync_mode: sync
|
||
```
|
||
|
||
* You can update the collection details with the Letterboxd List's description by using `letterboxd_list_details`.
|
||
* You can specify multiple collections in `letterboxd_list_details` but it will only use the first one to update the collection summary.
|
||
|
||
```yaml
|
||
collections:
|
||
Vulture’s 101 Best Movie Endings:
|
||
letterboxd_list_details: https://letterboxd.com/brianformo/list/vultures-101-best-movie-endings/
|
||
collection_order: custom
|
||
sync_mode: sync
|
||
```
|
||
|
||
You can add different filters directly to this builder.
|
||
|
||
| Filter Attribute | Description |
|
||
|:-----------------|:---------------------------------------------------------------------------------------------------|
|
||
| `limit` | **Description:** Max number of items per returned<br>**Values:** number greater than `1` |
|
||
| `rating` | **Description:** Search for the specified rating range<br>**Values:** range of int i.e. `80-100` |
|
||
| `year` | **Description:** Search for the specified year range<br>**Values:** range of int i.e. `1990-1999` |
|
||
| `note` | **Description:** Search for the specified value in the note<br>**Values:** Any String |
|
||
|
||
```yaml
|
||
collections:
|
||
Vulture’s 101 Best Movie Endings From the 90s:
|
||
letterboxd_list_details:
|
||
url: https://letterboxd.com/brianformo/list/vultures-101-best-movie-endings/
|
||
year: 1990-1999
|
||
collection_order: custom
|
||
sync_mode: sync
|
||
``` |