Differences

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

--- manual:Editor_Window [2019/06/21 01:24]
peternlewis
+++ manual:Editor_Window [2019/06/21 02:06]
peternlewis
@@ Line 1: / Line 1: @@
 ====== Editor Window ======
-To edit your macros, launch the Keyboard Maestro application.  It will display one or more Editor Windows.
+To edit your macros, launch the Keyboard Maestro application.  It will display one or more Editor Windows.  If you close the last editor window, the Keyboard Maestro application will quit, but the Keyboard Maestro Engine will continue running to perform your macros.  Normally you only launch the Keyboard Maestro editor application when you want to change your macros, and leave only the Keyboard Maestro Engine running normally.
 You can create a new editor window by choosing the [[Menus#New_Editor_Window|File ➤ New Editor Window menu]].
@@ Line 29: / Line 29: @@
 {{ smart-group-marked.png?nolink&937x465 | Smart Group Editor }}
+You can adjust the name of the Smart Group (1), and adjust its [[Search_Strings|Search Strings]] (2).
+You can add another Search String by clicking the green BUTTON{{{+}}} button.
 When you are in Edit Mode, and you select a Macro Group, you can edit its configuration.
 {{ macro-group-marked.png?nolink&937x584 | Macro Group Editor }}
+You can adjust the name of the Macro Group (1).
+For a Macro to be available to trigger, it must be enabled and its parent Macro Group must be enabled, and active.  The configurations for the Macro Group control when it will be active, and thus when the macros it contains will be active (available to be triggered and executed).
+You can adjust whether the macro group is enabled (2), whether it is only active in some specific applications (3) (ie, when they are at the front, and their menu bar is showing), whether it is only active in specific windows (4), whether it is only active when you explicitly toggle it on or off, and whether and how it shows a palette containing its macros (5).
 When you are in Edit Mode and you select a Macro, you can edit its behaviour.
 {{ macro-editor-marked.png?nolink&937x694 | Macro Editor }}
+You can adjust the name of the Macro (1), and whether it is enabled (2) (a macro must be enabled for it to be available to be triggered (executed) - its parent macro group must also be enabled and active).
+A macro consists of a set of triggers (3).  When it is active, if any of these [[Macro_Triggers|triggers]] happen, then the macro executes the [[Macro_Actions|actions]] (5).
+You can add a trigger by clicking and holding on the green BUTTON{{{+}}} button (4) and selecting the kind of trigger you would like to use.
+Some triggers, like the [[trigger:Status_Menu|Status Menu]] trigger, do not have any additional configuration.  Simply adding them to the macro will have macro triggered when the event happens (in this case, the macro will be listed in the Keyboard Maestro status menu, and will be triggered if you choose it from that menu).
+Other triggers, like the [[trigger:Typed_String|Typed String]] trigger, require you to configure more details about when the trigger should happen, such as the specific string you have to type to trigger the macro.  For the macro shown, the macro will be triggered when you type the string “=-=”.
+When a macro is triggered, it will execute the actions you have specified (5).
+You can add a new action by clicking the BUTTON{{{New Action}}} button or the BUTTON{{{+}}} button at the bottom of the macro detail view (6) to display the list of actions or by choosing the [[Menus#Insert_Action_by_Name|Edit ➤ Insert Action By Name menu]] or choosing from the [[Menus#Insert_Action|Edit ➤ Insert Action menu]].
+In the displayed macro, the action uses the [[token:SystemClipboard|%SystemClipboard%]] token to read the system clipboard, and will then insert it by typing (rather than the normal pasting for the System Clipboard).  This can be useful for cases where you are disallowed from pasting for some reason.

Keyboard Maestro Wiki

User Tools

Site Tools

Differences

Page Tools