You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
110 lines
5.9 KiB
110 lines
5.9 KiB
# 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 and poster with the TVDb list metadata | ✅ | ✅ | ✅ |
|
|
| [`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 and poster 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
|
|
``` |