Plex-Meta-Manager/docs/showcase/overlays.md
2024-08-28 19:27:28 +01:00

5.2 KiB

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**