| `name`| Name of the overlay. Each overlay name should be unique. | ✅ |
| `file`| Local location of the Overlay Image. | ❌ |
| `url`| URL of Overlay Image Online. | ❌ |
| `git`| Location in the [Configs Repo](https://github.com/meisnate12/Plex-Meta-Manager-Configs) of the Overlay Image. | ❌ |
| `repo`| Location in the [Custom Repo](../config/settings.md#custom-repo) of the Overlay Image. | ❌ |
| `group`| Name of the Grouping for this overlay. **`weight` is required when using `group`** | ❌ |
| `weight`| Weight of this overlay in its group. **`group` is required when using `weight`** | ❌ |
| `horizontal_offset` | Horizontal Offset of this overlay. Can be a %. **`vertical_offset` is required when using `horizontal_offset`** | ❌ |
| `horizontal_align` | Horizontal Alignment of the overlay. **Values:**`left`, `center`, `right` | ❌ |
| `vertical_offset` | Vertical Offset of this overlay. Can be a %. **`horizontal_offset` is required when using `vertical_offset`** | ❌ |
| `vertical_align` | Vertical Alignment of the overlay. **Values:**`top`, `center`, `bottom` | ❌ |
| `font`| System Font Filename or path to font file for the Text Overlay | ❌ |
| `font_size`| Font Size for the Text Overlay. **Value:** Integer greater than 0 | ❌ |
| `font_color`| Font Color for the Text Overlay. **Value:** Color Hex Code. ex `#00FF00` | ❌ |
* If `url`, `git`, and `repo` are all not defined then PMM will look in your `config/overlays` folder for a `.png` file named the same as the `name` attribute.
* Only one overlay with the highest weight per group will be applied.
@ -104,7 +104,7 @@ You can add text as an overlay using the special `text()` overlay name. Anything
You can control the font, font size and font color using the `font`, `font_size`, and `font_color` overlay attributes.
The `x_coordinate` and `y_coordinate` overlay attributes are required when using Text Overlays.
The `horizontal_offset` and `vertical_offset` overlay attributes are required when using Text Overlays.
You can add an items rating number (`8.7`) to the image by using `text(audience_rating)`, `text(critic_rating)`, or `text(user_rating)`