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

## Overlays

These files apply overlays and can generally be used on both Movie and Show library-types, and often works at the season and episode-level too.

It should be noted that when an overlay has ❗ for a season or episode, it normally means that whilst the overlay can technically be applied at the level, it wasn't designed for this purpose. For example, a show's season cannot have a resolution since it is not a video file, and an episode cannot have a commonsense age-rating since only Movies and Shows are rated by CommonSense. 

In the scenario where there is missing data such as age ratings for episodes, then generally the highest-level data available will be applied at the lower level (i.e. a Show's CommonSense age rating would apply to all episodes).

These overlays are applied by calling the below paths into the `overlay_path` [section](../config/libraries.md#overlay-path) of your config.yml

### Overlay Files

| Default                                        |       path       | Example Overlays                                                          |  Movies  |   Shows   |  Seasons  | Episodes |
|:-----------------------------------------------|:----------------:|:--------------------------------------------------------------------------|:--------:|:---------:|:---------:|:--------:|
| [Audio Codec](overlays/audio_codec)            |  `audio_codec`   | Dolby Atmos logo, DTS logo                                                | ✅  |  ✅  |  ✅  | ✅  |
| [CommonSense Age Rating](overlays/commonsense) |  `commonsense`   | "3+", "16+"                                                               | ✅  |  ✅  | ❗  | ❗ |
| [Direct Play](overlays/direct_play)            |  `direct_play`   | "Direct Play Only"                                                        | ✅  | ❗  | ❗  | ✅  |
| [Episode Info](overlays/episode_info)          |  `episode_info`  | "S01E01", "S02E09"                                                        | ❌ | ❌  | ❌  | ✅  |
| [FlixPatrol](overlays/flixpatrol)              |   `flixpatrol`   | "Streaming service logo with words "TOP"                                  | ✅  |  ✅  | ❌  | ❌ |
| [Language Count](overlays/language_count)      | `language_count` | Dual-Audio, Multi-Audio, Dual-Subtitle, Multi-Subtitle                    | ✅  |  ✅  |  ✅  | ✅  |
| [Languages](overlays/languages)                |   `languages`    | Flags Based on the Audio/Subtitles a file has                             | ✅  |  ✅  |  ✅  | ✅  |
| [Mediastinger](overlays/mediastinger)          |  `mediastinger`  | Mediastinger Logo for After/During Credit Scenes                          | ✅  |  ✅  | ❌  | ❌ |
| [Ratings](overlays/ratings)                    |    `ratings`     | IMDb Audience Rating, Metacritic Critic Rating                            | ✅  |  ✅  | ❌  | ✅  |
| [Resolution/Editions](overlays/resolution)     |   `resolution`   | 4K Dolby Vision logo, 720P logo, "Director's Cut", "Criterion Collection" | ✅  |  ✅  | ❌  | ✅  |
| [Ribbon](overlays/ribbon)                      |     `ribbon`     | IMDb Top 250 Ribbon, RT Fresh Ribbon                                      | ✅  |  ✅  | ❌  | ❌ |
| [Runtimes](overlays/runtimes)                  |    `runtimes`    | "Runtime: 1h 30m"                                                         | ✅  |  ✅  | ❌  | ❌ |
| [Status](overlays/status)                      |     `status`     | Airing, Returning, Canceled, Ended                                        | ❌ |  ✅  | ❌  | ❌ |
| [Streaming](overlays/streaming)                |   `streaming`    | Netflix logo, Hulu logo                                                   | ✅  |  ✅  | ❌  | ❌ |
| [Versions](overlays/versions)                  |    `versions`    | Multiple Versions logo                                                    | ✅  |  ✅  |  ✅  | ✅  |
| [Video Format](overlays/video_format)          |  `video_format`  | "REMUX", "HDTV"                                                           | ✅  | ❗  | ❗  | ✅  |