User Tools

Site Tools


What’s New?

Keyboard Maestro 10 expands on the powerful base of previous versions, improving the editor, adding many new actions and triggers, Paste by Name, status menu display, subroutines, and more. Keyboard Maestro 10 requires macOS 10.13 High Sierra or later.

This version is dedicated to Jim Underwood (JMichaelTX), who sadly passed away this year, with thanks for his outstanding assistance and generosity on the forum, spending thousands of hours helping folks get more out of Keyboard Maestro. He will be sorely missed.

Changed in 10.2

  • Added option to Press a Button action to wait for the button to exist and be enabled.
  • Added option to Prompt With List action to Always Show All Entries. (forum)
  • Added option to Prompt With List action to not trim white space from entries. (forum)
  • Added PromptWithListShowAllLimit (default 100) hidden preference.
  • Added support for dragging files on to applications in the Application Switcher.
  • Added support for com.vivaldi.Vivaldi.snapshot browser.
  • Added Quote for Process Tokens filter.
  • Added kCGMouseEventDeltaX/kCGMouseEventDeltaY to mouse moved events. (forum)
  • Request Screen Recording permission when PIXEL function is used.
  • Fixed the Send SMS/iMessage action in recent macOS systems.
  • Fixed an issue with executing shortcuts that contain non-ASCII characters in their names.
  • Fixed an issue with ⌘⌥F global search erroneously adding ⌘ or ⌥ character to the search field.
  • Ensure that the Clipboard History is saved every three hours (if saving is enabled).
  • Ensured image specification text is searchable in the editor.
  • Hopefully remove the alert when switching to an enabled keyboard layout.

Changed in 10.1.1

  • Fixed a case where simulating certain keys (arrows, function keys) could trigger the matching Hot Keys.

Changed in 10.1

  • Added Execute Shortcut action.
  • Added Edit Shortcut action.
  • Added Execute or Edit Shortcut (based on the option key) action.
  • Added Get Macro, Edit Macro, and Execute Macro Shortcut Actions.
  • Added Get Variable and Set Variable Shortcut Actions.
  • Added Get Active Macros Shortcut Actions.
  • Added Calculate Shortcuts Action.
  • Added Process Tokens Shortcuts Action.
  • Added Search and Search & Replace Shortcut Actions.
  • Added support for Shift paste plain in Paste by Name action.
  • Added support adjusting modifiers in Keystroke selections (including pseudo-modifiers).
  • Fixed AppleScript support for catchactions in Try/Catch action.
  • Stop implicit reading of variables by web browser actions counting as a variable use.
  • Ensure recorded Insert Text by Typing action has token expansion disabled.
  • Append Text to a File action should not overwrite a file if the file exists but cannot be read.
  • Fixed an issue when deleting a condition if there are two other conditions that are identical.
  • Fixed an issue with AppleScript search and search & replace commands not honouring the case sensitive flag.
  • Resolved an issue simulating hot keys in recent systems by supporting Numeric Pad and Function pseudo-modifiers. (forum)
  • Resolved an issue where script error messages could be truncated.
  • Restored the MouseGetCountdown hidden preference. (forum)
  • Removed a dependency on /bin/bash for updates.

Changed in 10.0.2

Changed in 10.0.1

  • Fixed a crash if the Cochin Italic font is missing or disabled.
  • Fixed a crash when recording actions.
  • Changed the editor Get mouse location to include delay to allow window selection. (forum)
  • Adjusted dragging Subroutine macros to action lists or to make macro aliases to use Execute Subroutine action. (forum)
  • Process Text Tokens in Display Progress action. (forum)
  • Improved remembering the position of Macro Group status menu items. (forum)
  • Corrected typo of Miscellaneous in Icon Chooser SF Symbols.
  • Fixed showing status menus when macro group activation is Always active and variants. (forum)
  • Fixed an issue with Command-Option-Numbers hiding but not closing the Clipboard History Switcher. (forum)
  • Fixed Prompt for User Input variable type popup menu being in front of variable value field.
  • Fixed Custom HTML Prompt window not responding to key presses when the title bar is disabled (forum)
  • Fixed %FinderSelection% token including a trailing end of line character.
  • Fixed Set Next Engine Window Position action Center and Center At options. (forum)
  • Fixed Search the Web action failing to activate the web browser.


  • Added configurable Favorite Actions. (forum) (forum)
  • Added Select Macro by Name to the macro selector popup. (forum)
  • Added This Macro and This Macro Group options to the macro selector popup. (forum)
  • Added search field to macro selector popup.
  • Added Evaluate Condition Results option.
  • Disable Evaluate Condition Results after action or safe macro import.
  • Support dragging a .kmactions file in to an action list.
  • Add Get functionality to Area selection for various actions like Move & Resize Window and Capture Screen.
  • Used new Prompt for Screen Rectangle for Get facility of Click Mouse action.
  • Added search field to Insert All Actions, All Functions, All Tokens, and Variables menus.
  • Added Select Last Aborted Action menu item.
  • Added Or by Execute Macro to macros editor listing the Execute a Macro actions referring to this macro. (forum)
  • Added Cut, Copy & Delete to contextual menu for Macro Group and Macro columns.
  • Added Copy as Execute a Macro, Set Macro Enable and Mark Macro actions to contextual menu for Macro column.
  • Added Copy as Set Macro Group Enable and Toggle Macro Group actions to contextual menu for Macro Group column.
  • Added Paste to the No Action drag target contextual menu when the clipboard contains actions.
  • Support double-clicking dividers in the editor window to set ideal size.
  • Support control-up/down arrow in action lists to move actions up/down. Also command-control for top/bottom. (forum)
  • Support shift-insert action to insert the action above the current selection. (forum)
  • Added Edit ➤ Insert ICU Date Field menu to insert the various ICU Date components.
  • Added Edit ➤ Insert ICU Date Field By Name (^D) to insert the various ICU Date components by name.
  • Added File ➤ Export as Folder and Export All Macros as Folder to export macros as individual files.
  • Support tapping modifiers in editor search field to insert modifier symbol.
  • Added Sort Macros by Size.
  • Added size to Macro Inspector.
  • Added “size:10000” to search filter.
  • Added “And 99 Filtered Macros” pseudo macro entry to Macros column when some macros are filtered by the search field.
  • Added warning on Cancel All Macros, Cancel This Macro, Retry Loop, etc actions if it is not the last action of a sequence.
  • Added OCR Screen and Paste by Name to the Macro Library.
  • Fixed Add Variable/Function/Token/Date Field by Name in Value Inspector.





  • Added filter Sort, Reverse and Shuffle Lines. (forum)
  • Added filter Escape for Regular Expression.
  • Added filter Quote for JSON.
  • Added filter URL components such as scheme, host and path. (forum)
  • Added filter Encode & Decode Base64.
  • Added filter Encode HTML With Numeric Entities.
  • Added filter Calculate MD5.
  • Updated to the latest of John Gruber & Aristotle Pagaltzis Title Case filter, and internalized it to remove perl dependency.



Clipboard History

Custom HTML Prompt


  • Added a button in the debugger to edit the macro action. (forum)
  • Added display of recently accessed variables in the debugger. (forum) (forum)


  • Added support for getting and setting the Display in Menu Bar Macro Group settings via AppleScript.
  • Added “xml” AppleScript property for macros, macro groups and smart groups. (forum)
  • Added “group xml” AppleScript property for macro groups.
  • Added “last used” AppleScript property for macros. (forum)
  • Added “modification date” AppleScript property for macro groups and smart groups.
  • Added AppleScript support to the editor for showing preference panes.
  • Added support for AppleScript “edit” command, eg “edit macro 1”.
  • Added support for AppleScript to get/set the editing property of an editor window.
  • Added option to Search & Replace to replace only the first or last match.
  • Added instance parameter to process tokens and calculate commands.
  • Added selectAction command to select a specific action by id.
  • Added divider1 and divider2 properties to the editor window.
  • Added size property to Macro Groups and Macros.


  • Added SF Symbols to Icon Chooser (11.0+)
  • Added Export as Text Service.
  • Added Export as Finder Quick Action.
  • Show notification when the launching editor quits the engine.
  • Excluded* flavors from clipboard for better Microsoft compatibility.
  • Adjusted Copy action to note clipboard changes even if the clipboard is not read. (forum)
  • Adjusted VoiceOver to speak marked status in palette entries. (forum)
  • Use ENV_PWD to set the current working directory for shell scripts. (forum)
  • Improved the Share to Forum sheet. (forum)
  • Support longer variable names in Prompt For User Input when they will fit under the icon.
  • Support formatting AppelScript and JavaScript conditions.
  • Support shift arrow selection in Prompt With List (Multiple Selections). (forum)
  • Converted use of WebView to WKWebView.
  • Improved appearance of Preferences toolbar in Big Sur.
  • Improved display of CALCULATE function when the contents are potentially valid.
  • Support Return/Enter as a keystroke for the ↩ character in the Conflict Palette. (forum)
  • Added Audio Input and Camera entitlements to the Engine (to allow their use via scripts etc).
  • Added Restore Excluded Application entry to Applications Palette contextual menu.
  • Added Tooltips for Palettes. (forum) (forum)
  • Added AdditionalWebBrowserBundleIDs preference to add alternative bundle IDs for front browser list.
  • Allow Microsoft Edge and Brave Beta as a possible Front Browser Chrome-equivalent.
  • Allow Spotlight-like windows to be movable.
  • Adjusted the hit boxes for various application and macro popup menus. (forum)
  • Ignore the option key when switching applications in the Applications Switcher if the option key is used in the trigger.
  • Remove “Instance ” and “Local ” from variable names in Prompt for User Input form.
  • Report lack of Screen Recording permission when that stops an action from working.
  • Better reporting of lack of Screen Reporting errors in Find Image and Click Mouse actions.
  • Added control over OCR Image behaviour when the action fails.
  • The Macro Group macros in the Global Macro Palette use the Macro Group’s custom icon if any.
  • Prompt For User Input no longder displays hidden fields in non-edit mode. (forum)
  • Switched to CWWiFiClient for Wireless Network trigger, token and conditions.
  • Display some editor alerts within the editor window.
  • Display some logged error messages more prominently.
  • Display time trigger time in localized format in non-edit mode.
  • Avoid logging repeated errors.
  • Use pmset displaysleepnow to sleep the display on 11.0+, which works on M1 Macs.
  • Adjusted Write File to fail rather than trash a folder that will be replaced with a file. (forum)
  • Only report large variables excluded from environment every ten minutes.
  • Added appropriate window titles (visible via AppleScript/accessibility) to the various “By Name” windows. (forum)
  • Avoid selecting the macro/group name when deleting macro/groups.
  • Added action id to failed action log message. (forum)
  • Added a few more default status menu icon options.
  • Added additional protections for the Write File action.
  • Fixed activation of windows so you can use the Clipboard Switcher to paste in to other Keyboard Maestro Engine windows.
  • Fixed a bug enabling the Send button in the Report Bugs form (irony).
  • Fixed width of Trigger Macro by Name and other Spotlight-like windows in Big Sur. (forum)
  • Fixed Paste XML actions. (forum).
  • Fixed an issue with Prompt For User Input and long variable names. (forum).
  • Fixed an issue with a couple actions not saving changes when a token was selected.
  • Fixed an issue with file references to images that included non-ASCII characters.
  • Improve accessibility of editor toolbar buttons.
  • Fixed Login Window action in Big Sur (CGSession no longer exists).
  • Fixed a display issue for popup menus in Plug In Actions. (forum)
  • Fixed Trim Image to keep the full resolution and DPI.
  • Fixed a potential crash with the Reveal a File action.
  • Fixed an issue related to ^ in the Substrings In collection. (forum)
  • Fixed an issue where renaming a macro via the contextual menu would not scroll the name field in to view.
  • Fixed an issue with Search and Replace matching multiple times at the end of the string. (forum).
  • Fixed an issue where the engine might not be notified of macro changes if the editor is quit immediately after making the change.
  • Fixed an issue with the Sleep Screen action in Apple Silicon Macs.


Download Keyboard Maestro now to try all these great capabilities. Or keep reading for even more details about the Features of Keyboard Maestro.

Alternatively, you can contact us if you have a question about whether Keyboard Maestro can solve your automation needs. We want all our customers to be satisfied, so we are happy to help you understand how Keyboard Maestro can achieve your automation goals.

manual/Whats_New.txt · Last modified: 2022/09/06 01:56 by peternlewis