Plex-Meta-Manager/docs/metadata/builders/tvdb.md
2022-03-08 03:06:22 -05:00

110 lines
No EOL
5.8 KiB
Markdown

# TVDb Builders
You can find items using the features of [TheTVDb.com](https://www.thetvdb.com/) (TVDb).
No configuration is required for these builders.
| Attribute | Description | Works with Movies | Works with Shows | Works with Playlists and Custom Sort |
|:------------------------------------|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|:-----------------:|:----------------:|:------------------------------------:|
| [`tvdb_list`](#tvdb-list) | Finds every item in a [TVDb List](https://www.thetvdb.com/lists) or [TVDb Userlist](https://www.thetvdb.com/lists/custom) | ✅ | ✅ | ✅ |
| [`tvdb_list_details`](#tvdb-list) | Finds every item in a [TVDb List](https://www.thetvdb.com/lists) or [TVDb Userlist](https://www.thetvdb.com/lists/custom) and updates the collection summary with the TVDb list description | ✅ | ✅ | ✅ |
| [`tvdb_show`](#tvdb-show) | Finds the series specified | ❌ | ✅ | ❌ |
| [`tvdb_show_details`](#tvdb-show) | Finds the series specified and updates the collection with the summary, poster, and background from the TVDb series | ❌ | ✅ | ❌ |
| [`tvdb_movie`](#tvdb-movie) | Finds the movie specified | ✅ | ❌ | ❌ |
| [`tvdb_movie_details`](#tvdb-movie) | Finds the movie specified and updates the collection with the summary, poster, and background from the TVDb movie | ✅ | ❌ | ❌ |
## TVDb List
Finds every item in a [TVDb List](https://www.thetvdb.com/lists) or [TVDb Userlist](https://www.thetvdb.com/lists/custom)
The expected input is a TVDb List URL or TVDb Userlist 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.
```yaml
collections:
Arrowverse:
tvdb_list: https://www.thetvdb.com/lists/arrowverse
collection_order: custom
sync_mode: sync
```
```yaml
collections:
Saved by the Bell:
tvdb_list: https://www.thetvdb.com/lists/6957
collection_order: custom
sync_mode: sync
```
* You can update the collection details with the TVDb list's description by using `tvdb_list_details`.
* You can specify multiple lists in `tvdb_list_details` but it will only use the first one to update the collection details.
```yaml
collections:
Arrowverse:
tvdb_list_details: https://www.thetvdb.com/lists/arrowverse
collection_order: custom
sync_mode: sync
```
## TVDb Show
Finds the show specified
The expected input is a TVDb Series ID or TVDb Series URL. Multiple values are supported as either a list or a comma-separated string.
```yaml
collections:
Star Wars (Animated Shows):
tvdb_show: 83268, 283468
```
```yaml
collections:
Star Wars (Animated Shows):
tvdb_show:
- https://www.thetvdb.com/series/star-wars-the-clone-wars
- https://www.thetvdb.com/series/star-wars-rebels
```
* You can update the collection details with the TVDb show's summary, poster, and background by using `tvdb_show_details`.
* You can specify multiple shows in `tvdb_show_details` but it will only use the first one to update the collection details.
* Posters and background in the library's asset directory will be used over the collection details unless `tvdb_poster`/`tvdb_background` is also specified.
```yaml
collections:
Star Wars (Animated Shows):
tvdb_show_details: 83268, 283468
```
## TVDb Movie
Finds the movie specified
The expected input is a TVDb Movie ID or TVDb Movie URL. Multiple values are supported as either a list or a comma-separated string.
```yaml
collections:
The Lord of the Rings:
tvdb_movie: 107, 157, 74
```
```yaml
collections:
The Lord of the Rings:
tvdb_movie:
- https://www.thetvdb.com/movies/the-lord-of-the-rings-the-fellowship-of-the-ring
- https://www.thetvdb.com/movies/the-lord-of-the-rings-the-two-towers
- https://www.thetvdb.com/movies/the-lord-of-the-rings-the-return-of-the-king
```
* You can update the collection details with the TVDb movie's summary, poster, and background by using `tvdb_movie_details`.
* You can specify multiple movies in `tvdb_movie_details` but it will only use the first one to update the collection details.
* Posters and background in the library's asset directory will be used over the collection details unless `tvdb_poster`/`tvdb_background` is also specified.
```yaml
collections:
The Lord of the Rings:
tvdb_movie_details:
- https://www.thetvdb.com/movies/the-lord-of-the-rings-the-fellowship-of-the-ring
- https://www.thetvdb.com/movies/the-lord-of-the-rings-the-two-towers
- https://www.thetvdb.com/movies/the-lord-of-the-rings-the-return-of-the-king
```