This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision Next revision Both sides next revision | ||
action:Trigger_Macro_by_Name [2017/09/07 05:13] peternlewis |
action:Trigger_Macro_by_Name [2019/07/01 02:09] peternlewis [How To Use] |
||
---|---|---|---|
Line 1: | Line 1: | ||
- | {{:search-find-magnify-icon.png?nolink|}} | ||
====== Trigger Macro by Name Action ====== | ====== Trigger Macro by Name Action ====== | ||
The //Trigger Macro by Name// action display a Spotlight-like window, where you trigger execution of a Macro by searching for it, and then selecting it. | The //Trigger Macro by Name// action display a Spotlight-like window, where you trigger execution of a Macro by searching for it, and then selecting it. | ||
- | {{:action:km-7.2-trigger-macro-by-name-window.png?nolink|}} | + | {{ action:km-7.2-trigger-macro-by-name-window.png?nolink |}} |
Like the Mac Spotlight, it will search all of your active, enabled Macros whose name or contents contain what you type. It is a character search, so it will also find Macro names and words that contain what you type. | Like the Mac Spotlight, it will search all of your active, enabled Macros whose name or contents contain what you type. It is a character search, so it will also find Macro names and words that contain what you type. | ||
+ | |||
+ | {{ trigger-macro-by-name.png?nolink&575x141 | File Name }} | ||
===== How To Use ===== | ===== How To Use ===== | ||
Line 14: | Line 15: | ||
- Assign it a trigger (one suggestion is <kbd>⌘</kbd><kbd>⌥</kbd><kbd>⌃</kbd><kbd>T</kbd>) | - Assign it a trigger (one suggestion is <kbd>⌘</kbd><kbd>⌥</kbd><kbd>⌃</kbd><kbd>T</kbd>) | ||
- Insert the //Trigger Macro by Name// action. | - Insert the //Trigger Macro by Name// action. | ||
- | - Optionally configure the default search. | + | - Optionally configure the initial search. |
- Optionally allow inactive or disabled macros. | - Optionally allow inactive or disabled macros. | ||
- Optionally restrict it to specified macros or macro groups. | - Optionally restrict it to specified macros or macro groups. | ||
Line 25: | Line 26: | ||
- Continue to type until you see the macro of interest | - Continue to type until you see the macro of interest | ||
- If the Macro you want is not highlighted, move to it with the arrow keys, or double-click on it. | - If the Macro you want is not highlighted, move to it with the arrow keys, or double-click on it. | ||
+ | |||
+ | The initial search can (v9.0+) include tokens. | ||
===== How To Filter the Search ===== | ===== How To Filter the Search ===== | ||
Line 42: | Line 45: | ||
For the complete list of available filters, see [[manual:Search_Strings|Search Strings]] | For the complete list of available filters, see [[manual:Search_Strings|Search Strings]] | ||
+ | |||
+ | ===== Passing Parameters ===== | ||
+ | |||
+ | You can pass parameters (v8+) to the macro via the [[token:TriggerValue|%TriggerValue%]] token by adding `//` and then the parameter to your search string. The `//` and anything after that will be ignored in the search. | ||
===== See Also ===== | ===== See Also ===== | ||
Line 58: | Line 65: | ||
- [[https://forum.keyboardmaestro.com/search?q=Trigger%20Macro%20by%20Name%20Action|Keyboard Maestro Forum topics about Trigger Macro by Name Action]] | - [[https://forum.keyboardmaestro.com/search?q=Trigger%20Macro%20by%20Name%20Action|Keyboard Maestro Forum topics about Trigger Macro by Name Action]] | ||
- |