@ -320,50 +320,92 @@ Note that we have built up on our backdrop overlay that we created in our previo
You can use the item's metadata to determine the text by adding Special Text Variables to your text Overlay.
You can use the item's metadata to determine the text by adding Special Text Variables to your text Overlay.
There are multiple Special Text Variables that can be used when formatting the text. The variables are defined like so `<<name>>` and some can have modifiers like so `<<name$>>` where `$` is the modifier. The available options are:
Each Special Text Variables has multiple modifiers that can be used to format the text. The variables are defined like this `<<name$>>` where `name` is the Special Text Variable and the modifier is `$`.
| `<<audience_rating>>`: audience rating (`8.7`, `9.0`)<br>`<<audience_rating%>>`: audience rating out of 100 (`87`, `90`)<br>`<<audience_rating#>>`: audience rating removing `.0` as needed (`8.7`, `9`)<br>`<<audience_rating/>>`: audience rating on a 5 point scale (`8.6` shows as `4.3`) | `Movies`, `Shows`, or `Episodes` |
| `<<critic_rating>>`: critic rating (`8.7`, `9.0`)<br>`<<critic_rating%>>`: critic rating out of 100 (`87`, `90`)<br>`<<critic_rating#>>`: critic rating removing `.0` as needed (`8.7`, `9`)<br>`<<critic_rating/>>`: critic rating on a 5 point scale (`8.6` shows as `4.3`) | `Movies`, `Shows`, or `Episodes` |
| `<<user_rating>>`: user rating (`8.7`, `9.0`)<br>`<<user_rating%>>`: user rating out of 100 (`87`, `90`)<br>`<<user_rating#>>`: user rating removing `.0` as needed (`8.7`, `9`)<br>`<<user_rating/>>`: user rating on a 5 point scale (`8.6` shows as `4.3`) | `Movies`, `Shows`, `Seasons`, or `Episodes` |
| `<<tmdb_rating>>`: TMDb rating (`8.7`, `9.0`)<br>`<<tmdb_rating%>>`: TMDb rating out of 100 (`87`, `90`)<br>`<<tmdb_rating#>>`: TMDb rating removing `.0` as needed (`8.7`, `9`)<br>`<<tmdb_rating/>>`: TMDb rating on a 5 point scale (`8.6` shows as `4.3`) | `Movies`, `Shows`, or `Episodes` |
| `<<imdb_rating>>`: IMDb rating (`8.7`, `9.0`)<br>`<<imdb_rating%>>`: IMDb rating out of 100 (`87`, `90`)<br>`<<imdb_rating#>>`: IMDb rating removing `.0` as needed (`8.7`, `9`)<br>`<<imdb_rating/>>`: IMDb rating on a 5 point scale (`8.6` shows as `4.3`) | `Movies`, `Shows`, or `Episodes` |
| `<<trakt_user_rating>>`: Trakt User rating (`8.7`, `9.0`)<br>`<<trakt_user_rating%>>`: Trakt User rating out of 100 (`87`, `90`)<br>`<<trakt_user_rating#>>`: Trakt User rating removing `.0` as needed (`8.7`, `9`)<br>`<<trakt_user_rating/>>`: Trakt User rating on a 5 point scale (`8.6` shows as `4.3`) | `Movies` or `Shows` |
| `<<omdb_rating>>`: OMDb rating (`8.7`, `9.0`)<br>`<<omdb_rating%>>`: OMDb rating out of 100 (`87`, `90`)<br>`<<omdb_rating#>>`: OMDb rating removing `.0` as needed (`8.7`, `9`)<br>`<<omdb_rating/>>`: OMDb rating on a 5 point scale (`8.6` shows as `4.3`) | `Movies` or `Shows` |
| `<<mdb_rating>>`: MDbList rating (`8.7`, `9.0`)<br>`<<mdb_rating%>>`: MDbList rating out of 100 (`87`, `90`)<br>`<<mdb_rating#>>`: MDbList rating removing `.0` as needed (`8.7`, `9`)<br>`<<mdb_rating/>>`: MDbList rating on a 5 point scale (`8.6` shows as `4.3`) | `Movies` or `Shows` |
| `<<mdb_average_rating>>`: MDbList Average rating (`8.7`, `9.0`)<br>`<<mdb_average_rating%>>`: MDbList Average rating out of 100 (`87`, `90`)<br>`<<mdb_average_rating#>>`: MDbList Average rating removing `.0` as needed (`8.7`, `9`)<br>`<<mdb_average_rating/>>`: MDbList Average rating on a 5 point scale (`8.6` shows as `4.3`) | `Movies` or `Shows` |
| `<<mdb_imdb_rating>>`: MDbList IMDb rating (`8.7`, `9.0`)<br>`<<mdb_imdb_rating%>>`: MDbList IMDb rating out of 100 (`87`, `90`)<br>`<<mdb_imdb_rating#>>`: MDbList IMDb rating removing `.0` as needed (`8.7`, `9`)<br>`<<mdb_imdb_rating/>>`: MDbList IMDb rating on a 5 point scale (`8.6` shows as `4.3`) | `Movies` or `Shows` |
| `<<mdb_metacritic_rating>>`: MDbList Metacritic rating (`8.7`, `9.0`)<br>`<<mdb_metacritic_rating%>>`: MDbList Metacritic rating out of 100 (`87`, `90`)<br>`<<mdb_metacritic_rating#>>`: MDbList Metacritic rating removing `.0` as needed (`8.7`, `9`)<br>`<<mdb_metacritic_rating/>>`: MDbList Metacritic rating on a 5 point scale (`8.6` shows as `4.3`) | `Movies` or `Shows` |
| `<<mdb_metacriticuser_rating>>`: MDbList Metacritic User rating (`8.7`, `9.0`)<br>`<<mdb_metacriticuser_rating%>>`: MDbList Metacritic User rating out of 100 (`87`, `90`)<br>`<<mdb_metacriticuser_rating#>>`: MDbList Metacritic User rating removing `.0` as needed (`8.7`, `9`)<br>`<<mdb_metacriticuser_rating/>>`: MDbList Metacritic User rating on a 5 point scale (`8.6` shows as `4.3`) | `Movies` or `Shows` |
| `<<mdb_trakt_rating>>`: MDbList Trakt rating (`8.7`, `9.0`)<br>`<<mdb_trakt_rating%>>`: MDbList Trakt rating out of 100 (`87`, `90`)<br>`<<mdb_trakt_rating#>>`: MDbList Trakt rating removing `.0` as needed (`8.7`, `9`)<br>`<<mdb_trakt_rating/>>`: MDbList Trakt rating on a 5 point scale (`8.6` shows as `4.3`) | `Movies` or `Shows` |
| `<<mdb_tomatoes_rating>>`: MDbList Rotten Tomatoes rating (`8.7`, `9.0`)<br>`<<mdb_tomatoes_rating%>>`: MDbList Rotten Tomatoes rating out of 100 (`87`, `90`)<br>`<<mdb_tomatoes_rating#>>`: MDbList Rotten Tomatoes rating removing `.0` as needed (`8.7`, `9`)<br>`<<mdb_tomatoes_rating/>>`: MDbList Rotten Tomatoes rating on a 5 point scale (`8.6` shows as `4.3`) | `Movies` or `Shows` |
| `<<mdb_tomatoesaudience_rating>>`: MDbList Rotten Tomatoes Audience rating (`8.7`, `9.0`)<br>`<<mdb_tomatoesaudience_rating%>>`: MDbList Rotten Tomatoes Audience rating out of 100 (`87`, `90`)<br>`<<mdb_tomatoesaudience_rating#>>`: MDbList Rotten Tomatoes Audience rating removing `.0` as needed (`8.7`, `9`)<br>`<<mdb_tomatoesaudience_rating/>>`: MDbList Rotten Tomatoes Audience rating on a 5 point scale (`8.6` shows as `4.3`) | `Movies` or `Shows` |
| `<<mdb_tmdb_rating>>`: MDbList TMDb rating (`8.7`, `9.0`)<br>`<<mdb_tmdb_rating%>>`: MDbList TMDb rating out of 100 (`87`, `90`)<br>`<<mdb_tmdb_rating#>>`: MDbList TMDb rating removing `.0` as needed (`8.7`, `9`)<br>`<<mdb_tmdb_rating/>>`: MDbList TMDb rating on a 5 point scale (`8.6` shows as `4.3`) | `Movies` or `Shows` |
| `<<mdb_letterboxd_rating>>`: MDbList Letterboxd rating (`8.7`, `9.0`)<br>`<<mdb_letterboxd_rating%>>`: MDbList Letterboxd rating out of 100 (`87`, `90`)<br>`<<mdb_letterboxd_rating#>>`: MDbList Letterboxd rating removing `.0` as needed (`8.7`, `9`)<br>`<<mdb_letterboxd_rating/>>`: MDbList Letterboxd rating on a 5 point scale (`8.6` shows as `4.3`) | `Movies` or `Shows` |
| `<<mdb_myanimelist_rating>>`: MDbList MyAnimeList rating (`8.7`, `9.0`)<br>`<<mdb_myanimelist_rating%>>`: MDbList MyAnimeList rating out of 100 (`87`, `90`)<br>`<<mdb_myanimelist_rating#>>`: MDbList MyAnimeList rating removing `.0` as needed (`8.7`, `9`)<br>`<<mdb_myanimelist_rating/>>`: MDbList MyAnimeList rating on a 5 point scale (`8.6` shows as `4.3`) | `Movies` or `Shows` |
| `<<anidb_rating>>`: AniDB rating (`8.7`, `9.0`)<br>`<<anidb_rating%>>`: AniDB rating out of 100 (`87`, `90`)<br>`<<anidb_rating#>>`: AniDB rating removing `.0` as needed (`8.7`, `9`)<br>`<<anidb_rating/>>`: AniDB rating on a 5 point scale (`8.6` shows as `4.3`) | `Movies` or `Shows` |
| `<<anidb_average_rating>>`: AniDB Average rating (`8.7`, `9.0`)<br>`<<anidb_average_rating%>>`: AniDB Average rating out of 100 (`87`, `90`)<br>`<<anidb_average_rating#>>`: AniDB Average rating removing `.0` as needed (`8.7`, `9`)<br>`<<anidb_average_rating/>>`: AniDB Average rating on a 5 point scale (`8.6` shows as `4.3`) | `Movies` or `Shows` |
| `<<anidb_score_rating>>`: AniDB Score rating (`8.7`, `9.0`)<br>`<<anidb_score_rating%>>`: AniDB Score rating out of 100 (`87`, `90`)<br>`<<anidb_score_rating#>>`: AniDB Score rating removing `.0` as needed (`8.7`, `9`)<br>`<<anidb_score_rating/>>`: AniDB Score rating on a 5 point scale (`8.6` shows as `4.3`) | `Movies` or `Shows` |
| `<<mal_rating>>`: MyAnimeList rating (`8.7`, `9.0`)<br>`<<mal_rating%>>`: MyAnimeList rating out of 100 (`87`, `90`)<br>`<<mal_rating#>>`: MyAnimeList rating removing `.0` as needed (`8.7`, `9`)<br>`<<mal_rating/>>`: MyAnimeList rating on a 5 point scale (`8.6` shows as `4.3`) | `Movies` or `Shows` |
| `<<title>>`: Title of the Item<br>`<<titleU>>`: Uppercase Title of the Item<br>`<<titleL>>`: Lowercase Title of the Item<br>`<<titleP>>`: Proper Title of the Item | `Movies`, `Shows`, `Seasons`, or `Episodes` |
| `<<show_title>>`: Title of the Item's Show<br>`<<show_itleU>>`: Uppercase Title of the Item's Show<br>`<<show_titleL>>`: Lowercase Title of the Item's Show<br>`<<show_titleP>>`: Proper Title of the Item's Show | `Seasons` or `Episodes` |
| `<<season_title>>`: Title of the Item's Season<br>`<<season_titleU>>`: Uppercase Title of the Item's Season<br>`<<season_titleL>>`: Lowercase title of the Item's Season<br>`<<season_titleP>>`: Proper title of the Item's Season | `Episodes` |
| `<<original_title>>`: Original Title of the Item<br>`<<original_titleU>>`: Original Title of the Item<br>`<<original_titleL>>`: Lowercase Original Title of the Item<br>`<<original_titleP>>`: Proper Original Title of the Item | `Movies` or `Shows` |
| `<<edition>>`: Edition of the Item<br>`<<editionU>>`: Uppercase Edition of the Item<br>`<<editionL>>`: Lowercase Edition of the Item<br>`<<editionP>>`: Proper Edition of the Item | `Movies` |
| `<<content_rating>>`: Content Rating of the Item<br>`<<content_ratingU>>`: Uppercase Content Rating of the Item<br>`<<content_ratingL>>`: Lowercase Content Rating of the Item<br>`<<content_ratingP>>`: Proper Content Rating of the Item | `Movies`, `Shows`, or `Episodes` |
| `<<episode_count>>`: Number of Episodes (`1`)<br>`<<episode_countW>>`: Number of Episodes As Words (`One`)<br>`<<episode_countWU>>`: Number of Episodes As Uppercase Words (`ONE`)<br>`<<episode_countWL>>`: Number of Episodes As Lowercase Words (`one`)<br>`<<episode_count0>>`: Number of Episodes With 10s Padding (`01`)<br>`<<episode_count00>>`: Number of Episodes With 100s Padding (`001`) | `Shows` or `Seasons` |
| `<<season_number>>`: Season Number (`1`)<br>`<<season_numberW>>`: Season Number As Words (`One`)<br>`<<season_numberWU>>`: Season Number As Uppercase Words (`ONE`)<br>`<<season_numberWL>>`: Season Number As Lowercase Words (`one`)<br>`<<season_number0>>`: Season Number With 10s Padding (`01`)<br>`<<season_number00>>`: Season Number With 100s Padding (`001`) | `Seasons` or `Episodes` |
| `<<episode_number>>`: Episode Number (`1`)<br>`<<episode_numberW>>`: Episode Number As Words (`One`)<br>`<<episode_numberWU>>`: Episode Number As Uppercase Words (`One`)<br>`<<episode_numberWL>>`: Episode Number As Lowercase Words (`one`)<br>`<<episode_number0>>`: Episode Number With 10s Padding (`01`)<br>`<<episode_number00>>`: Episode Number With 100s Padding (`001`) | `Episodes` |
| `<<versions>>`: Number of Versions of the Item (`1`)<br>`<<versionsW>>`: Number of Versions of the Item As Words (`One`)<br>`<<versionsWO>>`: Number of Versions of the Item As Uppercase Words (`ONE`)<br>`<<versionsWL>>`: Number of Versions of the Item As Words (`one`)<br>`<<versions0>>`: Number of Versions of the Item With 10s Padding (`01`)<br>`<<versions00>>`: Number of Versions of the Item With 100s Padding (`001`) | `Movies` or `Episodes` |
| `<<runtime>>`: Complete Runtime of the Item in minutes (`150`)<br>`<<runtimeH>>`: Hours in runtime of the Item (`2`)<br>`<<runtimeM>>`: Minutes remaining in the hour in the runtime of the Item (`30`)<br>**Show and Season use average Episode Runtime.** | `Movies`, `Shows`, `Seasons`, or `Episodes` |
| `<<runtime>>`: Complete Runtime of the Item in minutes (`150`)<br>`<<runtimeH>>`: Hours in runtime of the Item (`2`)<br>`<<runtimeM>>`: Minutes remaining in the hour in the runtime of the Item (`30`)<br>**Show and Season use average Episode Runtime.** | `Movies`, `Shows`, `Seasons`, or `Episodes` |
| `<<bitrate>>`: Bitrate of the first media file for an item.<br>`<<bitrateH>>`: Bitrate of the media file with the highest bitrate<br>`<<bitrateL>>`: Bitrate of the media file with the lowest bitrate | `Movies` or `Episodes` |
| `<<bitrate>>`: Bitrate of the first media file for an item.<br>`<<bitrateH>>`: Bitrate of the media file with the highest bitrate<br>`<<bitrateL>>`: Bitrate of the media file with the lowest bitrate | `Movies` or `Episodes` |
| `<<originally_available>>`: Original Available Date of the Item<br>`<<originally_available[FORMAT]>>`: Original Available Date of the Item in the given format. [Format Options](https://strftime.org/) | `Movies`, `Shows`, or `Episodes` |
| `<<originally_available>>`: Original Available Date of the Item<br>`<<originally_available[FORMAT]>>`: Original Available Date of the Item in the given format. [Format Options](https://strftime.org/) | `Movies`, `Shows`, or `Episodes` |
???+ tip
You can use the `mass_audience_rating_update` or `mass_critic_rating_update` [Library Operation](../config/operations.md) to update your plex ratings to various services like `tmdb`, `imdb`, `mdb`, `metacritic`, `letterboxd` and many more.