Substitutions

Plugin writers can enable configuration text fields to accept special markup that will substitute a variable, device state, or timestamp value at runtime. Any string with the following markup will have an Indigo variable value substituted:

Variable Substitutions

%%v:VARID%%

VARID is the unique variable ID as found in the UI in various places.

Device Substitutions

%%d:DEVID:STATEID%%

The STATEID of the device whose ID is DEVID will be substituted. For instance, an iTunes Server device from the iTunes plugin has a state named album. So, if the ID of your iTunes server device was 123456, then this would insert the album title into the field:

The current album playing is %%d:123456:album%%.

Time Substitutions

%%t:"FORMAT SPECIFIER"%%

FORMAT SPECIFIER is the standard POSIX date/time specifier -- which must be surrounded by double quotes. For example, "%Y-%m-%d %H:%M" will yield:

2025-01-01 12:34

Note - not all text fields will support substitution. The plugin developer must enable it specifically. Check the plugin documentation to see if the field you're interested in supports substitution.