What&s New
Keyboard&Maestro&6 expands on the powerful base of previous versions.
Changes for 6.4.8
Workaround Yosemite bug in Speak Text action.
Workaround Yosemite bug in display of popup menus.
Fixed Yosemite display of Welcome screen.
Fixed Yosemite freeze with network reachability (typically after sleep).
Add Help button with information about Yosemite Accessibility Permission bugs.
Limit Undo stack size.
Add support for Corsair K95.
Allow up to 9999 Seconds/Minutes/Hours in While Logged In Trigger.
Fixed behaviour of Image Actions on Retina Macs.
Fixed misspelled Accessibly.
Fixed misspelled &Pixek Height& in Get Image Size action.
Changes for 6.4.7
Fixed a drawing issue in the Clipboard History in Yosemite DP6.
Fixed a crash in the editor.
Changes for 6.4.6
Fixed the Fast User Switch action.
Changes for 6.4.5
Fixed a crash in Trigger Macro by Name
Changes for 6.4.4
Added Command-Option-R Record Without Delay menu.
Improved reliability of Typed String triggers with Conflict Palette.
Condition updates now work properly when there were no conditions.
Worked around a bug in Pages that made styled text paste as plain text.
Worked around a system issue with launching shell scripts and some environment variables.
Resolved a drawing glitch in Yosemite.
Removed the use of some newly deprecated APIs.
Fixed excess memory/CPU usage when a screen condition and a second condition were used together.
Fixed a possible crash in the calculation engine.
Fixed a possible crash saving the Time Saved.
Fixed the inverted checkboxes in Quit/Hide All/Other Applications.
Changes for 6.4.3
Resolved a problem with the editor using too much CPU, especially with Chrome actions.
The editor now only updates visible actions (actions actually visible in the window).
Fixed incorrect text in non-edit mode display of Quit/Hide Applications.
Changes for 6.4.2
Added accessibility labels/tool tips for Add/Delete Variable/Clipboard buttons in Preferences.
Composite Image text now processes text tokens.
Allow the Escape key to close the preferences window.
Worked around an issue with Get Info in the Finder.
Stop tag actions from crashing in Mountain Lion.
Fixed the displayed length of checkboxes in Prompt For User Input.
Quit or Hide Applications action inverts the Exclude checkbox when setting.
Avoided another crash involving CFPreferences.
Disable Secure Input Mode warning in the first two minutes after startup.
Fixed a crash in &unlockViewHierarchyForDrawing.
Fixed potential crashes caused by NSAppleScript.
Fixed potential crash if a volume is unmounted as Keyboard Maestro Engine quits.
Fixed a potential crash in the editor.
Removed bogus &Reload& contextual menu from WebKit views.
Removed overly enthusiastic isHiddenOrHasHiddenAncestorOrIsNotInWindow assertions.
Undo now correctly reselects selected actions.
Changes for 6.4.1
Fixed typo in Get File Attribute editor.
Fixed an issue where simulated text could trigger Typed String triggers.
Fixed a case where Application Quit trigger for background apps might not fire.
Treat smart and straight quotes as equivalent for menu/button matching.
Non-edit mode display now updates for programatically changed enables.
Fixed an issue with some hot keys in palettes opened by duplicate palettes.
Fixed a potential crash when creating custom icons without the Apple Color Emoji font.
Added For Each examples for Finder selection and folder contents to action selector.
Stopped Web Search from performing search if it lost focus.
Fixed a possible crash processing text tokens.
Added accessibility labels for various unlabeled image buttons in palettes.
Fixed an issue where timer drift could cause time triggers to execute twice.
Fixed a crash undoing Execute AppleScript actions.
Changed &iPhone& to &iOS& in preference references.
Fixed an issue in Exit From Loop that would partially cancel following actions.
Changes for 6.4
Added support for Mavericks Tags.
Added Get File Attribute: Tags. Mavericks only.
Added Set File Attribute: Tags (set, add, toggle, or remove). Mavericks only.
Added Semaphore Lock/Unlock actions.
Added Asynchronous option to Execute Macro
Added Asynchronous option to Execute Shell Script, AppleScript and JavaScript.
Improved VoiceOver support for lists and buttons.
Improved accessibility support.
Added speech rate to the Speak Text action.
Added importMacros AppleScript command.
Added deleteMacro and deleteMacroGroup AppleScript commands.
Added Tab to the hot key/simulate keystroke popup menus.
Added %ExecutingMacroUID% token.
Added Mouse, Front, Back, Back2 options to the SCREEN function.
Added TRIGGERTIME() function.
Added GMTOFFSET() function.
Added %AddressBook%Note% text token.
Added SimulateKeystrokeDeadKeyDelay private preference.
Added various Cancel action varieties to the action selector.
Adjusted Typed String trigger to make diacritical sensitivity independent of case sensitivity.
SCREENSAVER() returns true if screen is locked.
Set %ActionResult% on timeout failures.
Allow selection of .xpc applications.
Changed Keychain access to use direct code instead of security utility.
Fixed a crash when evaluating expressions of the form &(&
Stop clicks while deferred selection change pending, perhaps fix editor crashes.
Fixed &Any Application& launch/quit trigger to only include foreground apps.
Added macro/action to Macro Cancelled message.
Add Help menu items for Regular Expression and ICU Date Time reference.
Fixed a potential crash in the window switcher setup.
Fixed a potential crash when launching shell scripts.
Fixed a potential crash finding buttons with bogus accessibility information.
Fixed a memory leak in the image finding code.
Fixed a potential crash showing the contact sheet.
Fixed issue where time triggers would not fire if any changes were made within 30 seconds before the scheduled time.
Fixed an issue with continuous timer triggering during daylight savings change over.
Fixed a potential crash with action editors.
Adjusted a few names in the action selector.
Fixed Accessibility Alert display in Mountain Lion.
Worked around a potential crash in the system preferences settings.
Fixed an issue with non-edit display of Repeat actions.
Fixed an issue with non-integral sized images (seriously!).
Fixed an issue with shell scripts that waited for stdin input.
Offer Getting Started emails even to registered users.
Stop Time Saved for automatic (from editor) actions.
Conflict Palette correctly highlights selection characters for macro names with sorting codes.
Forcefully disabled dash and quote substitution in Insert Text and Scripts action editors.
Word count treats contracted (eg I've) words as a single word.
Resolved a problem typing some characters on some keyboards (eg ` on Swiss German keyboards).
Resolved a problem with double clicking in the Finder.
Resolve a problem with repeating triggers and Show Status Menu.
Pause action merges together when recording pauses.
Changes for 6.3.2
Fixed a code signing issue.
Changes for 6.3.1
Allow more than one separator in Prompt For User Input menus.
Fixed clipboard garbage text that affected some applications.
Fixed Set Find Pasteboard action.
Fixed a potential crash when executing scripts.
Fixed a crash in the editor if a macro contained only an Execute This Macro action.
Fixed a potential crash writing clipboard strings.
Fixed a potential crash if getting the icon of a file failed.
Changes for 6.3
Added Typed String trigger &Diacriticals do not matter& option.
Add Typed String Trigger &regular expression match&.
Add Typed String Trigger &only after word break& option.
Typed String simulates deletes before displaying the conflict palette.
Added TypedStringClearTime private preference (default 5 seconds).
Added TypedStringClearWithShiftSpace private preference (default on).
Typed String triggers do not clear the Typed String buffers (simulated characters do).
Added Clear Typed String Buffer action
Added Crash Reporter.
Added Substrings In collection.
Merged Lines In collections.
Added Lines In Named Clipboard collection.
Added %ActionResult% token.
Removed Press Button Result, Mouse Click Result, Select Menu Result variables.
Added %Trigger%, %TriggerBase%, %TriggerValue% tokens.
Removed USB Device Name, Mounted Volume Name variables.
Added delay before and after dragging in the drag mouse action.
Vastly improved performance of actions that write named clipboard entries.
Changed various informative alert sheets to use notifications instead.
Highlight errors in calculations in more places.
Added option to Fix Finder Selection Bug in appropriate collections and actions.
Added support for separators (-) in Prompt For User Input popup menus.
Added support for code_display formatted menu items in Prompt For User Input popup menus.
Use minus sign (-) instead of no entry sign (\) for Delete.
Periodically trim log files.
Added URL for keyboardmaestro://m=Activate%20Application%20Switcher
Added URL for keyboardmaestro://q=Activate
Added URL for keyboardmaestro://g=All%20Macros/q=Activate
Added URL for keyboardmaestro://a=Execute
Added URL for keyboardmaestro://c=All%20Actions/a=Execute
Hold Command key while pasting to toggle Close On Action in Clipboard Switchers.
Added support for displaying time saved in Days, Months or Years.
Added SYSTEMVOLUME() function.
Only force setting the Find Pasteboard if it actually changes value.
Added support for Option-Arrow keys in switcher grid view.
Allow more use of shortcut letters in switchers with non-English keyboards.
Added warning to Status Menu if Accessibility is disabled for Engine.
Reduced apparent Energy impact by reducing polling for clipboard changed.
Added getall option to gethotkeys AppleScript engine command.
Bug fixes for 6.3
Use a more modern method to simulate hardware keys which should resolve the Volume Control action issues.
Wireless triggers would fire even if the macro was disabled or inactive.
Save empty calculations even though they are invalid.
Fixed Substring action when source and dest are different named clipboards.
Fixed an issue with MIDI notes and non-zero channels.
Removed Text Suite from AppleScript dictionary.
Mouse Drag locked the engine up while dragging.
Fixed potential crash when when Open/Close CDROM action fails.
Screen image highlighting worked only on one screen in Mavericks.
Fixed SCREEN(Internal,coord) and SCREEN(External,coord).
Changes for 6.2
Added action to Send Mail Messages.
Added action to Set Mail Flag/Flagged/Read/Junk status.
Added Mail recipient tokens: MailRecipients, MailToRecipients, MailCCRecipients, MailBCCRecipients
Added Mail tokens: MailSender, MailReplyTo, MailSubject, MailContents, MailRawSource
Added Mail date functions: MAILDATERECEIVED(), MAILDATESENT()
Added Mail status functions: MAILFLAG(), MAILFLAGGED(), MAILREADSTATUS(), MAILJUNKSTATUS()
Added Mail action functions: MAILWASFORWARDED(), MAILWASREDIRECTED(), MAILWASREPLIEDTO()
Added Reveal a File action.
Format AppleScript in the Execute AppleScript action.
Added menu condition to test for menus with a specified shortcut.
Execute JavaScript scripts can now access Keyboard Maestro variables.
Added Destination selection to Substring action.
Extend Get Image Size to return size in pixels, points or DPI.
Added Absolute Position relative for Mouse Click action.
Image View supports Quick Look in Find Image, Mouse Click and Image on Screen condition.
Add detail to macro edit message &Triggered by any of the following&
Added %FindPasteboard% text token.
Hold the option key down in the Application Switcher to reopen windows.
Updated Markdown library from Andreas Zeitler (Mac OS X Screencasts) (requires Wrap Text plugin action).
Bug fixes for 6.2
Resolved an issue where Keyboard Maestro Engine could not display any windows after login.
Remove &Hide& flag from Keyboard Maestro Engine login item if present.
Removed and correct any extraneous Keyboard Maestro Engine login items.
Changed Get Image Size action to return pixel size.
Fixed a possible race/crash condition writing to the Last Executed dictionary.
Possibly fixed a crash related to wireless network triggers.
Worked around a crashing bug in the system related to the Select Menu Item editor.
Application popup menu for More re-opens the popup menu.
Tweaks to the Duplicate Palette hot key handling.
Alert title was not text token processed.
Prompt For User Input after Trigger Macro By Name did not have focus.
Inverted scroll wheel in icon grids to match system behaviour.
Fixed an issue where the front window might not be restored to focus after closing a clipboard switcher.
Favorites Category actions is now sorted alphabetically.
Improved behaviour when launching applications with always hide others.
Changes for 6.1
Added an Set Safari/Google Chrome Checkbox action.
Added an Set Safari/Google Chrome Radio Button action.
Added an action to pop open the Keyboard Maestro status menu.
Added an action to suspend the login and display the Login Window.
Conceal probable passwords in the clipboard history.
Added Cancel Just This Macro (subroutine) action.
Added Break From Loop action.
Added a Log action which logs to the Engine.log file.
Added new Hidden type to plugin actions, so you can easily pass tokenised text.
Added Acorn-style Feedback panel.
Prompt For User Input label trims prefixes before double underscore (eg myMacro_Text).
Improved Accessibility detection and behaviour under Mavericks.
Read the plain text version of the clipboard in the text tokens when only plain text is desired.
Bug fixes for 6.1
Chrome Actions had Safari Icons.
Number Pad numbers were off by one in conflict palette selection.
Variables preference pane allows deleteing of Password variables.
Plug In actions did not display details in non-edit mode.
Fixed non-edit display of wireless triggers.
Fixed non-edit display of show menu action.
Fixed non-edit display of Set Variable to Calculation to show format.
Added Disabled on This Mac to non-edit display of macro groups.
Adjusted ICUDateTimeFor token to be relative to unix time.
Adjusted clipboard reading code to deal with Safari and its wonky web archives.
Avoid reading clipboard contents with transient flavour markers.
Allow the For Each Files collection to scan the root (/) folder.
The Disabled on this Mac checkbox did not appear until after restarting the editor.
Fixed the Wrap filter
Fixed a bug that could affect typing if you changed keyboard layouts.
Made sure Quit Engine on Editor Quit was not left enabled from MAS version.
Changes for 6.0.1
Changed re-import plug in action to replace existing plug in action.
Conflict Palette Option-Number now edits the selected macro.
Corrected Tutorial highlighting on retina Macs.
Trigger by Name Command-Option-Number (and Option-Return/Enter) now edits the selected macro.
Spell Checking is off by default in all text fields.
Resize Plug In Action Popup Menus to fit their contents.
Fixed import plug in action to create Keyboard Maestro Actions folder.
Corrected Universal Access Warning dialog. Sigh.
Volume Mounted trigger did not display popup menu as &unmounted&.
XML code for Volume Mounted and MIDI trigger were reversed.
Conflict palette could erroneously highlight numbers.
Resolved Trigger by Name weirdness when keyboard preference tabs through &All Controls&.
Trigger by Name will not restore items after all items are filtered away.
Corrected Set Find Pasteboard typo.
Macro Group Palettes appear in all spaces.
Fixed a memory leak in the Window Switcher.
Corrected tooltip on Set Action Timeout button.
Corrected non-edit display of Move and Resize window.
Corrected non-edit display of Manipulate Window.
Avoid reading image files with @2x in their name at retina resolution half size.
Correct Find Image display location when second monitor is on left.
Corrected sporadic inverted icons in Application Switcher.
Fixed Display Status Menu display when Alphabetical was selected.
Accept documents dropped on editor at launch.
Use mdfind to scan for applications in the Applications folder (and subfolders).
Reduced the rate at which Wait For Web Browser queries the readystate.
Major Changes for 6.0
Requires Mac OS X 10.8.
Macro Syncing – share your macros across multiple Macs.
– use or write new actions.
Full support for Styled Text and Named Clipboards.
Support for controlling Safari and Google Chrome web pages.
Trigger Macros by Name – trigger any active macro from a single key.
Fantastic new icons from .
Customizable macro icons and a new
and creator.
allows stepping through macros.
Retina Happy Graphics.
New Triggers
USB Device is attached or detached.
Wireless Network is connected or disconnected.
Volume is mounted or unmounted.
At Engine Launch.
New Actions
Plug In Actions – write your own!
Show a Menu.
Search Variable or (Named) Clipboard and capture components of .
Get Substring from Variable or (Named) Clipboard.
Activate macro groups including showing as a palette.
Copy (Named) Clipboard to (Named) Clipboard.
Display notification in the Mountain Lion .
Set Variable to Keychain Password and Set Keychain Password to Text.
Stop Screen Saver.
Sleep and Wake Screens.
Set Network Location.
Set Find Pasteboard.
Lots of new Debugger actions:
Start or Finish Debugging.
Control whether new macros start Paused or Running.
Breakpoint or Continue this macro or all macros.
Breakpoint, Continue, Step Into, Out or Over other macros.
Toggle Global Macro Palette.
Clipboards & Styled Text
Apply Styles (Font, Colors, Underlines, etc) to (Named) Clipboard.
Search & Replace Clipboard preserves styles.
Filter Clipboard preserves styles.
Text Tokens preserves styles (particularly the clipboard tokens).
Named Clipboards preference pane allows editing styled text or setting images.
Extend Set (Named) Clipboard to Text to support styled text.
Extend Insert Text to support pasting styled text.
Extend Write File to support writing styled text.
Extend Display Text to support styled text.
Extend Composite Image to support styled text.
Extend Set Clipboard to Text to allow specifying Named Clipboards.
Extend Set Clipboard to Past Clipboard to allow specifying Named Clipboards.
Extend Search & Replace Clipboard to allow specifying Named Clipboards.
Extend Filter Clipboard to allow specifying Named Clipboards.
Extend Apply Text Factory to allow specifying Named Clipboards.
Safari and Google Chrome Actions
New&Window&with&URL.
New&Tab&with&URL.
Next Tab, Previous Tab, Select Tab.
Set&URL, Set Title.
Wait to Finish Loading.
Click Link.
Get/Set Fields.
Submit or Reset a Form.
Focus or Select a Field.
Execute JavaScript.
New text tokens %SafariTitle%, %SafariURL%, %SafariReadyState%, %SafariField%, %SafariJavaScript%.
New text tokens %ChromeTitle%, %ChromeURL%, %ChromeReadyState%, %ChromeField%, %ChromeJavaScript%.
New functions SAFARITABINDEX(), SAFARITABCOUNT(), SAFARIISCOMPLETE().
New functions CHROMETABINDEX(), CHROMETABCOUNT(), CHROMEISCOMPLETE().
Preferences
Extend Named Clipboards preference pane to allow editing.
Added Variables pane to Preferences, including editing.
Added selectable and contributable status menu icons.
Editor & UI
Added Sort by Macro Modification.
Added Sort by Macro Execution.
Macros and Macro Groups can now have custom icons.
Status Menu lists and allows you to cancel running macros.
Added Duplicate command for Macro Groups.
Detect and report when the system is stuck in Secure Input mode.
Added a Set Action Timeout button at the bottom of the macro editor.
Copy as Image and Copy as Text for macros and actions (and contextual menu).
Enhanced the non-edit display to show full details of actions.
Enhance the conflict palette to allow selecting with letter keys.
Added ISO Section, JIS Yen, Underscore, Key Pad Comma, Eisu and Kana to hot key popup menu.
Hold down shift while pasting from the clipboard switchers to paste as plain text.
Don't expand calculation fields just because they are negative.
Option click on the Macro Group Palette Keyboard Maestro icon to edit the macro group.
Adjusted the size of application icons in menus to 16x16.
Improved the look of the macro group activation toggle display.
Left/Right Arrows disclose/close actions. Option-Left/Right applies to all actions in that list.
Remember the location of the conflict palette.
Recorded clicks can be adjusted to any corner of the main screen or front window after recording.
Added recording count down before starting recording.
Added a Pause button to the recording window.
Added an Insert 1 Second Pause button to the recording window.
Record mouse drags.
Record mouse right, centre and other button clicks.
Added &Or by Ruby script& to script trigger examples.
Added &Or by script& to Quick Macro action.
Added Expand/Collapse Action and Expand/Collapse All Actions menu items.
Remember activation of macro group palettes across changes of applications.
Changed the View menu Edit item to Start/Stop Editing Macros.
Allow non-ASCII characters in typed string triggers.
Command or Control keys, or Shift-Space cancels a typed string trigger.
Allow delete and correct in typed string triggers.
Allow While Logged in Trigger to trigger ever second (previously the minimum was 3 seconds).
Better text insertion of non-ASCII characters with dead keys.
Extend Resize Image to support Resize to Fit option.
Enhanced Manipulate Window action to allow specifying an application.
Extended Execute Script to allow storing the output to (Named) Clipboard.
Extended Set Variable to Calculation to allow custom number formatting.
Enhanced Screen Image condition to allow &contains uniquely& and &does not contain uniquely&.
Enhanced performance of finding an image on the screen by 2 to 20 times.
Added ability to visually see images found on the screen.
Added option in Activate Application to control whether all windows are activated.
Add Move & Resize option to Manipulate Window.
Add defaults options to Move & Resize Window for Left/Right column, etc.
Added default text setting for Search Web action.
If Prompt For User Input field starts with a | then token expansion happens before separator parsing.
Support text token expansion in iTunes and QuickTime Player controls.
Added Minimize and Unminimize to Manipulate Window.
Added Select Menu Result, Mouse Click Result and Press Button Result variables to report results.
Text Tokens
New text token %|% allows you to position the cursor after insertion.
New text token %ICUDateTimeFor%.
New text token %WirelessNetwork%.
New text token %MacUUID% to identify this Mac.
Added Main,Second,Third,Internal,External as special screen indexes for %Screen%.
Support adding months or years in the ICUDateTimePlus/Minus token.
Calculation Functions
Added Main,Second,Third,Internal,External as special screen indexes for SCREEN().
Added . notation for accessing point/rectangle coordinates (eg Screen1.width).
Added Context Sensitive Calculation Functions:
IMAGE(Width|Height) – the action image size.
SOURCEIMAGE(Width|Height) – the action source image size.
WINDOW(Left|Right|Top|Bottom|Width|Height|MidX|MidY) – the action window coordinates.
LENGTH() – the action text length.
FONTSIZE() – the original font size during the Apply Style action.
Added an optional percentage offset to the coordinate functions, eg SCREEN(External,Left,52%).
Added CLIPBOARDSEED() function which changes when the clipboard does.
Allow Em or En dash or Unicode Minus symbol as synonyms for minus in calculations.
Conditions
Added USB Device Condition to test for the existence of specific devices.
Added Wireless Network Condition to test for connections to specific networks.
Added Text Condition.
Enhanced Menu condition to test for marked (checked) menus.
Enhanced Button condition to test for checkbox states.
Enhanced Front Window condition to test non-front applications.
Collections
Added the ability to count downwards in the Range collection.
Removed the ability of the AppleScript process tokens command to leak Password/PW variables.
Added com.adobe.illustrator.hfs to the excluded clipboard flavour list.
Removed default 0.01 delay between adding keys to the event queue.
Reduced the overhead of Pause Until.
Added option to disable a macro group on just this Mac.
Added &reload& AppleScript command to the editor.
Consider a focussed sheet to be the front window for window indexing purposes.
Requires Mac OS X 10.8+
64-bit only with Automatic Reference Counting.
Web Server is built into Keyboard Maestro Engine.
Capslock disabled the Command-Tab Keyboard Maestro application switcher.
Worked around an issue where Safari copies non-text data.
Move Mouse, with Restore Mouse Location checked but hidden, does nothing.
Added code to remove &safe save& .dat files from preferences folder.
Fixed issue if Application Switcher is triggered with just the shift key as a modifier.
Fixed Switch to Next Application erroneous timeout abort.
Fixed the power calculation (x^y).
Fixed the ternary calculation (x?y:z).
Fixed sorting characters showing up in macro group palette titles.
Fixed a potential crash involving windows without titles.
Fixed finding an image on the screen on Retina screens.
now to try all these great capabilities. Or keep reading for even more details about the
of Keyboard Maestro.
Alternatively, you can
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.
Feedback Form
Please provide any feedback you may have
Email Address:
Your email address is appreciated but is not required and will not be saved.
It will be used only for responding to or clarifying this feedback.
Old Documentation