Differences

This shows you the differences between two versions of the page.

--- action:Trigger_Macro_by_Name [2016/07/29 19:38] – ADD: How to use, filters, screenshots, icon JMichaelTX
+++ action:Trigger_Macro_by_Name [2022/11/09 10:30] (current) – Added documentation for using ⌥ with the Trigger Macro by Name action ChrisLozach
@@ Line 1: / Line 1: @@
-{{:search-find-magnify-icon.png?nolink|}}
 ====== Trigger Macro by Name Action ======
-The //**Trigger Macro by Name**// [[:Actions|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 displays 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.
-===== How To Use =====
+{{ trigger-macro-by-name.png?nolink&575x141 | File Name }}
+===== 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**// [[:Actions|Action]]\\ .
+    - 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.
@@ Line 21: / Line 26: @@
       - 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:
+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"
@@ Line 36: / Line 50: @@
 For the complete list of available filters, see [[manual:Search_Strings|Search Strings]]
-===== See Also =====
+===== 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 ===
 * [[:Actions|See all Actions]]
@@ Line 46: / Line 62: @@
 ==== Topics ====
-* [[:manual:Windows#Macro Editor Window|Macro Editor Window]]
 * [[:manual:Search Strings|Search Strings]]
-* [[:Frequently Asked Questions|FAQ]]
-----
 ==== Forum ====
@@ Line 56: / 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://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 ====