Keyboard Maestro 10 Is Fantastic!

Favorite actions and subroutines were at the top of my wish list. Group status menus would never have occurred to me but they're awesome.

Thanks to Peter for this great upgrade!


Yes. Very exciting! Downloaded and upgraded licence straight away. Thank you @peternlewis


I agree wholeheartedly. Keyboard Maestro is the one and only app that I update sight unseen the very day it comes out. To be honest, I find that it's value far exceeds its cost.

Already it has made vast improvements possible to some of my macros, and I can only imagine what other things I will be able to improve in the coming months as I learn more about it.

Thank you Peter for your outstanding work! @peternlewis


I totally agree with you @cdthomer :+1:

I pity with every day the cheering, regarding the Shortcuts app from macOS Monterey... do you all not know about the possibilities around Keyboard Maestro and that for years :wink:



Keyboard Maestro is the only software that I purchase upgrades to without thinking about it overmuch. Thanks Peter!


I'd like to understand what this is and how it works. I have to admit, I read the Wiki entry and found it confusing.

I'd appreciate an example if you have one?

I upgraded already, no quibble, but haven't really grasped what the big changes are that I will make good use of yet.


Maybe this screenshot will help:


@Lloydi here is an example about the possibilities to show a macro group in the menu bar during execution.


This is also a good example from @TheRealSP


Right, got it now, and see the value here. The documentation didn't really make it clear, but an image did :slight_smile:

One thing I would like to suggest: allow the items in the list to be keyboard selectable once opened. I have just tried this with a macro group that has a lot of items. Ideally this would behave such that you can press a letter and it'll jump to the first item beginning with that letter (and then use arrow up/down keys to refine selection).


And a keyboard shortcut to open the menu itself!


Just being able to display in the menu bar made this worth the upgrade price for me. Now I can see at a glance the current network location I switched to. I switch between networks at home by changing the network adapter between the ethernet and wifi. The ethernet is connected to a vpn appliance and the wifi is the house Internet.


I would agree that keyboard accessibility is important, but it could be tricky for these in that they will appear/disappear on an ad-hoc basis depending on the macro group condition. Also, if it's icon only, what should be the shortcut? Probably would require a key command to select the group of KM menu options, then use arrow keys to move left/right, then down/enter to open etc.

Uneventful, placid upgrade. My fifth, over ten years. Thank you so much :clap: :clap: :clap: :clap: :clap:


Agreed. Great work, @peternlewis!


Just want to chime in that the Menu Bar status is also one of my favourites new feature! Thank you.


I completely agree with you!

I went to browse the forum and accidentally went to didn't realize from the home page that there was a new version 10. I searched for the forum and browsed and saw this thread and went back to the website to get an upgrade. Thanks for all your work @peternlewis

A bit more than your website eludes to, this is amazing! Keyboard Maestro 11.0.2: Work Faster with Macros for macOS

Version 10 is a paid upgrade for everyone who purchased before 1 March 2021. Version 10 is a free upgrade for anyone who purchased after 1 March 2021. Keyboard Maestro 10.x requires macOS 10.13 High Sierra or later.
Changed in 10.0
• Require macOS 10.13 High Sierra

• Editor:

  • Added configurable Favorite Actions.
  • Added Select Macro by Name, as well as This Macro and This Macro Group options to the macro selector popup.
  • 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 should import the actions.
  • 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 Mouse Click 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.
  • 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.
  • Support shift-insert action to insert the action above the current selection.
  • Added Edit > Insert ICU Date Field menu to insert the various ICU Date components.
  • Added Edit > Insert ICU Date Field By Name (AD) 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 Enabled.
  • 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.

• Engine:

  • Added support for manipulating Keyboard Maestro Engine windows.
  • Added Set Next Engine Window Position action.
  • Option-double-click (or option-Return) in Clipboard History Switcher just sets the clipboard.
  • Ignore the option key when switching applications in the Applications Switcher if the option key is used in the trigger.
  • Added option to include Macro Groups in the status menu bar.
  • Updating icons and title.
  • Updating information in the menu.
  • Executing on selection or automatically when the menu is displayed.
  • Added Group Status Menu trigger.

• Subroutines

  • Added Subroutine trigger which defined parameters to be passed to the macro.
  • Added Execute a Subroutine action to execute a macro, passing it parameters.
  • Added Return action to return a value from subroutine macros.

• Triggers:

  • Added Unlock trigger.
  • Added Appearance Changed trigger.
  • Added Online Status Changed trigger.
  • Added Power Status Changed trigger.
  • Added “long press" option for Hot Key and USB Device Key triggers.
  • Disallow adding duplicate redundant triggers (like two Power Status Changed triggers).

• Actions:

  • Added Paste by Name action giving Spotlight-like search of clipboard history.
  • Added Prompt for Screen Rectangle/Location.
  • Added Try/Catch and Throw actions.
  • Added Display Progress action.
  • Added Display Progress option to For Each action.
  • Added a Pause Until Change action to detect clipboard, modifiers, keyboard, mouse, or application changes.
  • Added Create Unique File action.
  • Added additional field types to the Prompt for User Input action:
  • Added Date, Time and Date & Time picker fields.
  • Added Slider fields.
  • Added Color Well fields.
  • Remove “Instance " and "Local " from variable names in Prompt For User Input form.
  • Added icon chooser selection to Set File Icon and Set Clipboard to Image and other actions.
  • Added support for selecting multiple files or folders in the Prompt For File action.
  • Added support for creating the folder when selecting a new folder in the Prompt For File action.
  • Added separated by option to Substrings In collection.
  • Added option to control text processing of input text for a variety of actions.
  • Added option to Search & Replace to replace only the first or last match.
  • Added option to control volume of Speak Text action.
  • Added a variety of macro environment variables (eg KMINFO_TriggerValue) to the Execute Shell Script action.
  • Added a calculation option to Switch and other actions.
  • An Assert action with an empty condition now always asserts.

• Filters:

  • Added Filter Sort, Reverse and Shuffle Lines.
  • Added Filter Escape for Regular Expression.
  • Added Filter Quote for JSON.
  • Added Filter URL components such as scheme, host and path.
  • 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, and internalized it to remove perl dependency.

• Tokens:

  • Added LastWindowID token.
  • Added PromptWithListText token.
  • Added PasteByNameText token.
  • Added UserHome token.
  • Added FinderSelections and FinderSelection tokens.
  • Added AccessedVariables token.
    • Functions:


  • Added SCREENINDEX function that returns the index of the specified screen.

• Clipboard History:

  • Added Characters I Words / Lines count to Clipboard History Switcher.

  • Adjusted Clipboard History numbering to match Past Clipboard action.

  • Added Command-Control/Option/Shift-numbers to Clipboard History to Paste or Set optionally plain clipboards.

• Custom HTML Prompt:

  • Added ProcessAppleScript command to Custom HTML Prompt.
  • Added option to turn off title bar on Custom HTML Prompt window.
  • Added option to make Custom HTML Prompt window transparent.
  • Added context sensitive WINDOW function for Custom HTML Prompt window resizing operations.

• Debugger:

  • Added a button in the debugger to edit the macro action.
  • Added display of recently accessed variables in the debugger.
    • AppleScript:
  • 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.
  • Added “group xml" AppleScript property for macro groups.
  • Added “last used" AppleScript property for macros.
  • 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 divided and divider2 properties to the editor window.
  • Added size property to Macro Groups and Macros.

• Minor:

  • 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.
  • Adjusted VoiceOver to speak marked status in palette entries.
  • Use ENV_PWD to set the current working directory for shell scripts.
  • Improved the Share to Forum sheet.
  • 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).
  • 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.
  • 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.
  • Added AdditionalWebBrowserBundlelDs preference to add alternative bundle IDs for front browser list.
  • Allow Microsoft Edge 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.
  • 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.
  • 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.
  • Adjusted Write File to fail rather than trash a folder that will be replaced with a file.
  • Only report large variables excluded from environment every ten minutes.
  • Added appropriate window titles (visible via AppleScript/accessibility) to the various “By Name" windows.
  • Avoid selecting the macro/group name when deleting macro/groups.
  • Added action id to failed action log message.
  • Added a few more default status menu icon options.
  • Added additional protections for the Write File action.
  • Use 'pmset displaysleepnow' to sleep the display on 11.0+, which works on Ml Macs.
  • Fixed Add Variable/Function/Token/Date Field by Name in Value Inspector.
  • 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.
  • Fixed Paste XML actions.
  • Fixed an issue with Prompt For User Input and long variable names.
  • 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.
  • 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 A in the Substrings In collection.
  • 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.
  • Fixed an issue where the engine might not be notified of macro changes if the editor is quit immediately after making the change.

I'll start posting tips for v10 in a while. I have two of these status menus that I've been using for a while, one had the count of todo items remaining for v10 which was a great motivation, and the other tracks the Mac idle to remind you when you should be getting up and moving around because you've been working too long.


I'd love to go through a Keyboard Maestro certification, I feel like there are so many hidden gems I keep finding that it would be amazing to just be forced to go through things step by step in some intelligent order that one of the gurus on here deem a good flow.

I would love to sit in a week long class with one of you guys and just go threw the paces of possibilities and good workflow. So if someone wants to make up their own certification and week long training I'd do what I can to be at it.


Congratulation to Peter for the much anticipated new release. I'm sure this will be another great piece of incredible work. I can't wait to see what is new and explore the new features and build more KM Apps (app that leverage custom HTML prompt action). I never imagine a software that can save countless hours of work and make computing a joy.


The closest thing to that is David Spark’s Keyboard Maestro Field Guide (Keyboard Maestro Field Guide | MacSparky Field Guides), so if you want to enhance your Keyboard Maestro use quickly, that is probably the best way.

Otherwise just keep using Keyboard Maestro and ask on the forum whenever anything proves tricky.