Thoughtful, detailed coverage of the Mac, iPhone, and iPad, plus the TidBITS Content Network for Apple consultants.

Keyboard Maestro 7 Features Enhancements Throughout

A little over two years ago, Peter Lewis of Stairways Software released Keyboard Maestro 6, and I sang the praises of macro software in general before describing that version’s new features (see “Keyboard Maestro 6 Automates Web Pages, Adds Macro Syncing,” 21 May 2013). Although the specific macros I rely on today are a bit different, everything else I wrote there remains completely true, and if you’ve never quite understood the utility of macros or Keyboard Maestro in particular for automating repetitive tasks on your Mac, go read that article. I’ll wait.

Now that we’re all on the same page, let’s look at what’s cool about Keyboard Maestro 7, the major new release that Peter just put out after two years of free updates. Changes fall into a few major categories: new triggers, new actions, Keyboard Maestro Editor changes, and themed palettes.

Every macro has two basic parts — a trigger and an action. Most people think of triggers as keyboard shortcuts, but Keyboard Maestro boasts a large and growing set of triggers that can initiate macros. New triggers in version 7.0 include a change in the focused window, a folder’s contents changing, the clipboard changing, and the Mac going to sleep. In addition, standard Hot Key (and Device Key) triggers now support double-tap, triple-tap, and so on. Of course, you can still use triggers that execute at login, when a volume is mounted or unmounted, at a specific time, when the Mac wakes, when you join a particular wireless network, and so on.


On the action side of the equation, Keyboard Maestro already had a vast number of actions to control nearly anything on your Mac, but 7.0 still manages to add a number of new and enhanced actions. The most interesting include Type Modifier Key, Open 1Password Bookmark, Simulate Hardware Key, Set Keyboard Layout, Execute Swift Script, and Execute JavaScript for Automation. Notably, a new Switch/Case action lets you give a macro more smarts because it can determine if the clipboard, a variable, or some text contains a particular string or an image, and then execute sub-actions if so.

Note two things about the previous paragraph. First, a new gear menu in every action provides access to a variety of contextual operations you might want to perform on the action, such as trying it, disabling it, renaming it, and adding a color or a note (documentation within macros, yay!). There are even a pair of copy commands for easy sharing of the action; the screenshot of the Switch/Case action above was made by Copy As Image. The second thing to note is the link to the Switch/Case page on the Keyboard Maestro documentation wiki; that’s accessible by choosing Help from the gear menu. This contextual help sprinkled throughout the app makes it much easier to construct complex macros using previously unfamiliar actions.


With so many actions to choose from, scrolling through the list in Keyboard Maestro Editor has become tedious. You’ve long been able to search for an action within the list, but even easier is a new keyboard shortcut — Command-Control-A — that brings up an Add Action bar. Type part of the name to see a list of possibilities, and insert the desired action with a double-click.

Other changes in Keyboard Maestro Editor include:

  • Autocomplete for text tokens, functions, variables, and search tokens

  • A Macro Inspector window that tells you when the macro was created, last modified, and last used, along with statistics on how many times you’ve used it and how much time it has saved you

  • A Mouse Display window that dramatically simplifies the task of identifying specific mouse coordinates as your cursor moves around the screen; you can even copy the numbers to the clipboard with a click

  • A new Share button that makes it easy to share macros via email, Messages, and more

  • Action groups that let you try, enable, or disable a batch of actions all at once

Finally, if you make heavy use of palettes to display your macros, themed palettes may be welcome, since they enable you to customize just how your palettes look. Open Keyboard Maestro’s Preferences window, click Palettes, and then click one of the palette types to bring up the Palette Editor.

There are numerous other changes — too many to detail here — that make Keyboard Maestro 7 a welcome revision. Happily, unlike many Apple upgrades, most of Keyboard Maestro remains familiar, with the new features simply building on what was already there. That’s because one of Peter’s major goals is to enhance the experience for current users in such a way as to warrant the upgrade cost, rather than just moving the interface deck chairs around in the service of fashion. That also means that Joe Kissell’s “Take Control of Automating Your Mac” book remains generally accurate in its explanation of how to use Keyboard Maestro.

Keyboard Maestro 7.0 costs $36 new, with upgrades priced at $18 (for those who purchased version 6) or $25 (for people who last purchased an earlier version); a free trial is available. It requires OS X 10.10.3 Yosemite or later; those with earlier versions of OS X can still get an appropriate older version of Keyboard Maestro. And yes, it’s compatible with the public beta of 10.11 El Capitan as well. TidBITS members, and anyone who buys “Take Control of Automating Your Mac” can save 20 percent on new copies of Keyboard Maestro, dropping the price to $28.80.


Make friends and influence people by sponsoring TidBITS!
Put your company and products in front of tens of thousands of
savvy, committed Apple users who actually buy stuff.
More information: <>

Comments about Keyboard Maestro 7 Features Enhancements Throughout
(Comments are closed.)

Charlie Hartley  2015-07-29 17:35
Any known issues with El Capitan?
Adam Engst  An apple icon for a TidBITS Staffer 2015-07-29 17:39
None that I've heard of, but I haven't done any significant testing.
Adam Engst  An apple icon for a TidBITS Staffer 2015-07-30 09:36
I've added a link to the article after talking with Peter. There's only one cosmetic problem that's a bug with El Capitan; Peter hopes Apple will fix it, but if not, he thinks it will be easily worked around.
jehrler  2015-08-06 21:49
Hmmm. Since Peter may have to modify the code for the clipboard history swisher to worn with El Capitan, I wonder if Peter can add numbers to the clipboard history switcher to identify which clip is, say, 8 at a glance. Hint, hint.
Russell Walasek  2015-07-29 22:26
Interestingly, my upgrade price is quoted as $25, not $18. The Stairways upgrade page says "Upgrade from $18".
Adam Engst  An apple icon for a TidBITS Staffer 2015-07-30 09:25
My mistake (since I didn't have a reg code to put in) - upgrades are $18 from v6, but $25 from earlier versions. I've updated the article.
Michael Paine  2015-07-30 08:01
I have a longstanding irritation with EyeTV -it does not prevent the Mac from going to sleep while it is playing video (live or recorded TV). Elgato seem to have ignored my requests for a fix. Is there a way to use Maestro to prevent the Mac sleeping - but only when video is playing?
Josh Centers  2015-07-30 11:28
Peter N Lewis  An apple icon for a Friend of TidBITS 2015-07-31 10:13
There is a built in (I believe) unix tool called caffeinate which can stop the Mac from sleeping. You can run the tool from a Keyboard Maestro macro (using the Execute Shell Script action), or from any other means.
Stefan Kovalovsky  2015-07-31 06:13
EyeTV normally prevents the Mac from sleeping during playback. If it doesn't, then there is most likely something wrong with either the EyeTV or the Power Management configuration.

During playback of an EyeTV recording, go to Terminal and enter

pmset -g

Normally, you would see an output like this:

(sleep prevented by EyeTV, coreaudiod)

"man pmset" may give you additional hints to diagnose the problem.

With KM, maybe the new "focussed window" triggers could be used to detect the presence of an EyeTV playback window. I can not help you there because my EyeTV machine is on Mavericks and KM 7 does not support it.

Alternatively, you could use a KM macro to run a shell script that starts EyeTV as a process of the "caffeinate" utility as Peter and Josh have suggested ("caffeinate -i open -W /Applications/").

Another way: use a pair of macros with "This Application launches/quits" triggers calling shell scripts that set the sleep state with "pmset".

Michael Paine  2015-08-02 01:01
Thanks for the tips - I will try them out. I have been using Jiggler for years. It activates the mouse every few minutes when selected apps are running.
Gerald Wright  2015-08-04 01:16
If you run eyeTv at full screen the Mac won't go to sleep, it is only when you run eyeTV at less than full screen with the Mac go to sleep.
Michael Paine  2015-08-04 17:18
EyeTV is working as you describe - preventing the iMac from sleeping when playing. I have realised (humble pie) my problem is with the display going to sleep. That is where Jiggler is helpful. I cannot use full screen to prevent this because I use that mode to swap to an external display.