User Tools
action:Trigger_Macro_by_Name
Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision | ||
|
action:Trigger_Macro_by_Name [2016/07/19 03:12] alain JMTX template + add forum link & internal link |
action:Trigger_Macro_by_Name [2022/11/09 05:30] (current) ChrisLozach Added documentation for using ⌥ with the Trigger Macro by Name action |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| - | The Trigger Macro by Name action puts an input window across the screen. Start typing the name of a macro to see a list of likely candidates. Continue typing to filter the list further. Select the correct macro once you see it. | + | ====== Trigger Macro by Name Action ====== |
| - | {{:action:triggermacrobyname.png|}} | + | The //Trigger Macro by Name// action displays a Spotlight-like window, where you trigger execution of a Macro by searching for it, and then selecting it. |
| - | The following string will find the Trigger Macro by Name action: | + | {{ action:km-7.2-trigger-macro-by-name-window.png?nolink |}} |
| - | mac nam | + | 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. |
| - | Each string of characters separated by a space is added to the filter, and KM looks for the best possible match. | + | {{ trigger-macro-by-name.png?nolink&575x141 | File Name }} |
| - | ===== See Also ===== | + | ===== How To Use for Triggering Macros ===== |
| - | ---- | + | - Create the Trigger by Name Macro |
| + | - Create a new macro, in the Global Macro Group (so it will be available in all apps) | ||
| + | - Assign it a trigger (one suggestion is <kbd>⌘</kbd><kbd>⌥</kbd><kbd>⌃</kbd><kbd>T</kbd>) | ||
| + | - Insert the //Trigger Macro by Name// action. | ||
| + | - Optionally configure the initial search. | ||
| + | - Optionally allow inactive or disabled macros. | ||
| + | - Optionally restrict it to specified macros or macro groups. | ||
| + | - When you are ready to Trigger a Macro | ||
| + | - Like using any Macro, make sure you have any required app frontmost. | ||
| + | - Then, trigger the Trigger by Name Macro (the one you made in Step #1) | ||
| + | - The //**Trigger Macro by Name**// window will appear | ||
| + | - Type the search criteria | ||
| + | - As you type, the macro list will be filtered | ||
| + | - 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. | ||
| + | |||
| + | The initial search can (v9.0+) include tokens. | ||
| + | |||
| + | ==== To edit the selected macro ==== | ||
| + | |||
| + | If you wish to open Keyboard Maestro directly to the selected macro rather than triggering it, use <kbd>⌥</kbd><kbd>return</kbd> or <kbd>⌥</kbd>+click. | ||
| + | |||
| + | ===== How To Filter the Search ===== | ||
| + | |||
| + | If you would like to further restrict, or filter, the search, you can use qualifiers, or prefixes, to what you type, using these [[manual:Search_Strings|Search Strings]]. | ||
| + | |||
| + | For example: | ||
| + | |||
| + | a:safari n:copy | ||
| + | |||
| + | would filter the list of Macros to those whose: | ||
| + | |||
| + | * Active application is "Safari" | ||
| + | * Macro name contains "copy" | ||
| + | |||
| + | {{:action:km-7.2-trigger-macro-by-name-example.png?nolink|}} | ||
| + | |||
| + | 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 ===== | ||
| === Actions === | === Actions === | ||
| Line 19: | Line 62: | ||
| ==== Topics ==== | ==== Topics ==== | ||
| - | * [[:manual:/Search Strings|Search Strings]] | + | * [[:manual:Search Strings|Search Strings]] |
| - | * [[:Frequently Asked Questions|FAQ]] | + | |
| - | + | ||
| - | ---- | + | |
| ==== Forum ==== | ==== Forum ==== | ||
| Line 28: | Line 68: | ||
| - [[https://forum.keyboardmaestro.com/t/limit-the-results-of-trigger-macro-by-name/4369/9|Limit the results of Trigger Macro by Name]] | - [[https://forum.keyboardmaestro.com/t/limit-the-results-of-trigger-macro-by-name/4369/9|Limit the results of Trigger Macro by Name]] | ||
| - | - [[https://www.google.fr/search?q=site:forum.keyboardmaestro.com+Trigger+Macro+by+Name+Action|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]] |
| - | + | ||
| - | ==== External References ==== | + | |
action/Trigger_Macro_by_Name.1468912339.txt.gz · Last modified: 2016/07/19 03:12 by alain
Page Tools
