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.
200 lines
8.3 KiB
200 lines
8.3 KiB
# Collection Files
|
|
|
|
Collection Files holds information on how Kometa should create collections. There are a large number of
|
|
builders available to build collections,
|
|
|
|
## Overview
|
|
|
|
This is a basic Collections File which contains the structure to build a collection called "Top 50 Grossing Films of All
|
|
Time (Worldwide)"
|
|
|
|
The collection order is set to be the same as is received from the source list, and items added/removed from the source
|
|
list will be added/removed from the collection in the Plex library.
|
|
|
|
???+ example "Example "MyCollections.yml""
|
|
|
|
Click the :fontawesome-solid-circle-plus: icon to learn more
|
|
|
|
```yaml
|
|
collections: #(1)!
|
|
Top 50 Grossing Films of All Time (Worldwide):
|
|
tmdb_list: 10 #(2)!
|
|
collection_order: custom #(3)!
|
|
sync_mode: sync #(4)!
|
|
```
|
|
|
|
1. This must appear once and **only once** in any Metadata file
|
|
2. This creates a collection based on tmdb list ID 10, https://www.themoviedb.org/list/10 would also be accepted
|
|
3. This will sort the items in the Plex collection to be the same as the order in the list
|
|
4. Syncs the collection to the list, so that if an item is added/removed from the list, the same is done to the
|
|
collection. Set this to `append` if you only want it to add things and not remove them.
|
|
|
|
For the purpose of this example, we are going to save the File as `MyCollections.yml` within the location mapped as
|
|
`config` in our setup.
|
|
|
|
I then call "MyCollections.yml" in my [Configuration File](../config/overview.md) within the `collection_files` section
|
|
|
|
???+ example "config.yml Example Collection File Addition"
|
|
|
|
Click the :fontawesome-solid-circle-plus: icon to learn more
|
|
|
|
```yaml
|
|
libraries:
|
|
Movies: #(1)!
|
|
collection_files:
|
|
- file: config/MyCollections.yml #(2)!
|
|
```
|
|
|
|
1. This must match the name of a library in your Plex server
|
|
2. `config` refers to the location that you mapped to `config` when following the Kometa Installation Guides.
|
|
|
|
Whenever I execute Kometa and the Movies library is run, MyCollections.yml will run and my "Top 50 Grossing Films of
|
|
All Time (Worldwide)" will be created/updated.
|
|
|
|
## File Attributes
|
|
|
|
Collection Files can utilize the following top-level attributes
|
|
|
|
| Attribute | Description |
|
|
|:--------------------------------------------------------|:--------------------------------------------------------------------------------------------------------------------------|
|
|
| [`templates`](templates.md) | contains definitions of templates that can be leveraged by multiple collections |
|
|
| [`external_templates`](templates.md) | contains [file blocks](../config/files.md) that point to external templates that can be leveraged by multiple collections |
|
|
| [`collections`](#collection-operations-attributes) | contains definitions of collections you wish to add to one or more libraries |
|
|
| [`dynamic_collections`](#dynamic-collections) | contains definitions of [dynamic collections](dynamic.md) you wish to create |
|
|
|
|
* One of `metadata`, `collections` or `dynamic_collections` must be present for the File to run, else you will receive
|
|
an error when trying to run the file against your library.
|
|
|
|
* Example Files can be found in the
|
|
[Kometa Community Configs Repository](https://github.com/Kometa-Team/Community-Configs)
|
|
|
|
## Collection Operations & Attributes
|
|
|
|
Whilst [Library Operations](../config/operations.md) are used to control library-wide operations, Collection Files can
|
|
be used as a method to perform more limited operations, such as:
|
|
|
|
* Syncing collections with the source list if one is used (such as Trakt Lists, TMDb Lists, etc.)
|
|
|
|
* Sending missing media to Sonarr/Radarr
|
|
|
|
* Adding labels to items in collections
|
|
|
|
* Showing and Hiding collections at set intervals (i.e. show Christmas collections in December only)
|
|
|
|
These operations can be performed without the need to physically build a collection (using the `build_collection: false`
|
|
attribute)
|
|
|
|
Examples of these can be seen here
|
|
|
|
???+ example "Examples of Collection Operations"
|
|
|
|
Click the :fontawesome-solid-circle-plus: icon to learn more
|
|
|
|
=== "Example 1 - Sync Collection to List"
|
|
|
|
```yaml
|
|
collections:
|
|
Christmas Extravaganza:
|
|
trakt_list: https://trakt.tv/users/k0meta/lists/christmas-extravaganza-non-tv-movie #(1)!
|
|
sync_mode: append #(2!)
|
|
collection_order: custom #(3)!
|
|
```
|
|
|
|
1. This is a Trakt List builder, telling Kometa to build a collection based on the items in this list
|
|
2. If items are removed from the source list, having sync mode set to `append` means they will not be removed
|
|
from the collection in Plex. Set this to `sync` if you want the items removed in the collection too
|
|
3. Sort the collection in the order that it is received from the Trakt list
|
|
|
|
=== "Example 2 - Send to Arr"
|
|
|
|
```yaml
|
|
collections:
|
|
IMDb Top 250:
|
|
imdb_chart: top_movies
|
|
collection_order: custom #(1)!
|
|
radarr_add_missing: true #(2)!
|
|
```
|
|
|
|
1. Sorts the collection in the same order as is received by the source list
|
|
2. Sends items that are in the source list but are not in your Plex library to Radarr. Replace with
|
|
`sonarr_add_missing` for any show-based builder.
|
|
|
|
=== "Example 3 - Add labels"
|
|
|
|
```yaml
|
|
collections:
|
|
Radarr Tags:
|
|
build_collection: false #(1)!
|
|
radarr_taglist: mytag #(2)!
|
|
item_label: myplextag #(3)!
|
|
```
|
|
|
|
1. Tells Kometa to not physically build a collection, but it will still perform the actions of the collection
|
|
2. Find all items in Radarr that have the tag `mytag`
|
|
3. For each of the items with `mytag` in Radarr, apply the `myplextag` to the items in the Plex library
|
|
|
|
=== "Example 4 - Schedule Collection"
|
|
|
|
```yaml
|
|
collections:
|
|
Christmas Extravaganza:
|
|
trakt_list: https://trakt.tv/users/k0meta/lists/christmas-extravaganza-non-tv-movie #(1)!
|
|
schedule: range(12/01-12/31) #(2)!
|
|
delete_not_scheduled: true #(3)!
|
|
```
|
|
|
|
1. Tells Kometa to not physically build a collection, but it will still perform the actions of the collection
|
|
2. Only run this collection from December 1st through December 31st
|
|
3. If today is not part of the above scheduled range, delete the Christmas Extravaganza collection if it exists
|
|
in the Plex library
|
|
|
|
There are multiple types of attributes that can be utilized within a collection:
|
|
|
|
* [Builders](builders/overview.md)
|
|
* [Filters](filters.md)
|
|
* [Settings](settings.md)
|
|
* [Radarr/Sonarr Settings](settings.md)
|
|
* [Collection/Playlist Metadata Updates](updates.md)
|
|
* [Item Metadata Updates](item_updates.md)
|
|
|
|
## Example File
|
|
|
|
Below is a common Collection File which will create two collections in a Plex library.
|
|
|
|
It will sync the collections to the source lists, order them randomly, and apply a summary to the collection.
|
|
|
|
```yaml
|
|
collections:
|
|
Trending:
|
|
trakt_trending: 10
|
|
tmdb_trending_daily: 10
|
|
tmdb_trending_weekly: 10
|
|
sort_title: +1_Trending
|
|
sync_mode: sync
|
|
smart_label: random
|
|
summary: Movies Trending across the internet
|
|
Popular:
|
|
tmdb_popular: 40
|
|
imdb_search:
|
|
type: movie, tv_movie
|
|
limit: 40
|
|
sort_title: +2_Popular
|
|
sync_mode: sync
|
|
smart_label: random
|
|
summary: Popular Movies across the internet
|
|
```
|
|
|
|
## Dynamic Collections
|
|
|
|
In addition to manually defining each Collection that you want in your library, Kometa can also dynamically
|
|
create collections based on a variety of different criteria, such as
|
|
|
|
* Collections for the top `X` popular people on TMDb (Bruce Willis, Tom Hanks etc.)
|
|
|
|
* Collections for each decade represented in the library (Best of 1990s, Best of 2000s etc.)
|
|
|
|
* Collections for each of the moods/styles within a Music library (A Cappella, Pop Rock etc.)
|
|
|
|
* Collections for each of a Trakt Users Lists.
|
|
|
|
A full list of the available options is available on the [Dynamic Collections](dynamic.md) page |