User Tools

Site Tools


manual:Menus

Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
manual:Menus [2019/06/18 03:16]
peternlewis [Record Without Delay]
manual:Menus [2023/10/16 03:18] (current)
peternlewis [Move Action Down]
Line 1: Line 1:
-{{:​manual:​menu-icon.png?​nolink|}} +====== Menus ======
-====== ​Keyboard Maestro App Menus ======+
  
 Below is a complete list of all menus. ​ Note that in some cases you must hold down the Option Key <​kbd>​⌥</​kbd>​ (or <​kbd>​Alt</​kbd>​ or <​kbd>​Opt</​kbd>​) to see the menu item.  For example, the "​Expand All Actions"​ item in the Actions menu. Below is a complete list of all menus. ​ Note that in some cases you must hold down the Option Key <​kbd>​⌥</​kbd>​ (or <​kbd>​Alt</​kbd>​ or <​kbd>​Opt</​kbd>​) to see the menu item.  For example, the "​Expand All Actions"​ item in the Actions menu.
Line 22: Line 21:
 ==== Register Keyboard Maestro ==== ==== Register Keyboard Maestro ====
  
-The *Register Keyboard Maestro* command in the *Keyboard Maestro* menu displays the serial number entry window allowing you to enter your username (email address) and serial number. ​ Make sure you enter them exactly as sent to you.  If your email address shows up as “Registered to” in the About Keyboard Maestro box, then you are already registered.+The *Register Keyboard Maestro* command in the *Keyboard Maestro* menu displays the serial number entry window allowing you to enter your username (email address) and serial number. ​ Make sure you enter them exactly as sent to you.  If your email address shows up as “Registered to” in the About Keyboard Maestro box, then you are already registered. ​ If your license does not work, ensure that you are entering the username and serial number exactly as shown, that there are no extra invisible characters included, and that your license matches the major version of Keyboard Maestro that you are using. 
 + 
 +==== Deregister or Reregister Keyboard Maestro ==== 
 + 
 +The *Deregister or Reregister Keyboard Maestro* command in the *Keyboard Maestro* menu lets you remove the registration from Keyboard Maestro and then optionally re-register. You could do this if you are getting rid of the Mac (though you would generally simply erase the Mac in that case). Hold the Option key down to select this menu item. 
 + 
  
 ==== Check For Update ==== ==== Check For Update ====
Line 30: Line 35:
 ==== Preferences ==== ==== Preferences ====
  
-The *Preferences* command in the *Keyboard Maestro* menu displays the [[Windows#​Preferences_Window|Preferences window]].+The *Preferences* ​(or *Settings*) ​command in the *Keyboard Maestro* menu displays the [[Windows#​Preferences_Window|Preferences window]].
  
 ==== Services ==== ==== Services ====
  
-The *Services* command in the *Keyboard Maestro* menu is used to perform Mac~~OS~~X Services which are shared functions available across multiple applications. ​ You can learn more about Mac~~OS~~X Services from your Mac~~OS~~X documentation,​ and you can install new services which will work with Keyboard~~Maestro. ​ Keyboard~~Maestro includes full support for Services, so relevant Services on your system are available in Keyboard~~Maestro.+The *Services* command in the *Keyboard Maestro* menu is used to perform Mac~~OS~~X Services which are shared functions available across multiple applications. ​ You can learn more about Mac~~OS~~X Services from your Mac~~OS~~X documentation,​ and you can install new services which will work with Keyboard~~Maestro. ​ Keyboard~~Maestro includes full support for Services, so relevant Services on your system are available in Keyboard~~Maestro. ​You can also export a macro as a Text Service to have it available here (and for other applications). 
 + 
  
 ==== Hide Keyboard Maestro ==== ==== Hide Keyboard Maestro ====
Line 48: Line 54:
 The *Show All* command in the *Keyboard Maestro* menu will show all hidden applications. The *Show All* command in the *Keyboard Maestro* menu will show all hidden applications.
  
-==== Quit Keyboard Maestro ====+==== Quit Keyboard Maestro ​Editor ​====
  
-The *Quit Keyboard Maestro* command in the *Keyboard Maestro* menu will Quit Keyboard~~Maestro. ​ The Keyboard~~Maestro~~Engine will remain running and all enabled Keyboard~~Maestro features will continue to operate (unless you have specifically quit the Keyboard~~Maestro~~Engine).+The *Quit Keyboard Maestro ​Editor* command in the *Keyboard Maestro* menu will Quit Keyboard~~Maestro. ​ The Keyboard~~Maestro~~Engine will remain running and all enabled Keyboard~~Maestro features will continue to operate (unless you have specifically quit the Keyboard~~Maestro~~Engine).
  
 ===== File ===== ===== File =====
Line 67: Line 73:
  
 The *New Macro* command in the *File* menu creates and starts editing a new macro. The *New Macro* command in the *File* menu creates and starts editing a new macro.
 +
 +==== New Macro Wizard ====
 +
 +The *New Macro Wizard* command in the *File* menu lets you quickly outline the macro and then creates and starts editing the new macro.
  
 ==== New Editor Window ==== ==== New Editor Window ====
Line 87: Line 97:
  
 The *Share* menu in the *File* menu lets you share the selected macro group, macro or actions with any appropriate sharing service on your Mac, including sharing to the [[https://​forum.keyboardmaestro.com|forum]]. ​ If you hold the Shift key down before starting your menu selection you can share just an image of the selection, which will allow you to share to services that only allow selection of images. The *Share* menu in the *File* menu lets you share the selected macro group, macro or actions with any appropriate sharing service on your Mac, including sharing to the [[https://​forum.keyboardmaestro.com|forum]]. ​ If you hold the Shift key down before starting your menu selection you can share just an image of the selection, which will allow you to share to services that only allow selection of images.
 +
 ==== Export Actions ==== ==== Export Actions ====
  
-The *Export Actions* command in the *File* menu exports the selected actions to a file that you can import later or on another Mac or send to others.+The *Export Actions* command ​in the *Export* sub-menu ​in the *File* menu exports the selected actions to a file that you can import later or on another Mac or send to others. 
 ==== Export Macros ==== ==== Export Macros ====
  
-The *Export Macros* command in the *File* menu exports the selected macros to a file that you can import on another Mac.  This is one way to transfered ​macros from one Mac to another or to share macros with friends or colleagues.+The *Export Macros* command ​in the *Export* sub-menu ​in the *File* menu exports the selected macros to a file you can import on another Mac.  This is one way to transfer ​macros from one Mac to another or to share macros with friends or colleagues.
  
 +If a Macro Group is selected and **no** macros are selected then the entire Macro Group is exported as a single `.kmmacros` file.
 ==== Export as Macro Library ==== ==== Export as Macro Library ====
  
-The *Export as Macro Library* command in the *File* menu exports the selected macros to a library file that you can share with others. ​ If you create any interesting macros please consider sending them to us and we will make them available on our web site or in a future version of Keyboard Maestro.+The *Export as Macro Library* command ​in the *Export* sub-menu ​in the *File* menu exports the selected macros to a library file that you can share with others. ​ If you create any interesting macros please consider sending them to us and we will make them available on our web site or in a future version of Keyboard Maestro.
  
 See also the [[Macro Library]] section. See also the [[Macro Library]] section.
  
 Note that you should generally only export as library if you want to import the macros multiple times. ​ Otherwise just exporting the macros is sufficient. Note that you should generally only export as library if you want to import the macros multiple times. ​ Otherwise just exporting the macros is sufficient.
 +
 +==== Export as Folder ====
 +
 +The *Export as Folder* command in the *Export* sub-menu in the *File* menu exports the selected macros to a folder containing macro group folders and individual macro export files. You can use this to preserve your macros in a version history structure or for archiving purposes.
 +
 +==== Export All Macros as Folder ====
 +
 +The *Export All Macros as Folder* command in the *Export* sub-menu in the *File* menu exports all of your macros to a folder containing macro group folders and individual macro export files. You can use this to preserve all of your macros in a version history structure or for archiving purposes.
  
 ==== Export as Trigger File ==== ==== Export as Trigger File ====
  
-The *Export as Trigger File* command in the *File* menu lets you save a file that will trigger a macro when opened (that is, a file you can open in the Finder to trigger a macro).+The *Export as Trigger File* command ​in the *Export* sub-menu ​in the *File* menu lets you save a file that will trigger a macro when opened (that is, a file you can open in the Finder to trigger a macro)
 + 
 +==== Export as Text Service ==== 
 + 
 +The *Export as Text Service* command in the *Export* sub-menu in the *File* menu lets you save a Text Service that will trigger a macro when selected in the Services menu. The incoming text is available in the [[token:​TriggerValue|%TriggerValue%]] token. 
 + 
 +==== Export as Finder Quick Action ==== 
 + 
 +The *Export as Finder Quick Action* command in the *Export* sub-menu in the *File* menu lets you save a Finder Quick Action that will trigger a macro when selected in the Quick Action contextual menu. The incoming file path is available in the [[token:​TriggerValue|%TriggerValue%]] token.
  
 ==== Import Actions ==== ==== Import Actions ====
  
-The *Import Actions* command in the *File* menu lets you select a saved action file and imports the actions it contains into the current macro.+The *Import Actions* command ​in the *Import* sub-menu ​in the *File* menu lets you select a saved action file and imports the actions it contains into the current macro.
  
-==== Import Macros ​Safe ====+==== Import Macros ​Safely ​====
  
-The *Import Macros ​Safe* command in the *File* menu lets you select a saved macro file and imports the macros it contains, disabling them (either disabling created macro groups, or disabling the contained macros as appropriate).+The *Import Macros ​Safely* command ​in the *Import* sub-menu ​in the *File* menu lets you select a saved macro file and imports the macros it contains, disabling them (either disabling created macro groups, or disabling the contained macros as appropriate).
  
 If you do not completely trust the source of the macros, you should import them this way. If you do not completely trust the source of the macros, you should import them this way.
Line 118: Line 147:
 ==== Import Macros ==== ==== Import Macros ====
  
-The *Import Macros* command in the *File* menu lets you select a saved macro file and imports the macros it contains. ​ Hold the Option key down to select this menu item.  Macros imported this way could trigger immediately,​ so use this command only if you completely trust the source of the macros.+The *Import Macros* command ​in the *Import* sub-menu ​in the *File* menu lets you select a saved macro file and imports the macros it contains. ​ Hold the Option key down to select this menu item.  Macros imported this way could trigger immediately,​ so use this command only if you completely trust the source of the macros.
  
 ==== Import to Macro Library ==== ==== Import to Macro Library ====
  
-The *Import to Macro Library* command in the *File* menu lets you import a shared macro library file into your macro library. ​ Macros in your library are not active, but can be added into one or more macro groups to become active.+The *Import to Macro Library* command ​in the *Import* sub-menu ​in the *File* menu lets you import a shared macro library file into your macro library. ​ Macros in your library are not active, but can be added into one or more macro groups to become active.
  
 See also the [[Macro Library]] section. See also the [[Macro Library]] section.
Line 150: Line 179:
 ==== Launch Engine ==== ==== Launch Engine ====
  
-The *Launch Engine* command in the *File* menu lets you start the Keyboard~~Maestro~~Engine manually. ​ The Keyboard~~Maestro~~Engine performs all the Macro, Application~~Switcher,​ Window~~Switcher and Clipboard~~Switcher functions even while Keyboard~~Maestro itself is not running. ​ It is launched automatically as a Startup Item when you login (assuming you have enabled that in the [[Windows#​Preferences_Window|Preferences window]]) or any time you launch Keyboard~~Maestro. ​ If it is not running for any reason you can start it manually with this command. This menu item only exists ​while the Keyboard~~Maestro~~Engine is not running.+The *Launch Engine* command in the *File* menu lets you start the Keyboard~~Maestro~~Engine manually. ​ The Keyboard~~Maestro~~Engine performs all the Macro, Application~~Switcher,​ Window~~Switcher and Clipboard~~Switcher functions even while Keyboard~~Maestro itself is not running. ​ It is launched automatically as a Startup Item when you login (assuming you have enabled that in the [[Windows#​Preferences_Window|Preferences window]]) or any time you launch Keyboard~~Maestro. ​ If it is not running for any reason you can start it manually with this command. This menu item only appears ​while the Keyboard~~Maestro~~Engine is not running.
  
 ==== Quit Engine ==== ==== Quit Engine ====
  
-The *Quit Engine* command in the *File* menu lets you quit the Keyboard~~Maestro~~Engine. ​ The Keyboard~~Maestro~~Engine performs all the Macro, Application~~Switcher,​ Window~~Switcher and Clipboard~~Switcher functions even while Keyboard~~Maestro itself is not running. ​ It is launched automatically as a Startup Item when you login (assuming you have enabled that in the [[Windows#​Preferences_Window|Preferences window]]). ​ If you quit the Keyboard~~Maestro~~Engine these functions will no longer operate. ​ This menu item only exists ​while the Keyboard~~Maestro~~Engine is running.+The *Quit Engine* command in the *File* menu lets you quit the Keyboard~~Maestro~~Engine. ​ The Keyboard~~Maestro~~Engine performs all the Macro, Application~~Switcher,​ Window~~Switcher and Clipboard~~Switcher functions even while Keyboard~~Maestro itself is not running. ​ It is launched automatically as a Startup Item when you login (assuming you have enabled that in the [[Windows#​Preferences_Window|Preferences window]]). ​ If you quit the Keyboard~~Maestro~~Engine these functions will no longer operate. ​ This menu item only appears ​while the Keyboard~~Maestro~~Engine is running. 
 ===== Edit ===== ===== Edit =====
  
Line 194: Line 224:
  
 The *Copy UUID* command in the *Copy as* sub-menu in the *Edit* menu menu allows you to copy the selected macro or macro group’s UUID (Universally Unique ID). The *Copy UUID* command in the *Copy as* sub-menu in the *Edit* menu menu allows you to copy the selected macro or macro group’s UUID (Universally Unique ID).
 +
 +==== Copy as Execute a Macro Action ====
 +
 +The *Copy as Execute a Macro Action* command in the *Copy as* sub-menu in the *Edit* menu menu allows you to copy the selected macro as an [[action:​Execute_a_Macro|Execute a Macro]] action.
 +
 +==== Copy as Execute a Subroutine Action ====
 +
 +The *Copy as Execute a Subroutine Action* command in the *Copy as* sub-menu in the *Edit* menu menu allows you to copy the selected macro as an [[action:​Execute_a_Subroutine |Execute a Subroutine]] action.
 +
 +
 +==== Copy as Mark Macro Action ====
 +
 +The *Copy as Mark Macro Action* command in the *Copy as* sub-menu in the *Edit* menu menu allows you to copy the selected macro as a [[action:​Mark_Macro|Mark Macro]] action.
 +
 +==== Copy as Set Macro Enabled Action ====
 +
 +The *Copy as Set Macro Enabled Action* command in the *Copy as* sub-menu in the *Edit* menu menu allows you to copy the selected macro as a [[action:​Set_Macro_or_Group_Enable|Set Macro Enable]] action.
 +
 +==== Copy as Set Macro Group Enabled Action ====
 +
 +The *Copy as Set Macro Group Enabled Action* command in the *Copy as* sub-menu in the *Edit* menu menu allows you to copy the selected macro as a [[action:​Set_Macro_or_Group_Enable|Set Macro Group Enable]] action.
 +
 +==== Copy as Toggle Macro Group Action ====
 +
 +The *Copy as Toggle Macro Group Action* command in the *Copy as* sub-menu in the *Edit* menu menu allows you to copy the selected macro as a [[action:​Activate_Macro_Group|Toggle Macro Group Activation]] action.
  
 ==== Paste ==== ==== Paste ====
  
 The *Paste* command in the *Edit* menu pastes the current system clipboard into the current selection. The *Paste* command in the *Edit* menu pastes the current system clipboard into the current selection.
- 
  
 ==== Delete ==== ==== Delete ====
Line 211: Line 265:
  
 The *Deselect All* command in the *Edit* menu deselects all text or items. ​ Hold the Option key down to select this menu item. The *Deselect All* command in the *Edit* menu deselects all text or items. ​ Hold the Option key down to select this menu item.
 +
 ==== Duplicate ==== ==== Duplicate ====
  
Line 220: Line 275:
  
 You may also use <​key>​⌘</​key>​L or Drag/Drop with <​key>​⌘⌥</​key>​ to another Macro Group. You may also use <​key>​⌘</​key>​L or Drag/Drop with <​key>​⌘⌥</​key>​ to another Macro Group.
- 
  
 ==== Insert Action ==== ==== Insert Action ====
  
 The *Insert Action* command in the *Edit* menu lets you insert any of the many [[Macro Actions|actions]] available in Keyboard~~Maestro. The *Insert Action* command in the *Edit* menu lets you insert any of the many [[Macro Actions|actions]] available in Keyboard~~Maestro.
 +
 +Hold the Option key down to get help on the action.
 +
 +Hold the Shift key down to insert the action above the selected action.
 +
  
 ==== Insert Action by Name ==== ==== Insert Action by Name ====
  
 The *By Name* command in the *Edit ➤ Insert Action* menu lets you insert any of the many [[Macro Actions|actions]] available in Keyboard~~Maestro by name. The *By Name* command in the *Edit ➤ Insert Action* menu lets you insert any of the many [[Macro Actions|actions]] available in Keyboard~~Maestro by name.
 +
 +{{ :​manual:​insert-action-by-name-tool-small.png?​nolink |}}
 +
 +While double clicking or pressing Return, hold the Option key down to get help on the action or hold the Shift key down to insert the action above the selected action.
  
 ==== Insert Function ==== ==== Insert Function ====
Line 235: Line 298:
  
 Most numeric fields in Keyboard Maestro can process an expression containing these functions. ​ These fields are indicated either by having up/down steppers, or a BUTTON{{{C}}} in the field while editing. Most numeric fields in Keyboard Maestro can process an expression containing these functions. ​ These fields are indicated either by having up/down steppers, or a BUTTON{{{C}}} in the field while editing.
 +
 +Hold the Option key down to get help on the function.
  
 ==== Insert Function by Name ==== ==== Insert Function by Name ====
  
 The *By Name* command in the *Edit ➤ Insert Function* menu lets you insert any of the many [[Calculations|functions]] available in Keyboard~~Maestro by name. The *By Name* command in the *Edit ➤ Insert Function* menu lets you insert any of the many [[Calculations|functions]] available in Keyboard~~Maestro by name.
 +
 +Hold the Option key down to get help on the function.
  
 ==== Insert Token ==== ==== Insert Token ====
Line 245: Line 312:
  
 Most text fields in Keyboard Maestro can process Tokens. ​ These fields are indicated by having a BUTTON{{{T}}} in the field while editing. Most text fields in Keyboard Maestro can process Tokens. ​ These fields are indicated by having a BUTTON{{{T}}} in the field while editing.
 +
 +Hold the Option key down to get help on the token.
 +
 +Hold the Shift key down to show the raw token.
  
 ==== Insert Token by Name ==== ==== Insert Token by Name ====
  
 The *By Name* command in the *Edit ➤ Insert Token* menu lets you insert any of the many [[Tokens|tokens]] available in Keyboard~~Maestro by name. The *By Name* command in the *Edit ➤ Insert Token* menu lets you insert any of the many [[Tokens|tokens]] available in Keyboard~~Maestro by name.
 +
 +Hold the Option key down to get help on the token.
  
 ==== Insert Variable ==== ==== Insert Variable ====
Line 257: Line 330:
  
 The *By Name* command in the *Edit ➤ Insert Variable* menu lets you insert any of your variables by name. The *By Name* command in the *Edit ➤ Insert Variable* menu lets you insert any of your variables by name.
 +
 +==== Insert ICU Date Field ====
 +
 +The *Insert ICU Date Field* sub-menu in the *Edit* menu lets you insert any of the many fields available in [[token:​ICUDateTime|%ICUDateTime%]] token.
 +
 +Hold the Shift key down to show the raw field.
 +
 +==== Insert ICU Date Field by Name ====
 +
 +The *By Name* command in the *Edit ➤ Insert ICU Date Field* menu lets you insert any of the many fields available in [[token:​ICUDateTime|%ICUDateTime%]] token in Keyboard~~Maestro by name.
  
 ==== Automatic Completions ==== ==== Automatic Completions ====
Line 262: Line 345:
 The *Automatic Completions* command in the *Edit* menu lets you toggle automatic text completion. ​ When off, you can still complete variables, tokes, and functions by pressing F5. The *Automatic Completions* command in the *Edit* menu lets you toggle automatic text completion. ​ When off, you can still complete variables, tokes, and functions by pressing F5.
  
 +==== Find ====
 +
 +The *Find* menu in the *Edit* menu lets find things in Keyboard Maestro.
 +
 +The *Find…* menu item will select the search field in the Keyboard Maestro editor window.
 +
 +The *Find in All Macros…* menu item will select the search field in the Keyboard Maestro editor window and select the All Macros Smart Group to search all the macros.
  
 ===== View ===== ===== View =====
Line 286: Line 376:
  
 The *Date Used* command in the *View ➤ Sort Macros by* menu sorts the macros in the main window by date used (most recently executed at the top).  This is useful to see what macros you have recently executed, especially if you think one might have been executed inadvertently. ​ You can also use the BUTTON{{{⌘}}} button at the top of the macro editor to show the recently used macros. The *Date Used* command in the *View ➤ Sort Macros by* menu sorts the macros in the main window by date used (most recently executed at the top).  This is useful to see what macros you have recently executed, especially if you think one might have been executed inadvertently. ​ You can also use the BUTTON{{{⌘}}} button at the top of the macro editor to show the recently used macros.
 +
 +==== Sort Macros by Size ====
 +
 +The *Size* command in the *View ➤ Sort Macros by* menu sorts the macros in the main window by approximate storage size, with the largest at the top. Typically it is not the number of actions in a macro that makrs a macro large, instead it is usually included images. If your macro file gets very large, this can slow the performance of the Keyboard Maestro editor (though generally it will not affect the performance of the Keyboard Maestro Engine). Sorting the macros by size can find the larger macros.
  
 ==== Sort Macros by Use Count ==== ==== Sort Macros by Use Count ====
Line 305: Line 399:
 ==== Select Macros Column ==== ==== Select Macros Column ====
  
-The *Select ​Group Column* command in the *View* menu focuses on the Macros column.+The *Select ​Macros ​Column* command in the *View* menu focuses on the Macros column.
  
-==== Select ​Macro ====+==== Go to Macro ====
  
-The *Select ​Macro* menu in the *View* menu lets you select a recently edited or used macro.+The *Go to Macro* menu in the *View* menu lets you select a recently edited or used macro.
  
-==== Select ​Macro by Name ====+==== Go to Macro by Name ====
  
-The *By Name* menu in the *View ➤ Select ​Macro* menu lets you select a macro by name.+The *By Name* menu in the *View ➤ Go to Macro* menu lets you select a macro by name.
  
-==== Select Macro Last Used ====+==== Go to Last Used ====
  
-The *Last Used* menu in the *View ➤ Select ​Macro* menu lets you select the most recently triggered macro.+The *Last Used* menu in the *View ➤ Go to Macro* menu lets you select the most recently triggered macro.
  
-==== Select Macro Last Edited ====+==== Go to Last Edited ====
  
-The *Last Edited* menu in the *View ➤ Select ​Macro* menu lets you select the most recently edited macro.+The *Last Edited* menu in the *View ➤ Go to Macro* menu lets you select the most recently edited macro.
  
-==== Select Macro Previous Edited ====+==== Go to Previous Edited ====
  
-The *Previous Edited* menu in the *View ➤ Select ​Macro* menu lets you select the previous edited macro (edited macros form a list, and this moves backward along the list).+The *Previous Edited* menu in the *View ➤ Go to Macro* menu lets you select the previous edited macro (edited macros form a list, and this moves backward along the list).
  
-==== Select Macro Next Edited ====+==== Go to Next Edited ====
  
 The *Next Edited* menu in the *View ➤ Select Macro* menu lets you select the next edited macro (edited macros form a list, and this moves forward along the list). The *Next Edited* menu in the *View ➤ Select Macro* menu lets you select the next edited macro (edited macros form a list, and this moves forward along the list).
 +
 +==== Go to Aborted Action ====
 +
 +The *Go to Last Aborted Action* menu in the *View* menu selects the macro and the last action that failed and aborted a macro.
  
 ==== Reveal Parent Group ==== ==== Reveal Parent Group ====
Line 342: Line 440:
  
 The *Hide Disabled Macro Groups* command in the *View* menu hides all disabled macro groups in the Macro Groups column. ​ Instead, a single placeholder group is shown that “contains” all the disabled Macro Groups. ​ You can double click the Disabled Macro Groups placeholder to temporarily reveal the disabled macro groups. ​ You can show all the disabled Macro Groups with the *Show Disabled Macro Groups* command. The *Hide Disabled Macro Groups* command in the *View* menu hides all disabled macro groups in the Macro Groups column. ​ Instead, a single placeholder group is shown that “contains” all the disabled Macro Groups. ​ You can double click the Disabled Macro Groups placeholder to temporarily reveal the disabled macro groups. ​ You can show all the disabled Macro Groups with the *Show Disabled Macro Groups* command.
 +
 +==== Evaluate Condition Results ====
 +
 +The *Evaluate Condition Results* command in the *View* menu toggles whether the editor evaluates conditions in macros it is displaying. If it does, macros with conditions will display their current value in real time in the editor (eg “(currently true)”). If not, they will display “(click for result)” and you can click on that to enable the Evaluate Condition Results facility.
 +
 +Note that evaluating results may have a performance issue if the results are complex to evaluate (eg searching the screen).
 +
 +This facility is turned off when you import a macro safely to ensure that scripts in conditions do not get to execute before you have a chance to verify their safety.
  
 ==== Enable ==== ==== Enable ====
Line 370: Line 476:
  
 The *Record Without Delay* command in the *View* menu toggles recording on and off immediately (without the normal short countdown). ​ It is available while editing a macro. ​ Hold the shift key down to select the menu. The *Record Without Delay* command in the *View* menu toggles recording on and off immediately (without the normal short countdown). ​ It is available while editing a macro. ​ Hold the shift key down to select the menu.
 +
 +==== Enter Full Screen ====
 +
 +The *Enter Full Screen* command in the *View* menu will expand the window to full screen.
  
 ===== Actions ===== ===== Actions =====
Line 377: Line 487:
 ==== Show Actions ==== ==== Show Actions ====
  
-The *Show Actions* command in the *Actions* menu shows the action list.  It is available while editing a macro. ​ Double click or drag actions from the action list to add them to your macro. ​ This menu toggles to Hide~~Actions when the action list is already showing.  ​You alternatively also choose *Insert Action by Name* from the *Edit* menu to insert actions by name or use the *Insert Action* menu in the *Edit* to select actions.+The *Show Actions* command in the *Actions* menu shows the action list.  It is available while editing a macro. ​ Double click or drag actions from the action list to add them to your macro. ​ This menu toggles to Hide~~Actions when the action list is already showing.  ​Alternatively you can choose *Insert Action by Name* from the *Edit* menu to insert actions by name or use the *Insert Action* menu in the *Edit* to select actions.
  
 ==== Try ==== ==== Try ====
Line 397: Line 507:
 ==== Set Color ==== ==== Set Color ====
  
-The *Set Color* menu in the *Actions* menu sets the color of actions.+The *Set Color* menu in the *Actions* menu sets the color of actions.  
 + 
 +Note: A blue striped color is reserved to mark the action as a match for the current search.
  
 ==== Set Note ==== ==== Set Note ====
  
 The *Set Note* command in the *Actions* menu sets the notes of actions. The *Set Note* command in the *Actions* menu sets the notes of actions.
- 
-==== Copy as Text ==== 
- 
-The *Copy as Text* command in the *Actions* menu copies the selected actions as text. 
- 
-==== Copy as Image ==== 
- 
-The *Copy as Image* command in the *Actions* menu copies the selected actions as an image. 
- 
-==== Copy as XML ==== 
- 
-The *Copy as XML* command in the *Actions* menu copies the selected actions as XML. 
  
 ==== Paste Above ==== ==== Paste Above ====
Line 427: Line 527:
 The *Paste Replacing* command in the *Actions* menu pastes previously copied actions, replacing the selected actions. The *Paste Replacing* command in the *Actions* menu pastes previously copied actions, replacing the selected actions.
  
-==== Duplicate ​====+==== Move Action Up ====
  
-The *Duplicate* command in the the *Actions* menu duplicates ​the selected ​actions.+The *Move Action Up* command in the *Actions* moves the selected actions before the action proceeding the first selected action. 
 + 
 +==== Move Action Down ==== 
 + 
 +The *Move Action Down* command in the *Actions* moves the selected action(s) after the action following the last selected action. 
 + 
 +==== Add to Favorites ==== 
 + 
 +The *Add to Favorites* command in the the *Actions* menu adds the currently ​selected ​action(s) as a Favorite action which you can insert later. The favorite action saves all the current action configuration.
  
 ==== Engroup ==== ==== Engroup ====
Line 501: Line 609:
 ==== Keyboard Maestro Editor ==== ==== Keyboard Maestro Editor ====
  
-The *Keyboard Maestro Editor* command in the *Window* menu brings the main Keyboard Maestro macro editing window to the front.+The *Keyboard Maestro Editor* command in the *Window* menu brings the frontmost ​Keyboard Maestro macro editing window to the front.
  
 ==== Macro Library ==== ==== Macro Library ====
Line 523: Line 631:
 ==== Mouse Display ==== ==== Mouse Display ====
  
-The *Mouse Display* command in the *Window* menu shows or hides the Mouse Display.+The *Mouse Display* command in the *Window* menu shows or hides the Mouse Display, which shows the mouse location in real time.
  
 See also the [[Windows#​Mouse_Display_Window|Mouse Display Window]] section. See also the [[Windows#​Mouse_Display_Window|Mouse Display Window]] section.
 +
 +==== Value Inspector ====
 +
 +The *Value Inspector* command in the *Window* menu shows or hides the Value Inspector, which shows values of variables, tokens, calculations,​ or clipboards that you can select.
 +
 +See also the [[Windows#​Value_Inspector_Window| Value Inspector Window]] section.
  
 ==== Bring All to Front ==== ==== Bring All to Front ====
Line 533: Line 647:
 ===== Help ===== ===== Help =====
  
-The *Help* menu contains menu items relating to Help.  ​You can also use the search field in this menu to find help on the wiki.+The *Help* menu contains menu items relating to Help.  ​
  
-==== Keyboard Maestro Documentation ====+You can use the search field in this menu to find menus or help on any topic in the wiki.
  
-The *Keyboard Maestro ​Documentation* command in the *Help* menu displays the Keyboard~~Maestro ​documentation web site.+==== Interactive Help ==== 
 + 
 +The *Interactive Help* command in the *Help* menu starts the in-application assistance system. ​ If you're having trouble with something not working the way you expect, this system may help you find out where the problem is, or offer suggestions for other sources of assistance. 
 + 
 +==== Keyboard Maestro ​User Manual ==== 
 + 
 +The *Keyboard Maestro User Manual* command in the *Help* menu displays the Keyboard~~Maestro ​user manual on the Keyboard Maestro Wiki.
  
 ==== Keyboard Maestro Quick Start ==== ==== Keyboard Maestro Quick Start ====
Line 566: Line 686:
  
 The *Tutorial* command in the *Help* menu starts the in-application tutorial. ​ The tutorial will walk you through creating a simple macro. ​ By varying the actions slightly, you can create a variety of macros that are triggered by hot keys and that open various documents. The *Tutorial* command in the *Help* menu starts the in-application tutorial. ​ The tutorial will walk you through creating a simple macro. ​ By varying the actions slightly, you can create a variety of macros that are triggered by hot keys and that open various documents.
- 
-==== Assistance ==== 
- 
-The *Assistance* command in the *Help* menu starts the in-application assistance system. ​ If you're having trouble with something not working the way you expect, this system may help you find out where the problem is, or offer suggestions for other sources os assistance. 
  
 ==== Practice Gestures ==== ==== Practice Gestures ====
  
 The *Practice Gestures* command in the *Help* menu starts the gesture system and lets you practice gestures, to ensure you can reliably trigger [[trigger:​Gesture|Gesture triggered]] macros. The *Practice Gestures* command in the *Help* menu starts the gesture system and lets you practice gestures, to ensure you can reliably trigger [[trigger:​Gesture|Gesture triggered]] macros.
 +
 +==== Show Active Macro Groups ====
 +
 +The *Show Active Macro Groups* command in the *Help* menu shows a palette that lists the current active macro groups. You can use this palette to see which macro groups are active (which means the enabled macros they contain are active).
  
 ==== ICU Date Format References ==== ==== ICU Date Format References ====
Line 586: Line 706:
  
 The *Regular Expression Unicode Properties* command in the *Help* menu takes you to the Regular Expression Unicode Properties web site. The *Regular Expression Unicode Properties* command in the *Help* menu takes you to the Regular Expression Unicode Properties web site.
 +
 +==== MacSparky Field Guide ====
 +
 +The *MacSparky Field Guide* command in the *Help* menu takes you to the [[https://​learn.macsparky.com/​p/​km|MacSparky Field Guide]], a high quality, tech-savvy, video tutorial on using Keyboard Maestro from David Sparks.
 +
 +==== Elgato Stream Deck Details ====
 +
 +The *Elgato Stream Deck Details* command in the *Help* menu takes you to the [[/Stream Deck]] page, which includes details about installing the plugin and working with a Stream Deck from Keyboard Maestro.
  
 ==== Third Party Licenses ==== ==== Third Party Licenses ====
Line 623: Line 751:
 ==== Activate Clipboard History Switcher ==== ==== Activate Clipboard History Switcher ====
  
-The *Activate Clipboard History Switcher* command ​in the *Paste* menu in the *Status Menu* menu lets you activate the [[manual:​Clipboard_History_Switcher|Clipboard History Switcher]].+The *Activate Clipboard History Switcher* command in the *Status Menu ➤ Paste* menu lets you activate the [[manual:​Clipboard_History_Switcher|Clipboard History Switcher]]. 
 ==== Your Macros ==== ==== Your Macros ====
  
Line 629: Line 758:
  
 This is great for less frequently used macros that you will not remember a hot key or other trigger, as well as for macros that *feel like* they should be menu commands, such as actions that *perform* a complicated task. This is great for less frequently used macros that you will not remember a hot key or other trigger, as well as for macros that *feel like* they should be menu commands, such as actions that *perform* a complicated task.
 +
 +==== Show Applications Palette ====
 +
 +Toggles the display of the [[Palettes#​Applications_Palette | Applications Palette]].
  
 ==== Recent ==== ==== Recent ====
Line 657: Line 790:
  
 See also the [[Macro Debugger]] section. See also the [[Macro Debugger]] section.
 +
 +==== Show Active Macro Groups ​ ====
 +
 +The *Show Active Macro Groups* command in the *Help* menu shows a palette that lists the current active macro groups. You can use this palette to see which macro groups are active (which means the enabled macros they contain are active).
  
 ==== Quit Keyboard Maestro Engine ==== ==== Quit Keyboard Maestro Engine ====
  
 The *Quit Keyboard Maestro Engine* command in the *Status Menu* menu quits the Keyboard~~Maestro~~Engine. The *Quit Keyboard Maestro Engine* command in the *Status Menu* menu quits the Keyboard~~Maestro~~Engine.
 +
manual/Menus.1560842216.txt.gz · Last modified: 2019/06/18 03:16 by peternlewis