### Main config.yml - Full Annotated Example

Source: https://context7.com/kometa-team/community-configs/llms.txt

This example demonstrates a comprehensive `config.yml` setup, including library-specific configurations for movies and TV shows, overlay definitions, collection file references, asset directories, and global settings. It shows how to configure operations, metadata updates, collection building, and overlay application for different libraries.

```yaml
# config.yml — full annotated example (BSM-Elf style)
libraries:
  Movies:
    run_order:
      - operations   # bulk metadata updates (ratings, posters, etc.)
      - metadata     # item-level metadata edits
      - collections  # build/sync collection lists
      - overlays     # apply image overlays to posters
    remove_overlays: false
    overlay_files:
      - default: resolution            # built-in PMM resolution overlay
        template_variables:
          horizontal_offset: 50
          horizontal_align: left
          vertical_offset: 50
          vertical_align: top
          back_color: '#00000000'
          back_height: 50
      - default: audio_codec           # built-in audio codec overlay
        template_variables:
          horizontal_offset: 50
          horizontal_align: right
          vertical_offset: 50
          vertical_align: top
          back_color: '#00000000'
          back_height: 50
    collection_files:
      - default: franchise             # built-in franchise/saga collections
        template_variables:
          build_collection: true
          sync_mode: append
          collection_mode: hide
          minimum_items: 2
      - config/kometa/metadata/awards.yml
      - config/kometa/metadata/genres.yml
    settings:
      asset_directory:
        - config/kometa/assets/movies
        - config/kometa/assets/awards
    operations:
      mass_critic_rating_update: mdb
      mass_audience_rating_update: imdb
      delete_collections:
        configured: false
        managed: false
        less: 2             # remove collections with fewer than 2 items

  TV Shows:
    run_order: [operations, metadata, collections, overlays]
    remove_overlays: false
    overlay_files:
      - default: network               # network logo overlays for TV
        template_variables:
          vertical_align: bottom
          vertical_offset: 15
          horizontal_align: left
          horizontal_offset: 15
    collection_files:
      - config/kometa/metadata/networks.yml

# Global settings
settings:
  cache: true
  cache_expiration: 60
  asset_folders: true
  asset_depth: 3
  create_asset_folders: true
  dimensional_asset_rename: true
  download_url_assets: true
  sync_mode: append
  minimum_items: 2
  run_order: [operations, metadata, collections, overlays]
  overlay_artwork_filetype: jpg
  overlay_artwork_quality: 75
  verify_ssl: true

```

--------------------------------

### Plex Configuration Example

Source: https://github.com/kometa-team/community-configs/blob/master/ricoloic/README.md

Configure Plex integration by providing the URL, token, and other relevant settings in your config.yml file.

```yaml
plex:
  url: http://192.168.1.12:32400
  token: ####################
  timeout: 60
  db_cache:
  clean_bundles: false
  empty_trash: false
  optimize: false
  verify_ssl:
```

--------------------------------

### Run Plex-Meta-Manager

Source: https://github.com/kometa-team/community-configs/blob/master/cptneptun/README.md

Execute this command to run Plex-Meta-Manager after setup. The -r flag is used for re-running.

```bash
python plex_meta_manager.py -r
```

--------------------------------

### Service Connection Configurations

Source: https://context7.com/kometa-team/community-configs/llms.txt

Configuration examples for connecting to various media services. Ensure you replace placeholder tokens and API keys with your actual credentials.

```yaml
plex:
  url: http://plex:32400
  token: YOUR_PLEX_TOKEN
  timeout: 900
  clean_bundles: true
  empty_trash: false
  optimize: true

tmdb:
  apikey: YOUR_TMDB_API_KEY
  language: en
  cache_expiration: 60

trakt:
  client_id: YOUR_TRAKT_CLIENT_ID
  client_secret: YOUR_TRAKT_CLIENT_SECRET
  pin:

mdblist:
  apikey: YOUR_MDBLIST_API_KEY
  cache_expiration: 60

radarr:
  url: http://radarr:7878
  token: YOUR_RADARR_TOKEN
  add_missing: false
  root_folder_path: /storage/movies
  quality_profile: HD-1080p
  tag: kometa
  search: false

sonarr:
  url: http://sonarr:8989
  token: YOUR_SONARR_TOKEN
  add_missing: false
  root_folder_path: /storage/series
  quality_profile: HD-1080p
  language_profile: Original
  series_type: standard
  season_folder: true
  tag: kometa
```

--------------------------------

### TrakT Configuration Example

Source: https://github.com/kometa-team/community-configs/blob/master/ricoloic/README.md

Configure TrakT service by filling in your client ID, client secret, and authorization details in config.yml.

```yaml
trakt:
  client_id: ####################
  client_secret: ####################
  pin:
  authorization:
    access_token:
    token_type:
    expires_in:
    refresh_token:
    scope: public
    created_at:
```

--------------------------------

### My Anime List (MAL) Configuration Example

Source: https://github.com/kometa-team/community-configs/blob/master/ricoloic/README.md

Integrate with My Anime List by providing your client ID, client secret, and authorization token information in config.yml.

```yaml
mal:
  client_id: ####################
  client_secret: ####################
  authorization:
    access_token:
    token_type:
    expires_in:
    refresh_token:
```

--------------------------------

### TMDB Configuration Example

Source: https://github.com/kometa-team/community-configs/blob/master/ricoloic/README.md

Set up TMDB API integration by specifying your API key, language, and cache expiration in config.yml.

```yaml
tmdb:
  apikey: ################################
  language: en
  cache_expiration: 60
  region:
```

--------------------------------

### Subsequent Kometa Runs (Docker)

Source: https://github.com/kometa-team/community-configs/blob/master/0x5f3/README.md

After the initial setup, use this command for regular, background operation. It runs Kometa in detached mode.

```bash
docker run --rm -d -v ./config:/config kometateam/kometa:nightly --config config/config.yml --run
```

--------------------------------

### Example Configuration for Media Library Language Overlays

Source: https://github.com/kometa-team/community-configs/blob/master/cpt-kuesel/README.md

This YAML configuration defines language preferences for Movies, Shows, and Anime libraries. It uses anchors and aliases to manage language selections and specifies overlay paths, including template variables for different overlay levels.

```yaml
x-movie_languages: &movie_languages
  use_german: true
  use_english: true
  use_french: true
  use_japanese: true
  use_korean: true
  use_chinese: true
  use_danish: true
  use_russian: true
  use_spanish: true
  use_italian: true
  use_portuguese: true
  use_hindi: true
  use_telugu: true
  use_dutch: true
  use_icelandic: true
  use_turkish: true
  use_ukranian: true
x-show_languages: &show_languages
  use_german: true
  use_english: true
  use_french: true
  use_korean: true
  use_spanish: true
x-anime_languages: &anime_languages
  use_german: true
  use_english: true
  use_french: true
  use_japanese: true
  use_korean: true
  use_spanish: true
  use_italian: true
  use_portuguese: true
  use_thai: true

libraries:
  Movies:
    metadata_path:
      - file: metadata/admin/core
      - file: metadata/movies/metadata
      - file: metadata/movies/Collections
      - file: metadata/movies/Suggestions
    overlay_path:
      - remove_overlays: false
      - file: overlays/admin/queues
      - file: overlays/flags
        template_variables:
          <<: *movie_languages
    settings:
      asset_directory:
        - assets/movies/collections
        - assets/movies/movies
    operations:
      split_duplicates: true
  Shows:
    metadata_path:
      - file: metadata/admin/core
      - file: metadata/shows/metadata
    overlay_path:
      - remove_overlays: false
      - file: overlays/admin/queues
      - file: overlays/flags
        template_variables:
          <<: *show_languages
          overlay_level: episode
      - file: overlays/flags
        template_variables:
          <<: *show_languages
          overlay_level: season
      - file: overlays/flags
        template_variables:
          <<: *show_languages
    settings:
      asset_directory:
        - assets/shows/collections
        - assets/shows/shows
  Anime:
    metadata_path:
      - file: metadata/admin/core
      - file: metadata/animes/metadata
    overlay_path:
      - remove_overlays: false
      - file: overlays/admin/queues
      - file: overlays/flags
        template_variables:
          <<: *anime_languages
          overlay_level: episode
      - file: overlays/flags
        template_variables:
          <<: *anime_languages
          overlay_level: season
      - file: overlays/flags
        template_variables:
          <<: *anime_languages
    settings:
      asset_directory:
        - assets/animes/collections
        - assets/animes/animes

```

--------------------------------

### Kometa Collection Scheduling and Visibility

Source: https://context7.com/kometa-team/community-configs/llms.txt

Examples of configuring collection schedules and visibility settings. This demonstrates how to set daily, weekly, seasonal, and complex multi-criteria schedules, along with visibility controls for library, home, and shared views.

```yaml
# Scheduling and visibility patterns (nwithan8 tips_and_tricks pattern)
collections:
  # Always-on chart collection — updated daily
  "Trending Now":
    schedule: daily
    visible_library: true
    visible_home: true
    visible_shared: true
    sort_title: "+010_Trending"

  # Weekly update — reduced load for stable data
  "Top Rated of 2023":
    schedule: weekly(thursday)
    visible_library: false

  # Seasonal — appears only during window, hidden (and optionally deleted) outside it
  "Halloween Movies":
    schedule: range(10/29-10/31)
    visible_shared: range(10/01-10/31)    # visible on shared Home a month early
    delete_not_scheduled: true            # remove from Plex when not scheduled

  # Complex multi-criteria schedule for award season
  "Oscar Best Picture":
    schedule: yearly(01/23), all[weekly(friday), range(01/23-03/15)], yearly(03/16)
    # Fires on nomination day, then every Friday through ceremony, then on ceremony day

  # Sort title prefix system for library ordering
  "Popular in Action":
    sort_title: "+110_Popular in Action"  # 110 category, + level, then alpha
  "Top Rated of the 2010s":
    sort_title: "+090_R_Top Rated of the 2010s"  # R = ordering within decade group
```

--------------------------------

### Configure Content Rating Overlays

Source: https://github.com/kometa-team/community-configs/blob/master/techdiver/README.md

Add this configuration to your overlay_path to populate content rating overlays for specific regions, using Ireland's Plex ratings as an example.

```yaml
libraries:
  Movies:
    metadata_path:
    - file: config/Movies.yml
    - pmm: basic
    - pmm: studio
    - pmm: genre
    - pmm: actor
    - pmm: seasonal
    - pmm: imdb
      template_variables:
        use_lowest: false
    overlay_path:
    - remove_overlays: false
    - reapply_overlay: true
    - pmm: resolution
      template_variables:
        use_edition: false
        horizontal_align: center
        horizontal_offset: -160
    - pmm: audio_codec
      template_variables:
        horizontal_align: center
        horizontal_offset: 160
    - pmm: ribbon
      template_variables:
        use_common: false
        use_razzie: false
        horizontal_offset: 0
    - pmm: runtimes
      template_variables:
        horizontal_align: center
        back_width: 305
        text: ''
    - file: config/content_rating_ie.yml
```

--------------------------------

### Custom Poster Generation Script

Source: https://github.com/kometa-team/community-configs/blob/master/nwithan8/tips_and_tricks.md

Example command for generating placeholder posters using a PowerShell script. Adjust parameters like base color, gradient, font, font size, and text as needed.

```powershell
./create_poster.ps1 -clean 1 -base_color "#5B5B5B" -gradient "1" -font "Comfortaa-Bold" -font_size "200" -text "NETWORKS"
```

--------------------------------

### Docker Compose Deployment for Kometa

Source: https://context7.com/kometa-team/community-configs/llms.txt

A typical Docker Compose setup for deploying Kometa. This configuration includes volume mounts for persistent data and environment variables for scheduling.

```yaml
version: "3.8"
services:
  kometa:
    image: meisnate12/plex-meta-manager:latest
    container_name: kometa
    volumes:
      - /docker/appdata/kometa/config:/config:rw
      - /docker/appdata/kometa/assets:/assets:rw
      - /docker/appdata/kometa/metadata:/metadata:rw
      - /docker/appdata/kometa/overlays:/overlays:rw
    environment:
      PMM_TIME: "01:15,07:15,13:15,19:15"   # run 4x daily
    restart: on-failure
```

--------------------------------

### Initial Kometa Population Run (Docker)

Source: https://github.com/kometa-team/community-configs/blob/master/0x5f3/README.md

Run this command for the initial population of collections. It uses a Docker container and ignores schedules to ensure a complete first run.

```bash
docker run --rm -it -v ./config:/config kometateam/kometa:nightly --config config/config.yml --run --ignore-schedules
```

--------------------------------

### Clone Kometa Repository

Source: https://github.com/kometa-team/community-configs/blob/master/0x5f3/README.md

Use this command to clone the Kometa repository, ensuring that all submodules are also initialized.

```bash
git clone --recursive https://github.com/0x5f3/kometa.config config
```

--------------------------------

### Configure Movie and TV Show Overlays

Source: https://context7.com/kometa-team/community-configs/llms.txt

Define overlay files for movies and TV shows, including dynamic templates for resolution and audio codecs. This configuration allows for custom backgrounds and badges on media items.

```yaml
libraries:
  Movies:
    remove_overlays: false
    overlay_files:
      - file: config/kometa/overlays/jmxd/gradient.yml   # gradient bar background
      - default: resolution                               # resolution badge (4K, 1080p, etc.)
        template_variables:
          file: config/kometa/overlays/jmxd/resolution/<<key>><<alt>>.png
          use_resolution: true
          use_edition: false
          horizontal_offset: 50
          horizontal_align: left
          vertical_offset: 50
          vertical_align: top
          back_radius: 0
          back_color: '#00000000'
          back_height: 50
      - default: audio_codec                              # audio codec badge (Atmos, DTS-X, etc.)
        template_variables:
          file: config/kometa/overlays/jmxd/audio_codec/<<key>>.png
          horizontal_offset: 50
          horizontal_align: right
          vertical_offset: 50
          vertical_align: top
          back_color: '#00000000'
          back_height: 50

  TV Shows:
    remove_overlays: false
    overlay_files:
      - default: network                                  # network logo (bottom-left)
        template_variables:
          vertical_align: bottom
          vertical_offset: 15
          horizontal_align: left
          horizontal_offset: 15
```

--------------------------------

### Clone PMM Config Repository

Source: https://github.com/kometa-team/community-configs/blob/master/cptneptun/README.md

Use this command to clone the repository containing the PMM configuration files.

```bash
git clone https://github.com/itsFelixH/pmm-config
```

--------------------------------

### Define Overlay Variables and Defaults

Source: https://github.com/kometa-team/community-configs/blob/master/techdiver/README.md

These variables and their default values can be used to customize overlay appearance and file paths. Ensure the 'file' path correctly references your overlay images.

```yaml
horizontal_offset: 15
horizontal_align: left
vertical_offset: 20
vertical_align: bottom
back_radius: 0
file: config/overlays/ie<<overlay_name>>.png
```

--------------------------------

### Configure Language Flag Overlays

Source: https://context7.com/kometa-team/community-configs/llms.txt

Apply language flag overlays to movie and show libraries using YAML anchors for efficient configuration. This allows toggling specific language flags for different media types.

```yaml
x-movie_languages: &movie_languages
  use_german: true
  use_english: true
  use_french: true
  use_japanese: true
  use_korean: true
  use_spanish: true

libraries:
  Movies:
    overlay_path:
      - remove_overlays: false
      - file: overlays/admin/queues
      - file: overlays/flags
        template_variables:
          <<: *movie_languages    # YAML anchor expands all language toggles
  Shows:
    overlay_path:
      - file: overlays/flags
        template_variables:
          <<: *movie_languages
          overlay_level: episode  # apply at episode level
      - file: overlays/flags
        template_variables:
          <<: *movie_languages
          overlay_level: season   # apply at season level
      - file: overlays/flags
        template_variables:
          <<: *movie_languages    # apply at show level
```

--------------------------------

### Run Kometa Script

Source: https://github.com/kometa-team/community-configs/blob/master/JJJonesJr33/Plex-Meta-Manager-TV/README.md

Use this command to run the Kometa script. Ensure you are in the correct terminal window for each instance.

```bash
python kometa.py -r
```

--------------------------------

### Configure Movie and TV Show Libraries with Custom Collections

Source: https://github.com/kometa-team/community-configs/blob/master/Adam-Pope/README.md

Add this YAML configuration to your config.yml to define libraries for Movies and TV Shows. It specifies metadata paths for custom collections like continents, regions, and international features, and sets up various overlays for TV shows.

```yaml
libraries:
  Movies:
    metadata_path:
      - git: Adam-Pope/Movies/continents.yml
        template_variables:
          style: color  # defaults to white
          collection_section: "080" # puts continents before regions
      - git: Adam-Pope/Movies/regions.yml
        template_variables:
          style: color  # defaults to white
      - default: country
        template_variables:
          style: color
          collection_section: "!082"
      - git: Adam-Pope/Movies/international_feature.yml

  TV Shows:
    metadata_path:
      - git: Adam-Pope/TV/continents.yml
        template_variables:
          style: color  # defaults to white
          collection_section: "!080" # puts continents before regions
      - git: Adam-Pope/TV/regions.yml
        template_variables:
          style: color  # defaults to white
      - default: country
        template_variables:
          style: color
          collection_section: "!082"

    overlay_path:
      - pmm: resolution     
      - pmm: languages                             
        template_variables:
          horizontal_position: right
          horizontal_offset: 100
          vertical_position: top
          vertical_offset: 35
          style: half
          country_en: uk
          languages:
            - en
            - de
            - fr
            - es
            - pt
            - ja
            - ko
            - zh
            - da
            - ru
            - it
            - hi
            - te
            - fa
            - th
            - nl
            - no
            - is
            - sv
            - tr
            - pl
            - cs
            - uk
            - hu
            - ar
            - bg
            - bn
            - bs
            - ca
            - cy
            - el
            - et
            - eu
            - fi
            - fl
            - gl
            - he
            - hr
            - id
            - ka
            - kk
            - kn
            - la
            - lt
            - lv
            - mk
            - ml
            - mr
            - ms
            - nb
            - nn
            - pa
            - ro
            - sk
            - sl
            - sq
            - sr
            - sw
            - ta
            - ur
            - vi
            - wo
            - myn
            - iu
            - rom
            - su
            - zu
            - am
            - fil
      - pmm: ratings                                  
        template_variables:      
          rating1: critic
          rating1_image: rt_tomato
          rating1_font: config/metadata/overlays/fonts/Adlib.ttf
          rating2: audience  
          rating2_image: imdb
          rating2_font: config/metadata/overlays/fonts/Impact.ttf
          horizontal_position: left
          vertical_position: bottom
          rating_alignment: horizontal
          vertical_offset: 15
          horizontal_offset: 0        
      - pmm: commonsense
        template_variables:
          vertical_align: top
          horizontal_align: center
          vertical_offset: 15
      - pmm: ribbon
```

--------------------------------

### Visibility Options

Source: https://github.com/kometa-team/community-configs/blob/master/nwithan8/tips_and_tricks.md

Control the visibility of collections on the Home, Recommended, and shared tabs. Options include true, false, or a schedule. Ensure playlists are scheduled to update at least one day longer than the visibility timeframe.

```yaml
visible_library: true
visible_home: true
visible_shared: true
```

--------------------------------

### Add BBFC Overlay to config.yml

Source: https://github.com/kometa-team/community-configs/blob/master/holl595/README.md

Integrate the BBFC overlay configuration into your main Plex Meta Manager config.yml file. Ensure the overlay_path points to your bbfc.yml file.

```yaml
libraries:
  Movies:
    overlay_path:
    - file: /config/bbfc.yml
```

--------------------------------

### Scheduling Options

Source: https://github.com/kometa-team/community-configs/blob/master/nwithan8/tips_and_tricks.md

Optimize update frequency for collections and playlists. Supports multiple criteria like weekly, yearly, and date ranges for flexible scheduling.

```yaml
schedule: weekly(wednesday), weekly(sunday)
```

```yaml
schedule: yearly(02/21), all[weekly(friday),range(02/21-03/31)], yearly(04/01)
```

--------------------------------

### Sorting Options for Plex Smart Filters

Source: https://github.com/kometa-team/community-configs/blob/master/nwithan8/tips_and_tricks.md

Replace 'collection_order' with 'sort_by' for Plex smart filters. 'release.desc' for release date, 'title.desc' for alphabetical, and 'random' for random order.

```yaml
smart_filter:
    sort_by: release.desc
    any:
        - criteria1
        - criteria2
```

```yaml
smart_filter:
    sort_by: title.desc
    any:
        - criteria1
        - criteria2
```

```yaml
smart_filter:
    sort_by: random
    any:
        - criteria1
        - criteria2
```

--------------------------------

### Collection Promotion Prefixes

Source: https://github.com/kometa-team/community-configs/blob/master/nwithan8/tips_and_tricks.md

Use sort_title prefixes to control the order of collections in a library. '+' promotes to the top, '~' demotes to the bottom, and numbers/letters organize by category and level.

```yaml
# Prefixes for (Movie) Collections:
#   010_+ = Charts
#   020_+ = Holidays
#   030_+ = Studios or Network
#   040_+ = Genres
#   050_+ = Countries
#   060_+ = Awards
#   070_+ = Collections
#   080_+ = Decades
#   090_+ = People
#   100_+ = General
```

--------------------------------

### Most-Watched Collections via Trakt Charts

Source: https://context7.com/kometa-team/community-configs/llms.txt

Configures collections based on Trakt's 'watched' charts across different time periods (daily, weekly, monthly, yearly). Scheduling is staggered to manage performance.

```yaml
# 030_watched.yml — most-watched collections via Trakt charts
templates:
  trakt:
    collection_mode: hide
    collection_order: custom
    delete_not_scheduled: false
    sort_title: "+030_<<num>>_<<collection_name>>"
    sync_mode: sync
    trakt_list:
      - <<trakt_list_extra_01>>       # up to 20 supplemental Trakt lists
    optional:
      - trakt_list_extra_01

collections:
  "Most Watched Daily":
    url_poster: https://raw.githubusercontent.com/0x5f3/kometa.config/assets/_watched/watched_daily.png
    schedule: daily
    summary: "Movies trending across the internet"
    template: { name: trakt, num: "0" }
    trakt_chart:
      chart: watched
      countries: us, gb, ie, ca, au, nz
      languages: en
      limit: 50
      time_period: daily

  "Most Watched Weekly":
    schedule: daily
    template: { name: trakt, num: "1" }
    trakt_chart:
      chart: watched
      countries: us, gb, ie, ca, au, nz
      languages: en
      limit: 50
      time_period: weekly

  "Most Watched Monthly":
    schedule: weekly(sunday)          # only update once per week
    template: { name: trakt, num: "2" }
    trakt_chart:
      chart: watched
      countries: us, gb, ie, ca, au, nz
      languages: en
      limit: 75
      time_period: monthly

  "Most Watched Yearly":
    schedule: weekly(sunday)
    template: { name: trakt, num: "3" }
    trakt_chart:
      chart: watched
      countries: us, gb, ie, ca, au, nz
      languages: en
      limit: 100
      time_period: yearly
```

--------------------------------

### External Template Import

Source: https://github.com/kometa-team/community-configs/blob/master/nwithan8/tips_and_tricks.md

As of v1.16.4, define templates in an external file and import them using the `external_templates` key for centralized management.

```yaml
external_templates:
    - template_file.yml
```

--------------------------------

### Run PMM with Docker Compose

Source: https://github.com/kometa-team/community-configs/blob/master/cpt-kuesel/README.md

This configuration defines a scheduled PMM service using Docker Compose. It specifies the image, container name, volumes for persistent data, environment variables for scheduling, and restart policy.

```yaml
  pmm_scheduled:
    image: meisnate12/plex-meta-manager:latest
    container_name: pmm_scheduled
    volumes:
      - /docker/appdata/plex-meta-manager/config:/config:rw
      - /docker/appdata/plex-meta-manager/assets:/assets:rw
      - /docker/appdata/plex-meta-manager/metadata:/metadata:rw
      - /docker/appdata/plex-meta-manager/overlays:/overlays:rw
    environment:
      PMM_TIME: "01:15,07:15,13:15,19:15"
    restart: on-failure
```

--------------------------------

### Define Library Metadata Paths in YAML

Source: https://github.com/kometa-team/community-configs/blob/master/Frexe/README.md

Configure metadata paths for libraries like 'Filmer' and 'Serier' using a YAML structure. Specify individual metadata files or entire folders to be scanned.

```yaml
libraries:
  Filmer:
    metadata_path:
    - file: metadata/Movies/Studio.yml
    - file: metadata/Movies/Genre.yml
    - file: metadata/Movies/Lists.yml
    - file: metadata/Movies/Holiday.yml
    - folder: metadata/Movies/Collections
    - folder: metadata/Movies/Metadata/Collections
    - folder: metadata/Movies/Metadata/Movies
    - folder: metadata/Movies/Metadata/Studio
  Serier:
    metadata_path:
    - file: metadata/TV-Shows/Collections.yml
    - folder: metadata/TV-Shows/Metadata/Anime
    - folder: metadata/TV-Shows/Metadata/TV
```

--------------------------------

### Trakt Chart/List Source Template

Source: https://context7.com/kometa-team/community-configs/llms.txt

A template for Trakt chart or list sources. It supports multiple optional Trakt list URLs and specifies collection and sync modes.

```yaml
trakt:
  collection_mode: hide
  delete_not_scheduled: false
  sort_title: "+010_<<num>>_<<collection_name>>"
  sync_mode: sync
  trakt_list:
    - <<trakt_list_extra_01>>
    - <<trakt_list_extra_02>>
  optional:
    - trakt_list_extra_01
    - trakt_list_extra_02
```

--------------------------------

### Configure Movie Operations

Source: https://context7.com/kometa-team/community-configs/llms.txt

Defines bulk metadata operations for movies. Use 'mdb' for critic ratings and content ratings from MDBList, 'imdb' for audience ratings and genre syncing. Set 'item_refresh' to true to refresh Plex metadata for all items. Configure 'delete_collections' to manage collection deletion based on item count.

```yaml
operations:
  assets_for_all: false
  split_duplicates: false
  mass_critic_rating_update: mdb           # set critic rating from MDBList
  mass_audience_rating_update: imdb        # set audience rating from IMDb
  mass_content_rating_update: mdb          # set content rating from MDBList
  mass_genre_update: imdb                  # sync genres from IMDb
  item_refresh: true                       # refresh Plex metadata for all items
  delete_collections:
    configured: false   # don't delete collections defined in config files
    managed: false      # don't delete Kometa-managed collections
    less: 2             # delete any collection with fewer than 2 items
```

--------------------------------

### Configure TV Show Operations

Source: https://context7.com/kometa-team/community-configs/llms.txt

Sets up bulk metadata operations for TV shows. 'schedule: weekly(friday)' ensures operations run only on Fridays. Supports 'mdb_average' for audience ratings, 'mdb_metacritic' for critic ratings, and 'imdb' for user ratings. Configures poster updates from TMDB for seasons.

```yaml
operations:
  schedule: weekly(friday)                 # only run operations on Fridays
  mass_audience_rating_update: mdb_average
  mass_critic_rating_update: mdb_metacritic
  mass_user_rating_update: imdb
  mass_poster_update:
    source: tmdb
    seasons: true
    episodes: false
```

--------------------------------

### MDBList Curated List Template

Source: https://context7.com/kometa-team/community-configs/llms.txt

Template for MDBList curated lists. It allows specifying sorting, list URL, and optional extra parameters.

```yaml
mdblist:
  collection_mode: hide
  collection_order: custom
  sort_title: "+010_<<num>>_<<collection_name>>"
  sync_mode: sync
  mdblist_list:
    sort_by: <<mdblist_sort>>
    url: https://mdblist.com/lists/<<mdblist_user>>/<<mdblist_list>>/
  optional:
    - mdblist_extra_1
```

--------------------------------

### Trending Movies Collection

Source: https://context7.com/kometa-team/community-configs/llms.txt

Sets up a 'Trending Movies' collection using the MDBList template. It specifies the list, sorting, and user, limiting the results.

```yaml
"Trending Movies":
  url_poster: https://raw.githubusercontent.com/0x5f3/kometa.config/assets/_suggested/suggested_trending.png
  schedule: daily
  template:
    mdblist_list: "movie-trending"
    mdblist_sort: "rank.desc"
    mdblist_user: "archivist"
    name: mdblist
    num: "5"
  limit: 100
```

--------------------------------

### Suggested Movies Collection

Source: https://context7.com/kometa-team/community-configs/llms.txt

Configures a 'Suggested Movies' collection using the Trakt template. It pulls recommended movies based on country, language, and time period.

```yaml
"Suggested Movies":
  collection_order: alpha
  url_poster: https://raw.githubusercontent.com/0x5f3/kometa.config/assets/_suggested/suggested_suggested.png
  schedule: daily
  template: { name: trakt, num: "4" }
  trakt_chart:
    - chart: recommended
      countries: us, gb, ie, ca, au, nz
      languages: en
      limit: 25
      time_period: monthly
    - chart: recommended
      limit: 50
      time_period: yearly
```

--------------------------------

### Plex Smart Filter Template

Source: https://context7.com/kometa-team/community-configs/llms.txt

Defines a template for Plex smart filters that are self-updating. It includes settings for collection mode, sorting, and visibility.

```yaml
plex:
  collection_mode: hide
  delete_not_scheduled: false
  sort_title: "+010_<<num>>_<<collection_name>>"
  sync_mode: sync
  visible_home: false
  visible_library: false
  visible_shared: false
```

--------------------------------

### TV Network Collections using TMDB IDs

Source: https://context7.com/kometa-team/community-configs/llms.txt

Defines reusable templates and collections for organizing TV shows by network using TMDB network IDs. The `network` template accepts TMDB network IDs and sets sorting and sync modes.

```yaml
# networks.yml — TV network collections using TMDB network IDs
templates:
  network:
    optional:
      - network
    tmdb_network: <<network>>   # TMDB network ID(s), comma-separated
    sort_title: +2_<<collection_name>>
    sync_mode: sync
    smart_label: episode_added.desc

collections:
  HBO:
    template: { name: network, network: "49, 2593, 3186, 3308" }
  Netflix:
    template: { name: network, network: 213 }
  Hulu:
    template: { name: network, network: "453, 1772" }
  Apple+:
    template: { name: network, network: "1932, 2552" }
  BBC:
    template: { name: network, network: "3, 4, 15, 100, 126, 317, 332, 375, 414" }
  Disney+:
    template: { name: network, network: "44, 54, 142, 2739, 2771, 2897" }
  FOX:
    template: { name: network, network: "19, 45, 87, 131, 243, 327, 338, 360, 415" }
  NBC:
    template: { name: network, network: "6, 37, 175, 186, 287, 355, 413, 581" }
  AMC:
    template: { name: network, network: "174, 4661, 6400" }
  Peacock:
    template: { name: network, network: 3353 }
  Paramount:
    template: { name: network, network: "2076, 2435, 2604, 4330, 5506, 5511" }
```