Plex-Meta-Manager/docs/showcase/overlays.md

# Overlays Showcase

This page is designed to show the art of the possible when using Overlays within Kometa.

Each showcased photo has been confirmed to be fully functional with Kometa v1.19.0. We cannot guarantee functionality beyond that version.

## Example 1

=== "Example 1"

    ![Overlay Showcase 1](overlay-showcase1.jpg){width="600" align=left loading=lazy }
    
    This example shows a minimalistic Overlay application with the resolution, audio codec and video format on display.

    This example uses three Kometa Default Overlay files: [Resolution](../defaults/overlays/resolution.md), [Audio Codec](../defaults/overlays/audio_codec.md) and [Video Format](../defaults/overlays/video_format.md).

    Resolution is used to identify if the movie is 4K for example, and also highlights if a movie is Dolby Vision or HDR.

    Audio Codec is used to identify what format the audio is in (such as Dolby Digital or Dolby ATMOS)

    Video Format is used to identify the source of a file (such as a DVD rip or a WEB rip)

    **Click the image to enlarge it**

=== "Click to view Example 1 code"

    This code belongs in config.yml

    ```yml
    libraries:
      Movies:
        overlay_files:
        - default: resolution
        - default: audio_codec
        - default: video_format
    ```

    **Replace `Movies` with the name of your library**

## Example 2

=== "Example 2"

    ![Overlay Showcase 2](overlay-showcase2.jpg){width="600" align=left loading=lazy }
    
    This example shows a minimalistic Overlay application with the ratings and ribbon of the movie.

    This example uses two Kometa Default Overlay files: [Ratings](../defaults/overlays/ratings.md) and [Ribbon](../defaults/overlays/ribbon.md).

    Ratings are set to show the Rotten Tomatoes Audience & Critic scores, as well as the IMDb score.

    Custom fonts have been used for the ratings which can be sourced in [bullmoose20's repository](https://github.com/Kometa-Team/Community-Configs/tree/master/bullmoose20) within `fonts.zip`

    A [Library Operation](../config/operations.md#mass-star-rating-update) is used to place the IMDb rating into the user rating slot, as can be seen in the code example.

    **Click the image to enlarge it**

=== "Click to view Example 2 code"

    This code belongs in config.yml

    ```yml
    libraries:
      Movies:
        overlay_files:
        - default: ratings
          template_variables:
            rating1: critic
            rating1_image: rt_tomato
            rating1_font: config/overlays/fonts/Adlib.ttf
            rating1_font_size: 63
            rating2: audience
            rating2_image: rt_popcorn
            rating2_font: config/overlays/fonts/Adlib.ttf
            rating2_font_size: 63
            rating3: user
            rating3_image: imdb
            rating3_font: config/overlays/fonts/Impact.ttf
            rating3_font_size: 70
            horizontal_position: left
            vertical_position: bottom
            rating1_vertical_offset: 30
            rating2_vertical_offset: 30
            rating3_vertical_offset: 30
            rating1_horizontal_offset: 30
            rating2_horizontal_offset: 250
            rating3_horizontal_offset: 470
        - default: ribbon
        operations:
          mass_user_rating_update: imdb
    ```

    **Replace `Movies` with the name of your library** and **Set the font location to wherever you place them**


## Example 3

=== "Example 3"

    ![Overlay Showcase 3](overlay-showcase3.jpg){width="600" align=left loading=lazy }
    
    This example shows a minimalistic Overlay application with the ratings applied at the bottom of the poster

    This example uses two Kometa Default Overlay files: [Ratings](../defaults/overlays/ratings.md) and [Runtimes](../defaults/overlays/runtimes.md).

    Ratings are set to show the TMDb, Trakt and IMDb ratings, which have been set using [Library Operations](../config/operations.md#mass-star-rating-update)

    The runtimes overlay is modified to show no text, but to instead produce the black bar which the ratigns sit on top of.

    **Click the image to enlarge it**

=== "Click to view Example 3 code"

    This code belongs in config.yml

    ```yml
    libraries:
      Movies:
        overlay_files:
        - default: runtimes
          template_variables:
            text: ""
            horizontal_position: center
            rating_alignment: horizontal
            vertical_position: bottom
            back_width: 2500
            back_radius: 1
            back_color: "#000000"
            horizontal_offset: 0
            vertical_offset: 0
        - default: ratings
          template_variables:
            rating1: critic
            rating1_image: tmdb
            rating2: audience
            rating2_image: trakt
            rating3: user
            rating3_image: imdb
            horizontal_position: center
            rating_alignment: horizontal
            vertical_position: bottom
            back_width: 1
            back_radius: 0
            back_height: 40
            back_color: "#000000"
        operations:
          mass_critic_rating_update: tmdb
          mass_audience_rating_update: trakt
          mass_user_rating_update: imdb
    ```

    **Replace `Movies` with the name of your library**