## 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"                                                           | ✅  | ❗  | ❗  | ✅  |