The %TriggerValue% token returns the value associated with how the macro was triggered.
Different ways of triggering the macro will set this field differently.
When a Macro is triggered, the The %TriggerValue% token value will be based on the trigger:
Trigger Type | %TriggerValue% token |
---|---|
Application trigger | The Path to the application that was triggered. |
Audio Output Changed trigger | The name of the selected audio output device. |
Cron trigger | The current time and date (yyyy-mm-dd hh:mm ). |
Display Layout Changed trigger | A comma separated list of the kinds of changes made. |
Dragged File trigger | The path of the dragged file. |
Execute a Macro action | Although Execute a Macro is not technically a trigger, when a Macro is executed by this method (the “Sub-Macro”), the %TriggerValue% token (as evaluated in the “Sub-Macro”) will be either of two values: 1. The %TriggerValue% of the calling (“Main”) Macro OR 2. The value of the Parameter of the Execute a Macro, if a Parameter is provided. |
Folder Trigger | Path of the file that was added or removed. |
Hot Key Trigger | The key that was pressed. |
Idle trigger | The number of minutes the Mac has been idle. |
MIDI trigger | A comma separated list of channel,note,velocity,device . |
Mounted Volume trigger | The name of the volume. |
Remote trigger | The TriggerValue used in the Remote Trigger URL. |
Script trigger | Although not technically a trigger, when a Macro is executed via AppleScript the %TriggerValue% token will contain the passed parameter. |
Status Menu or Palette | The current modifiers (Note that Option means “edit this macro instead of triggering it”). |
Trigger File trigger | The path of the Trigger File. |
Typed String trigger | The exact text you typed to trigger. |
URL trigger | The TriggerValue used in the URL. |
USB Device trigger | The name of the device. |
USB Device Key | The key that was pressed. |
To use the %TriggerValue% token in a numeric field, use the CALCULATE function: CALCULATE(%TriggerValue%).
You can easily access the individual parts using the token array notation, eg %TriggerValue[3]%
will be the third comma-separated value, and %TriggerValue[3];%
will be the third semicolon-separated value, and %TriggerValue[3] %
(note the space between the ]
and the %
) will be the third space-separated value (8.0.4+).