| Both sides previous revisionPrevious revisionNext revision | Previous revision |
| token:TriggerValue [2021/11/14 16:35] – ccstone | token:TriggerValue [2025/02/26 02:13] (current) – peternlewis |
|---|
| |
| ^ Trigger Type ^ `%TriggerValue%` token ^ | ^ Trigger Type ^ `%TriggerValue%` token ^ |
| | [Typed String trigger](trigger:Typed_String) | The exact text you typed to trigger | | | [[trigger:Application|Application]] trigger | The Path to the application that was triggered. | |
| | [[trigger:Status_Menu|Status Menu]] or [[manual:Palettes|Palette]] | The current modifiers (Note that Option means "edit this macro instead of triggering it"). | | | [[trigger:Audio_Output_Changed|Audio Output Changed]] trigger | The name of the selected audio output device. | |
| | [[trigger:Hot_Key|Hot Key Trigger]] or [[trigger:USB_Device_Key|USB Device Key]] | The key that was pressed. | | | [[trigger:Cron|Cron]] trigger | The current time and date (`yyyy-mm-dd hh:mm`). | |
| | [[trigger:Application|Application Trigger]] | Path to the application that was triggered. | | | [[trigger:Display_Layout_Changed|Display Layout Changed]] trigger | A comma separated list of the kinds of changes made. | |
| | | [[trigger:Dragged_File|Dragged File]] trigger | The path of the dragged file. | |
| | | [[action:Execute_a_Macro|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. | |
| | [[trigger:Folder|Folder Trigger]] | Path of the file that was added or removed. | | | [[trigger:Folder|Folder Trigger]] | Path of the file that was added or removed. | |
| | [Execute a Macro action](action:Execute_a_Macro) | 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. | | | [[trigger:Hot_Key|Hot Key Trigger]] | The key that was pressed. | |
| | | [[trigger:Idle|Idle]] trigger | The number of minutes the Mac has been idle. | |
| | | [[trigger:MIDI|MIDI]] trigger | Data related to the specific MIDI trigger information (see [[trigger:MIDI|MIDI]] trigger). | |
| | | [[trigger:Mounted_Volume|Mounted Volume]] trigger | The name of the volume. | |
| | | [[trigger:Remote|Remote]] trigger | The TriggerValue used in the Remote Trigger URL. | |
| | | [[trigger:Script|Script]] trigger | Although _not_ technically a trigger, when a Macro is executed via AppleScript the //%TriggerValue%// token will contain the passed parameter. | |
| | | [[trigger:Status_Menu|Status Menu]] or [[manual:Palettes|Palette]] | The current modifiers (Note that Option means "edit this macro instead of triggering it"). | |
| | | [[trigger:Trigger_File|Trigger File]] trigger | The path of the Trigger File. | |
| | | [[trigger:Typed_String|Typed String]] trigger | The exact text you typed to trigger. | |
| | | [[trigger:URL|URL]] trigger | The TriggerValue used in the URL. | |
| | | [[trigger:USB_Device|USB Device]] trigger | The name of the device. | |
| | | [[trigger:USB_Device_Key|USB Device Key]] | The key that was pressed. | |
| |
| To use the %TriggerValue% token in a numeric field, use the [CALCULATE](https://wiki.keyboardmaestro.com/function/CALCULATE) function: CALCULATE(%TriggerValue%). | To use the %TriggerValue% token in a numeric field, use the [CALCULATE](https://wiki.keyboardmaestro.com/function/CALCULATE) function: CALCULATE(%TriggerValue%). |
