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

71 lines
6.1 KiB
Markdown
Raw Normal View History

# Status Overlay
The `status` Default Overlay File is used to create an overlay on a show detailing its Current Airing Status for all shows in your library.
![](images/status.png)
## Requirements & Recommendations
Supported Overlay Level: Show
## Supported Status
| Status | Key | Weight |
|:----------|:------------|:-------|
| AIRING | `airing` | `40` |
| RETURNING | `returning` | `30` |
| CANCELED | `canceled` | `20` |
| ENDED | `ended` | `10` |
## Config
The below YAML in your config.yml will create the overlays:
```yaml
libraries:
TV Shows:
overlay_files:
- pmm: status
```
## 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 |
2022-10-17 12:13:48 +00:00
|:-----------------------------|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `horizontal_offset` | `15` |
| `horizontal_align` | `left` |
| `vertical_offset` | `330` |
| `vertical_align` | `top` |
| `back_color` | `#00000099` |
| `back_radius` | `30` |
| `back_width` | `305` |
| `back_height` | `105` |
2023-09-25 23:10:21 +00:00
| `last` | **Description:** Episode Air Date in the last number of days for the AIRING Overlay.<br>**Default:** `14`<br>**Values:** Any number greater than 0 |
2022-10-17 12:13:48 +00:00
| `text_<<key>>`<sup>1</sup> | **Description:** Choose the text for the Overlay.<br>**Default:** <table class="clearTable"><tr><th>Key</th><th>Default</th></tr><tr><td>`airing`</td><td>`AIRING`</td></tr><tr><td>`returning`</td><td>`RETURNING`</td></tr><tr><td>`canceled`</td><td>`CANCELED`</td></tr><tr><td>`ended`</td><td>`ENDED`</td></tr></table>**Values:** Any String |
| `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"
%}
{%
include-markdown "../overlay_text_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:
TV Shows:
overlay_files:
- pmm: status
2023-01-06 17:53:05 +00:00
template_variables:
text_canceled: "C A N C E L L E D"
```