# Audio/Subtitle Language Count Overlay

The `language_count` Default Overlay File is used to create an overlay based on the number of audio/subtitle languages available on each item within your library.

![](images/language_count.png)

## Requirements & Recommendations

Supported Overlay Level: Movie, Show, Season, Episode

## Supported Audio/Subtitle Languages

| Audio/Subtitle Languages | Key     | Weight |
|:-------------------------|:--------|:-------|
| Dual                     | `dual`  | `20`   |
| Multi                    | `multi` | `10`   |

## Config

The below YAML in your config.yml will create the overlays:

```yaml
libraries:
  Movies:
    overlay_path:
      - pmm: language_count
  TV Shows:
    overlay_path:
      - pmm: language_count
      - pmm: language_count
        template_variables:
          builder_level: season
      - pmm: language_count
        template_variables:
          builder_level: episode
```

## Template Variable Default Values

Template Variables can be used to manipulate the file in various ways to slightly change how it works without having to make your own local copy.

| Variable                     | Default / Values                                                                                                                                                               |
|:-----------------------------|:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `horizontal_offset`          | `0`                                                                                                                                                                            |
| `horizontal_align`           | `center`                                                                                                                                                                       |
| `vertical_offset`            | `30`                                                                                                                                                                           |
| `vertical_align`             | `bottom`                                                                                                                                                                       |
| `back_color`                 | `#00000099`                                                                                                                                                                    |
| `back_radius`                | `30`                                                                                                                                                                           |
| `back_width`                 | `188`                                                                                                                                                                          |
| `back_height`                | `105`                                                                                                                                                                          |
| `use_subtitles`              | **Description:** Controls if the overlay is based on subtitle language instead of audio language.<br>**Values:** `true` to look at subtitle language instead of audio language |
| `minimum`                    | **Description:** Choose the minimum for the `multi` Overlay.<br>**Default:** `2` <br>**Values:** Any Number                                                                    |
| `builder_level`              | **Description:** Choose the Overlay Level.<br>**Values:** `season` or `episode`                                                                                                |
| `weight_<<key>>`<sup>1</sup> | **Description:** Controls the weight of the Overlay. Higher numbers have priority.<br>**Values:** Any Number                                                                   |

1. Each default overlay has a `key` that when calling to effect a specific overlay you must replace `<<key>>` with when calling.

{%
   include-markdown "../overlay_variables.md"
%}

## Example Template Variable Amendments

The below is an example config.yml extract with some Template Variables added in to change how the file works.

```yaml
libraries:
  Movies:
    overlay_path:
      - pmm: language_count
        template_variables:
          use_subtitles: true
```