User Tools

Site Tools


manual:Whats_New

Differences

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

Link to this comparison view

Next revision
Previous revision
Next revision Both sides next revision
manual:Whats_New [2018/11/21 20:44]
peternlewis [Full AppleScript Support in the Editor]
manual:Whats_New [2021/10/01 02:33]
peternlewis v10
Line 1: Line 1:
 ====== What’s New? ====== ====== What’s New? ======
  
-Keyboard~~Maestro~~expands on the powerful base of previous versions, ​enhancing ​the editor, expanded MIDI support, adding ​comprehensive AppleScript support, revamped clipboard switchers, lots of new actions and additions to the engine. Keyboard~~Maestro~~requires ​OS X 10.10.0 Yosemite or later (10.10.or later recommended).+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.
  
-==== 8.2.4 ====+==== Editor ​====
  
-Fix for Mojave ​to ensure ​macros ​work immediately ​after enabling Accessibility permissions.+Added configurable Favorite Actions. ([[https://​forum.keyboardmaestro.com/​t/​can-i-add-custom-action-to-other-actions-and-for-it-to-be-searchable-and-have-a-custom-name/​4843|forum]]) ([[https://​forum.keyboardmaestro.com/​t/​macro-kmfam-favorite-actions-and-macros/​4854|forum]]) 
 +* Added Select Macro by Name, as well as This Macro and This Macro Group options to the macro selector popup. ([[https://​forum.keyboardmaestro.com/​t/​request-make-it-easier-to-choose-a-macro-for-actions-like-enable-disable-macro/​22807|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 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. ([[https://​forum.keyboardmaestro.com/​t/​suggestion-macro-inspector-executed-by/​8182|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. ([[https://​forum.keyboardmaestro.com/​t/​is-there-any-shortcut-to-move-actions/​2244|forum]]) 
 +* Support shift-insert action to insert the action above the current selection. ([[https://​forum.keyboardmaestro.com/​t/​feature-request-insert-action-above/​23927|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 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.
  
-==== 8.2.3 ====+==== Engine ​====
  
-* Clarified text of "Save ... Between Launches"​ preferences. +* Added option to include ​Macro Groups in the status menu bar. ([[https://​forum.keyboardmaestro.com/​t/​feature-request-add-optional-customizable-status-menus/19249|forum]]
-* Adjusted sort order of hot keys to put function keys at the end of the alphabet. +Updating icons and title. 
-* Added "​push"​ as a search synonym for Press a Button action. + * Updating information in the menu. 
-* Ensure View-Disable ​Macro Group is disabled for the Global Macro Group. ([forum](https://​forum.keyboardmaestro.com/​t//​10949)+ * Executing on selection or automatically when the menu is displayed. 
-Resolved a case where the Clipboard Switcher ​could fail to open+ * Added Group Status Menu trigger. 
-Fixed a crash in the editor related ​to cached compiled scripts.+* 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. 
 +* 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.
  
-==== 8.2.2 ====+==== Triggers ​====
  
-* Added some synonyms for “Highlight”. +* Added Unlock trigger. ([[https://​forum.keyboardmaestro.com/​t/​execute-macro-every-time-mac-unlocks/2347|forum]]
-* Added Characters section to Insert Token by Name menu ([forum](https://​forum.keyboardmaestro.com/​t//​10784)). +Added Appearance Changed trigger. ​([[https://​forum.keyboardmaestro.com/​t/​trigger-request-change-in-dark-mode/21119|forum]]
-Fixed the kmtrigger: URL handler when the value is explicitly empty (“value=”) ​([forum](https://​forum.keyboardmaestro.com/​t//​10370)). +Added Online Status Changed trigger
-Fixed SystemVolume token to return 0 when muted+Added Power Status Changed ​trigger. 
-Tweaked the Assistance Window text for "take some action that should ​trigger ​this macro" ([forum](https://​forum.keyboardmaestro.com/​t//​10301/​6))+Added “long press” option ​for Hot Key and USB Device Key triggers
-Tweaked display of inline popup menus for Mojave+Disallow adding duplicate redundant triggers ​(like two Power Status Changed triggers).
-Updated OpenCV resulting in a noticeable improvement in image matching performance. +
-* Possibly resolve a crash on engine quit (MyDeviceData release)+
-* Possibly resolve a crash involving capturing a window. +
-* Adjust some things in the hope of resolving the engine crash in High Sierra.+
  
-==== 8.2.1 ====+==== Actions ​====
  
-* Added created:1w, modified:​1d,​ used:1h filters(see [[manual:​Search_Strings|Search Strings]]) +* Added Paste by Name action giving Spotlight-like search of clipboard history
-* Added an option to omit the title bar from palette themes(see [[manual:​Palettes#​Controlling_The_Display_of_Palettes|Palettes]]) +* Added Prompt for Screen Rectangle/​Location
-* Added USB Device Keys to the gethotkeys AppleScript results. +* Added Try/Catch and Throw actions. ([[https://​forum.keyboardmaestro.com/​t/​email-notification-upon-macro-failure/18416|forum]]) ([[https://​forum.keyboardmaestro.com/​t/​feature-request-try-catch-finally/5954|forum]]
-* Added a few more locations to look for 1Password bookmarks. +Added Display Progress action
-* Fixed a bug with USB Device Key triggers when changing pressed/release mode. ([forum](https://​forum.keyboardmaestro.com/​t//​9848)+Added Display Progress option to For Each action
-* Fixed a bug with typing text into the columns field of the theme editor. +Added a Pause Until Change ​action ​to detect clipboard, modifiers, keyboard, ​mouse, or application changes
-* Fixed password variable names (not values!) showing up in the Variables preferences. ​([forum](https://​forum.keyboardmaestro.com/​t//​2669/6)+Added Create Unique File action.
-Fixed some sanitiser issues+
-Fixed an issue with contextual menus+
-Fixed an issue with Read File action ​menus occluding text fields. +
-* Fixed an issue on some Macs with popup menus turning white on mouse over([forum](https://​forum.keyboardmaestro.com/​t//​9989)) +
-Fixed an issue with glitched display of text fields in some actions. ([forum](https://​forum.keyboardmaestro.com/​t//​9307)) +
-* Fixed an issue with palette placement when the screen resolution changes.+
  
-==== 8.2 ====+==== Added additional field types to the Prompt for User Input action ​====
  
-* Added a new [[manual:​Applications_Palette|Applications Palette]] which displays running applications+ * Added Date, Time and Date & Time picker fields
-* Added [[action:​Apply_Modifiers_to_a_Specific_Application|Apply Modifiers ​to a Specific Application]] ​action (mimics the behaviour of [[manual:Applications_Palette|Applications Palette]]). + * Added Slider fields. 
-* Added [[trigger:Dragged_File|Dragged File]] trigger to support dragging files to macros in macro palettes. + * Added Color Well fields. 
-* Added a Macro Library entry for an Application Palette group (set of fixed applications displayed as a palette). +* Added icon chooser selection ​to Set File Icon and Set Clipboard to Image and other actions. 
-* Warn about translocated applications when setting them in the Application popup menus. +* Added support for selecting multiple files or folders in the Prompt For File action([[https://​forum.keyboardmaestro.com/​t/​prompt-for-multiple-files/​15297|forum]]). 
-* Fixed an issue with Prompt With List (and other By Name windows) ​([forum](https://​forum.keyboardmaestro.com/​t//​9596/)). +* Added support for creating the folder when selecting a new folder in the Prompt For File action. 
-Fixed i‗displayWhat != NamedClipboardPopupMenuControllerDisplay::kUnknown assertion. +* Added separated by option to Substrings In collection. ([[https://​forum.keyboardmaestro.com/​t/​suggestion-for-new-collection-for-for-each-list-items/​23014/​4|forum]]) 
-* Fixed i‗displayAttributedString assertion+* Added option to control text processing of input text for a variety ​of actions. ([[https://​forum.keyboardmaestro.com/​t/​bug-regex-replace-that-converts-some-text-to-lower-case-in-error-macro-v9-2/21168|forum]]
-Fixed issue with Set File Attribute field kind mark and token insertion. ([forum](https://​forum.keyboardmaestro.com/​t/​9695/3)). +Added option to Search & Replace to replace only the first or last match. ([[https://forum.keyboardmaestro.com/​t/​request-add-switch-to-km-search-replace-to-turn-global-matches-on-off/​22986|forum]]) 
-Fixed an issue with AppleScript creation of actions.+Added option to control volume of Speak Text action. ([[https://​forum.keyboardmaestro.com/​t/​speak-text-volume/18362|forum]]) 
 +* Added a variety of macro environment variables (eg KMINFO_TriggerValueto 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 ====
  
-==== 8.1.1 ====+* Added Filter Sort, Reverse and Shuffle Lines. ([[https://​forum.keyboardmaestro.com/​t/​help-randomizing-a-list-of-words/​3409|forum]])  
 +* Added Filter Escape for Regular Expression. 
 +* Added Filter Quote for JSON. 
 +* Added Filter URL components such as scheme, host and path. ([[https://​forum.keyboardmaestro.com/​t/​extract-domain-from-url-with-regex/​15736/​8|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, and internalized it to remove perl dependency.
  
-* Fixed Append to File action. ([forum](https://​forum.keyboardmaestro.com/​t//​9461)) +==== Tokens ====
-* Fixed AppleScript for creating dictionaries and dictionary keys. ([forum](https://​forum.keyboardmaestro.com/​t//​9421)) +
-* Fixed an issue with Trigger Macro by Name. ([forum](https://​forum.keyboardmaestro.com/​t//​9456))+
  
-==== 8.1 ====+* Added LastWindowID token. 
 +* Added PromptWithListText token. 
 +* Added PasteByNameText token. 
 +* Added UserHome token. 
 +* Added FinderSelections and FinderSelection tokens. 
 +* Added AccessedVariables token.
  
-* Added initial search string to Prompt With List action. ([forum](https://​forum.keyboardmaestro.com/​t//​7998)) +==== Functions ====
-* Added title to Prompt With List action. ([forum](https://​forum.keyboardmaestro.com/​t//​7998)) +
-* Added configurable width to Prompt With List action. ([forum](https://​forum.keyboardmaestro.com/​t//​7998)) +
-* Added automatic width to Prompt With List action. +
-* Write File trashes any pre-existing target file/​directory before writing (rather than overwriting directories!). ([forum](https://​forum.keyboardmaestro.com/​t//​9396)) +
-* Highlight undisclosed "(n actions)"​ when search matches within the actions. ([forum](https://​forum.keyboardmaestro.com/​t//​9197)) +
-* Added parameter to Execute Macro action title ([forum](https://​forum.keyboardmaestro.com/​t//​9185)) +
-* Added ApplicationBundleID token. +
-* Changed "​Assert unless"​ to "​Assert that" which is more correct phrasing. +
-* Fixed Prompt with List Prompt not being horizontally centered. ([forum](https://​forum.keyboardmaestro.com/​t//​7998)) +
-* Fixed a possible crash with Custom HTML Prompt if JavaScript closes the window immediately. ([forum](https://​forum.keyboardmaestro.com/​t//​9080)). +
-* Fixed bug with Find Image (et al) and local variables. +
-* Fixed selecting New... in Named Clipboard popup menus. ([forum](https://​forum.keyboardmaestro.com/​t//​9405)) +
-* Compiled with Xcode 9.2+
  
-==== 8.0.5 ====+* Added DOUBLECLICKINTERVAL,​ KEYREPEATDELAY,​ KEYREPEATINTERVAL functions. 
 +* Added SCREENINDEX function that returns the index of the specified screen.
  
-* Added support for frames in [[actions:​Browser_Form_Actions|actions:​Browser Form Actions]]. +==== Clipboard History ​====
-* Support local and instance variables in Calculate and ProcessTokens from [[action:​Custom_HTML_Prompt|Custom HTML Prompt]] actions. +
-* Option-click the Favorites button in [[manual:​Clipboard_History_Switcher|Clipboard History ​Switcher]] to toggle “Favorites Only”. +
-* Fixed a problem with Clipboard History not showing after certain copied data. +
-* Fixed the Switch action not processing text tokens. +
-* Improved the unused variable warning for the For Each action. +
-* Fixed MIDI trigger "​increases"​ setting not sticking. +
-* Fixed an issue with AppleScript editing a macro that was not visible to the current search filter. +
-* Fixed an issue with latest version of Microsoft Word and restoring the clipboard.  +
-* Fixed a few typos.+
  
 +* Added Characters / 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.
  
-==== 8.0.4 ====+==== Custom HTML Prompt ​====
  
-* Added "​increases"​ and "​decreases"​ options ​to MIDI controller change trigger ([forum](https://​forum.keyboardmaestro.com/​t//​7944)) +* Added ProcessAppleScript command ​to Custom HTML Prompt
-* Support array index for many tokens (eg `%TriggerValue[3]%`). +* Added option ​to turn off title bar on Custom HTML Prompt window. ([[https://​forum.keyboardmaestro.com/​t/​why-isnt-custom-html-prompt-resizable/4602/​8|forum]]
-  * `FrontWindow*`,​ `Window*`, `Screen*`. +Added option to make Custom HTML Prompt window transparent. ([[https://​forum.keyboardmaestro.com/​t/​why-isnt-custom-html-prompt-resizable/​4602/8|forum]]
-  * `SystemClipboard`,​ `PastClipboard`,​ `NamedClipboard`,​ `TriggerClipboard`. +Added context sensitive WINDOW function for Custom HTML Prompt window resizing operations
-  * `TriggerValue`,​ `CurrentMouse`,​ `FoundImage`+
-* Added Search & Replace and Count/Find facility ​to Keyboard Maestro Engine AppleScript dictionary. +
-* Added Report Updates Only When Editor Activates to General Preferences. +
-* Added more clipboard flavor exclusions for Microsoft Word to yet again avoid the bookmark link issue. +
-* Remember Clipboard Switcher Info button setting. +
-* Worked around Chrome not liking certain characters in JavaScript strings ​([forum](https://​forum.keyboardmaestro.com/​t//​8195)). +
-Detect case where either the Engine or editor is translocated (previously only detected case where both were). +
-* Fixed an issue where you could not edit some fields in disabled actions ​([forum](https://​forum.keyboardmaestro.com/​t//​8185)). +
-Fixed Dictionary Key condition field not saving when you typed in to it.  +
-* Fixed Command-K toggling the Action Selector.+
  
-==== 8.0.3 ====+==== Debugger ​====
  
-Prompt For User Input supports Local/​Instance variables ​([forum](https://​forum.keyboardmaestro.com/​t//​7946)). +Added a button in the debugger to edit the macro action. ​([[https://​forum.keyboardmaestro.com/​t/​request-provide-km-macro-debugger-button-to-take-you-to-the-editor-macro-in-use/14111|forum]]
-Custom HTML Prompt supports Local/​Instance ​variables ([forum](https://​forum.keyboardmaestro.com/​t//​7946)). +Added display of recently accessed ​variables ​in the debugger. ​([[https://​forum.keyboardmaestro.com/​t/​request-provide-dynamic-display-of-macro-variables-in-debugger/13655|forum]]) ([[https://​forum.keyboardmaestro.com/​t/​bug-report-local-instance-variables-show-in-variable-token-list/14241/2|forum]])
-* Local/​Instance varibles passed as environment variables to scripts ​([forum](https://​forum.keyboardmaestro.com/​t//​7946)). +
-* Allow reading and writing Local/Instance variables from AppleScripts (via [[/​AppleScript#​Examples|KMINSTANCE environment variable]])+
-* Added [[action:​Custom_HTML_Prompt#​Using_JavaScript|KMWillCloseWindow()]] call when window will close in Custom HTML Prompt. +
-* Added [[action:​Custom_HTML_Prompt#​Using_JavaScript|GetDictionary() and SetDictionary()]] in Custom HTML Prompt. +
-* Corrected the spelling of "​matches"​ in the Cron entry in the trigger menu. +
-* Allow [[action:​Split_Path|Split Path]] action to split just file names (parent path will be "/​Nowhere"​). +
-* Added Edit => Automatic Completions toggle menu item. +
-* Support Type Ahead in the Clipboard Switcher. +
-* Fixed an issue with Search & Replace. +
-* Added trigger to VoiceOver for macros. +
-* Adjusted highlight color when Graphite highlight color is chosen.+
  
-==== 8.0.2 ====+==== AppleScript ​====
  
-Ensure changes are saved after selecting variable/​function/​tokens by name ([forum](https://​forum.keyboardmaestro.com/​t//​8044))+Added support for getting and setting the Display in Menu Bar Macro Group settings via AppleScript
-Fixed the spelling of "​Systen"​ in Write System Clipboard to File. ([forum](https://​forum.keyboardmaestro.com/​t//​7948/13)) +Added “xml” AppleScript property for macros, macro groups and smart groups. ([[https://​forum.keyboardmaestro.com/​t/​suggestion-quick-diff-for-macros-inside-km/20307/6|forum]]
-* Set Clipboard to clipboard filters in the Clipboard Switcher were pasting. ([forum](https://​forum.keyboardmaestro.com/​t//​8072)+Added “group xml” AppleScript property for macro groups
-Corrected the Tool Tip of the Action and Trigger warnings([forum](https://​forum.keyboardmaestro.com/​t//​8044)) +Added “last used” AppleScript property for macros. ([[https://​forum.keyboardmaestro.com/​t/​km-last-execution-date/16166|forum]]
-Avoid a crashing bug when renaming ​macros. ([forum](https://​forum.keyboardmaestro.com/​t//​8057)) +Added “modification date” AppleScript property for macro groups ​and smart groups
-* Forcibly remove any invalid variables from variable database. ([forum](https://​forum.keyboardmaestro.com/​t//​7946/49)) +Added AppleScript support to the editor for showing preference panes
-* Adjusted Play a Specific Tracklist to play more than the first track. ([forum](https://​forum.keyboardmaestro.com/​t//​7960)+Added support for AppleScript “edit” command, ​eg “edit macro 1”
-Fixed deactivating ​macro groups ​that are configured Always Activated([forum](https://​forum.keyboardmaestro.com/​t//​8018)) +Added support for AppleScript to get/set the editing property of an editor window
-Fixed issues with hot key errors+Added option ​to Search & Replace to replace only the first or last match
-Adjusted Local and Instance variables to not require the space (eg "​LocalVar"​)+* Added instance parameter to process tokens and calculate commands
-Remove line endings from macro names+Added selectAction command to select a specific action by id
-Limit export file names to 200 characters+Added divider1 and divider2 properties ​to the editor window
-* Added more search keywords for Get File Action+Added size property ​to Macro Groups and Macros.
-Reduced some debugging messages with Plug In Actions+
-Removed some warnings related ​to unknown menus+
-Reduced debugging related ​to invalid regular expressions.+
  
-==== 8.0.1 ====+==== Minor ====
  
-Fixed a bug with non-matching capture groups in search & replace action. +Added SF Symbols to Icon Chooser (11.0+) 
-* Fixed a bug that could cause the engine crash when a palette closed. +* Added Export as Text Service
-* Fixed an issue in 10.10 where "​R"​ is removed from macro names! +* Added Export as Finder Quick Action
-* Fixed a display issue with the Variable condition display. +* Show notification when the launching editor quits the engine
-* Fixed the Run Macro menu always being disabled. +Excluded com.microsoft.ole.source..* flavors from clipboard for better Microsoft compatibility
-* Fixed an issue with the Search & Replace action. +Adjusted Copy action ​to note clipboard changes even if the clipboard is not read. ([[https://​forum.keyboardmaestro.com/​t/​copy-function-timeouts-without-updating-system-clipboard/​14959/23|forum]]) 
-* Fixed behaviour of "case must match" Typed String triggers. +Adjusted VoiceOver to speak marked status in palette entries. ([[https://​forum.keyboardmaestro.com/​t/​midi-control-change-for-blind-users/​20031/29|forum]]) 
-* Fixed Tool Tip of Info button in Clipboard Switcher +Use ENV_PWD ​to set the current working directory for shell scripts. ([[https://​forum.keyboardmaestro.com/​t/​node-js-dirname-pointing-to-a-temporary-folder/23570/9|forum]]) 
-* Possibly worked around High Sierra Color Picker crash when editor launches. +Improved the Share to Forum sheet. ([[https://​forum.keyboardmaestro.com/​t/​suggested-ui-change-for-sharing-uploading-macros-actions-from-km-editor/14909|forum]]) 
-* Removed double-struct L and I for Local and Instance variables. +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). ([[https://​forum.keyboardmaestro.com/​t/​help-to-create-a-macro-list-delimiters-item-enumeration/20223/8|forum]]) 
-===== 8.0 ===== +Converted use of WebView ​to WKWebView 
- +Improved appearance of Preferences toolbar in Big Sur.  
-==== Editor Improvements ==== +Improved display of CALCULATE function ​when the contents are potentially ​valid. 
- +Support Return/​Enter as a keystroke for the ↩ character in the Conflict Palette. ([[https://​forum.keyboardmaestro.com/​t/​space-or-return-to-trigger-the-first-macro-in-a-conflict-panel/​23327/​8|forum]]) 
-* Added new [[manual:​Assistance|Assistance]] system to help novices trouble shoot any early issues. +* Added Audio Input and Camera entitlements ​to the Engine ​(to allow their use via scripts etc). 
-* Large Text size support in editor lists (Macros, Groups, Library, etc)+* Added Restore Excluded Application entry to Applications ​Palette ​contextual menu
-* Added Machine Learning system to By Name selectors+* Added Tooltips for Palettes. ([[https://​forum.keyboardmaestro.com/​t/​feature-request-palette-with-icons-only-show-hints/3739|forum]]) ([[https://​forum.keyboardmaestro.com/​t/​request-tooltips-for-palette-nuttons/16273|forum]]) 
-Support dragging macros and macro groups into the macro action list. +* Added AdditionalWebBrowserBundleIDs preference to add alternative bundle IDs for front browser list
- * No modifiers: Execute the Macro / Show the Macro Group +Allow Microsoft Edge as a possible ​Front Browser Chrome-equivalent. 
- * Option: insert a copy of the macro’s actions +* Allow Spotlight-like windows to be movable
- * Command-Shift:​ Enable the Macro / Macro Group +Adjusted the hit boxes for various application and macro popup menus. ([[https://​forum.keyboardmaestro.com/​t/​moving-actions-that-have-selection-options-within-a-macro/22335|forum]]) 
- * Option-Shift:​ Mark the Macro +Report lack of Screen Recording permission when that stops an action ​from working
-* Added dragging of macros/​macro groups to action macro selector popup menus+Better reporting of lack of Screen Reporting errors in Find Image and Click Mouse actions. 
-Support dragging files in as macros or actions. +* Added control over OCR Image behaviour when the action ​fails
- * Applications as Activate Application action. +The Macro Group macros in the Global ​Macro Palette use the Macro Group’s custom icon if any
- * Scripts as the appropriate Execute Script action. +Prompt For User Input no longder displays hidden fields ​in non-edit mode. ([[https://​forum.keyboardmaestro.com/​t/​plug-ins-hidden-parameters-showing-in-editor/22521|forum]]) 
- * Other files as Open File actions. +Switched ​to CWWiFiClient ​for Wireless Network triggertoken and conditions. 
-* Added basic Touch Bar support. +Display some editor alerts within ​the editor window
-Added Actions menu+Display some logged error messages more prominently
-Added Run Macro menu and toolbar item to run the currently selected macro. +Display time trigger time in localized format in non-edit mode
-* Added Engroup Actions (into a new Group, Macro, For Each, While, etc) ([[https://​forum.keyboardmaestro.com/​t//​3538|forum]]). +Avoid logging repeated errors
-Added Degroup Actions. +Adjusted Write File to fail rather than trash folder that will be replaced ​with a file([[https://forum.keyboardmaestro.com/t/​setting-path-as-folder-in-write-to-file-empties-the-folder/​23666/​19|forum]]) 
-* Added Paste Replacing for actions ​([[https://​forum.keyboardmaestro.com/​t//​4904|forum]]). +Only report large variables excluded from environment every ten minutes
-Added Select Macro by Name. +* Added appropriate window titles (visible via AppleScript/​accessibility) ​to the various “By Name” windows. ​([[https://​forum.keyboardmaestro.com/​t/​how-to-get-the-position-of-a-keyboard-maestro-user-prompt-window/24011|forum]]) 
-* Added Insert Function by Name. +* Avoid selecting the macro/group name when deleting macro/​groups
-* Added Insert Token by Name. +* Added action id to failed action log message. ([[https://​forum.keyboardmaestro.com/​t/​error-handling-debugging-line-numbers/14133|forum]]) 
-* Added Insert Variable by Name. +* Added a few more default ​status menu icon options
-* Added File ➤ Share menu. +* Added additional protections for the Write File action
-* Added Import Macros Disabled menu command. +Fixed activation of windows so you can use the Clipboard Switcher ​to paste in to other Keyboard Maestro Engine windows
-* Adjusted Import Macros menu command ​to require ​the Option key. +Fixed bug enabling the Send button ​in the Report Bugs form (irony). 
-* Added Edit ➤ Insert Token ➤ Named Clipboard hierarchical menu. +Fixed width of Trigger Macro by Name and other Spotlight-like windows ​in Big Sur. ([[https://​forum.keyboardmaestro.com/​t/​display-bug-in-trigger-macro-by-name-layout-in-big-sur/​20711/4|forum]]) 
-* Added %Delete% to the Insert Token menu. +Fixed Paste XML actions. ​([[https://​forum.keyboardmaestro.com/​t/​what-is-the-status-of-the-paste-xml-action-feature/21815|forum]]). 
-* Show an indiciator of the kind (token, variable, calculation) of each field in the editor. +Fixed an issue with Prompt For User Input and long variable names. ​([[https://​forum.keyboardmaestro.com/​t/​request-stop-shortening-long-variable-names-in-prompt-for-user-input/16271|forum]]). 
-* Support negation (-) in the search fields ​([[https://​forum.keyboardmaestro.com/​t/​/​4343|forum]]). +Fixed an issue with a couple ​actions ​not saving changes when a token was selected
-* Default ​to last used variable when creating new actions. +Fixed an issue with file references ​to images that included non-ASCII characters
-* Support changing Safari actions to/from Google Chrome actions. +Improve accessibility ​of editor toolbar buttons
-* Support styled text in comments. +Fixed Login Window action ​in Big Sur  (CGSession no longer exists)
-* Added an option to hide disabled macro groups. +Fixed display issue for popup menus in Plug In Actions. ([[https://​forum.keyboardmaestro.com/​t/​bug-report-parameter-display-truncated-in-third-party-plug-ins/22694|forum]]) 
-* Added wiki search to Help menu.  +* Fixed Trim Image to keep the full resolution and DPI
-* Added Make Alias for macros (and command-option dragging macros to groups). +* Fixed a potential ​crash with the Reveal a File action
-* Play Sound supports sounds in ~/​Library/​Sounds and ~/Sounds. +* Fixed an issue related to ^ in the Substrings In collection. ([[https://​forum.keyboardmaestro.com/​t/​issue-with-regex-in-for-each-to-extract-first-string-in-each-line/22724|forum]]) 
-* Click on macro group label (top right) to select the enclosing macro group. +* Fixed an issue where renaming a macro via the contextual menu would not scroll the name field in to view
-* Adjusted the disclosure behaviour of Execute Macro action. +* Fixed an issue with Search ​and Replace matching multiple times at the end of the string. ([[https://​forum.keyboardmaestro.com/​t/​keyboard-maestro-regular-expression-bug-trim-whitespace-from-start-and-end-of-a-string/22963|forum]]). 
-* Added Space, Escape, and Help to the Hot Key selection menu. +* Fixed an issue where the engine might not be notified of macro changes if the editor is quit immediately after making the change.
-* Added disabled color to the action color menu to indicate the color means a matched search. +
-* Added Copy as XML to copy macro groups, macros or actions as XML ([[https://forum.keyboardmaestro.com/​t//​3842|forum]]). +
-Added View ➤ Select Groups Column menu item. +
-* Added View ➤ Select Macros Column menu item. +
-* Added View ➤ Edit Name menu item. +
-* Added View ➤ Reveal Parent Group menu item. +
-* Added View ➤ Last Used, Last Edited, Previous Edited, Next Edited menu items ([[https://​forum.keyboardmaestro.com/​t//​5462|forum]]). +
-Added Select Macro option to macro selector popup menu. +
-* Added Philippe Martin'​s Multiple Clipboards to the Macro Library+
-Added Rename Finder Files to the Macro Library. +
-* Show a warning on "​Press ​and Hold" actions that are the last action of the macro. +
-* Show a warning when using Open File to open applications with the Default Application. +
-* Show a warning when an Application trigger cannot fire because of the macro group'​s settings. +
-* Show a warning when a For Each action does not use its variable. +
-* Show a warning when a string containing test looks like it should be a string matching test+
-* Support ​pasting XML actions ​([[https://​forum.keyboardmaestro.com/​t//​3842|forum]]). +
-* Changed to a patterned color for the search matching indicator ​([[https://​forum.keyboardmaestro.com/​t//​4934|forum]]). +
-* Color invalid Calculation conditions ([[https://​forum.keyboardmaestro.com/​t//​3891|forum]]). +
-Adjusted the appearance ​of disabled actions ​to make them more clearly disabled ([[https://​forum.keyboardmaestro.com/​t//​7476|forum]]). +
-Support quitting the editor by closing the editor window+
-When showing a mapping from an empty variable show italic "​empty"​. +
-* Show "No Forms Found" (etc) when Safari/​Chrome popups cannot find any valid entries ([[https://​forum.keyboardmaestro.com/​t//​2513|forum]])+
-Minor tweaks to the overall appearance. +
-* Removed misleading "​Matching"​ from Search & Replace "​String"​ search. +
-* Double clicking icon image wells opens and sets the Icon Chooser. +
-* The Modifiers condition no longer allows setting a modifier to be both pressed and not pressed ​([[https://​forum.keyboardmaestro.com/​t/​/​2460|forum]]). +
- +
-==== Full AppleScript Support in the Editor ==== +
- +
-* Macro Groups, Smart Groups, Macros, Triggers, Actions are all [[/​Scripting_the_Keyboard_Maestro_editor|AppleScript OSA objects]]. ​ Examples: +
- * properties of smart group "​Enabled"​ +
- * make new smart group with properties {name:"​Enabled",​ search strings:​{"​enabled:​yes"​}} +
- * set search strings of smart group "​Test2"​ to {"​ABC",​ "​DEF"​} +
- * set name of macro 1 to "​Great!"​ +
- * tell macro group "New Stuff" to make new macro +
- * select action 1 through 3 of action 2 of macro "​Working"​ +
- * set enable of macro group "Turn Off" to false +
- * set color of action 1 of macro "​Bright"​ to "​red"​ +
- * set selection to global macro group +
- * move first action of macro "​Source Macro" to end of actions of macro "Dest Macro"​ +
- * delete second action of macro "​Target Macro"​ +
- * duplicate every macro group whose name starts with "​Test"​ +
- * set m to duplicate action 1 of macro "​Macro33"​ to after action 2 of macro "​Macro32"​ +
- * duplicate (selected macros) to macro group "​Test4"​ +
- +
-==== Revamp Clipboard History Switcher & Named Clipboard Switcher ==== +
- +
-* New combined appearance. +
-* Additional information (source, type, size, pixel size, time, index). +
-* Drag Reordering. +
-* Drag from the switcher to image or text fields. +
-* Contextual menu to Paste, Paste Plain, or Paste Image, Duplicate. +
-* Contextual menu to just set the current clipboard without pasting. +
-* Large Text size support ​in Clipboard Switchers. +
-* Support excluding applications from the clipboard history. +
- +
-==== Expanded MIDI Support ==== +
- +
-* Added [[trigger:​MIDI|MIDI Control Change]] trigger. +
-* Added [[trigger:​MIDI|MIDI raw packet]] trigger (SysEx, HUI protocol, etc)+
-* Support MIDI trigger recording when the text fields are focused in background. +
-* Added [[actions:​Send_MIDI|Send MIDI]] raw packets so you can send any kind of MIDI packet. +
-* Send MIDI action uses calculations so you can send varying notes and control changes. +
-* Handle and split multiple MIDI packets received in a single system MIDI packet. +
- +
-==== Added Local and Instance Variables ==== +
- +
-* Added the concept of [[manual:​Variables| Local Variables]],​ local to the macro they are in. +
-* Added the concept of [[manual:​Variables| Instance Variables]],​ local to macro execution group they are in. +
- +
-==== Added Dictionaries ==== +
- +
-* Added the concept of [[Dictionaries|dictionaries]],​ mapping ​(case insensitively) a dictionary name and key name to a value. +
-* Added Set Dictionary Value action. +
-* Added %Dictionary[Dict,​Key]% text token. +
-* Added collection of Dictionaries and Keys in a Dictionary. +
-* Added full AppleScript support for accessing Dictionaries. +
- +
-==== New Triggers ==== +
- +
-* Added [[trigger:​Cron|Cron]] trigger. +
-* Added [[trigger:​Gesture|Gesture]] triggers drawn with the trackpad or mouse. +
-* Added [[trigger:​Remote|Remote]] trigger ​via a Keyboard Maestro server. +
-* Added [[trigger:​Clipboard_Filter|Clipboard Filter]] trigger. +
-* Added [[trigger:​Audio_Output_Changed|Audio Output Device Changed]] trigger. +
-* Added [[trigger:​Idle|Idle]] trigger (trigger after the Mac is idle for N minutes). +
-* Added Export Trigger File which lets you trigger a macro by opening a file. +
- +
- +
-==== New Actions ==== +
- +
-* Added [[action:​Show_Palette_of_Macros|Show ​Palette ​of Macros]] action with (optional) Touch Bar action+
-* Added [[action:​Get_Touch_Bar_Selection|Get Touch Bar Selection]] action. +
-* Added [[action:​Prompt_With_List|Prompt With List]] action ​([[https://​forum.keyboardmaestro.com/​t//​4665|forum]]). +
-* Added [[action:​Get_a_URL|Get a URL]] action (including getting images) ([[https://​forum.keyboardmaestro.com/​t//​7578|forum]]). +
-* Added [[action:​Remote_Trigger|Remote Trigger]] action+
-Added [[action:​Trigger_Macros_by_Hot_Key|Trigger Macros by Hot Key]] action. +
-* Added [[actions:​Browser_Actions|Front Browser]] actions that work on the most front Safari or Chrome ​browser ([[https://​forum.keyboardmaestro.com/​t//​5451|forum]])+
-Added stdin input for [[action:​Execute_a_Shell_Script|Execute a Shell Script]] action. +
-* [[actions:​Send_Message|Send SMS/​iMessage]] Action ​([[https://​forum.keyboardmaestro.com/​t//​7420|forum]]). +
-Added [[action:​Prompt_for_File|Prompt For File/​Folder]] ​action. +
-Added [[actions:​Redirect_Control_Flow|Continue Loop]] action (continues on to the next iteration)+
-* Added [[actions:​Redirect_Control_Flow|Retry This Loop]] action (restarts ​the current iteration). +
-* Added [[action:​Assert|Assert]] ​action. +
-Added [[action:​Split_Path|Split Path]] action to split a path into its component parts. +
-* Added File as an input/​output to many text actions. +
-* Added File and Text as an input option to [[collection:​Lines_In|Lines In]] & [[collection:​Substrings_In|Substrings In]] collections. +
-* Added initial value to [[action:​Trigger_Macro_by_Name|Trigger ​Macro by Name]] action. +
-* Added option to restrict the macros in the [[action:​Trigger_Macro_by_Name|Trigger ​Macro by Name]] action+
-Added option to include inactive or disabled macros ​in [[action:​Trigger_Macro_by_Name|Trigger Macro by Name]] action. +
-* Added option to [[action:​Play_Sound|Play Sound]] action to play asynchronously ​([[https://​forum.keyboardmaestro.com/​t/​/​7354|forum]]). +
-* Added option to [[action:​Alert|Alert]] action to play a sound ([[https://​forum.keyboardmaestro.com/​t//​7354|forum]]). +
-* Added option to [[action:​New_Folder|New Folder]] action to create intermediate folders. +
-* Added asynchronous option to [[action:​Custom_HTML_Prompt#​How_To_Use|Custom HTML Prompt]] action. +
-* Added resizable option to [[action:​Custom_HTML_Prompt#​How_To_Use|Custom HTML Prompt]] window. +
-* Added non-floating option for [[action:​Custom_HTML_Prompt#​How_To_Use|Custom HTML Prompt]] window. +
-* Added data-kmhandleschemes/​KMHandleSchemes() to [[action:​Custom_HTML_Prompt#​How_To_Use|Custom HTML Prompt]] action. +
-* Added Notify/Stop on Error to execute script actions. +
-* Set [[token:​ActionResult|%ActionResult%]] token to stderr for execute script actions. +
-* Pass parameters ​to [[action:​Trigger_Macro_by_Name|Trigger Macro by Name]] using `search ​// parameter`. +
-* Support XPath in all the Web Browser actions. +
-* Generalized [[action:​Filter|Filter]] action inputs and outputs. +
-Generalized [[action:​Search_using_Regular_Expression|Search using Regular Expression]] action inputs and outputs. +
-* Generalized [[action:​Search_and_Replace|Search and Replace]] action inputs and outputs. +
-* [[action:​Type_a_Keystroke#​Send_to_Background_App_v8|Type Keystroke Action]] can send the key to a background application. +
-* [[action:​Insert_Text_by_Typing#​Send_to_Background_App_v8|Insert Text by Typing Action]] can send the keys to a background application. +
-* Support Search and Replace action processing the input for each replacement. +
-* Added Full Screen test to Front Window condition. +
-* Added title matches option to Manipulate Window action. +
- +
-==== New Conditions ==== +
- +
-* Added `<``<=`, `=`, `>=`, `>`, `!=` numeric conditions. +
-* Added "​starts with" ​and "ends with" to string ​conditions. +
-Added "is before"​ and "is after" to string conditions that were missing them. +
-* Added [[condition:​Action_Result|Action Result]] condition. +
-* Added [[condition:​Mouse_Button|Mouse Button]] condition. +
-* Added "is hidden"​ et al to the [[condition:​Application|Application]] condition+
-Added Trigger Clipboard and Named Clipboard options to the [[condition:​Clipboard|Clipboard]] condition. +
- +
-==== New Collections ==== +
- +
-Added [[collection:​Variables|collection of Variables]]. +
-* Added [[collection:​Dictionaries|collection of Dictionaries]]. +
-* Added [[collection:​Dictionary_Keys|collection of Keys in a Dictionary]]+
-Added sort order to the [[collection:​Folder_Contents|Folder Contents]] collection. +
- +
- +
-==== New Tokens ==== +
- +
-Added [[token:​TriggerClipboard|%TriggerClipboard%]] token to return the text of the triggered clipboard. +
-* Added [[token:​KeyboardLayout|%KeyboardLayout%]] token to return the current input source. +
-* Added weekday option to [[token:​ICUDateTime|%ICUDateTimePlus/​Minus%]] tokens to find next occurrence of specific day of the week. +
-* Added [[token:​Calculate|%Hex2%,​ %Oct3%, %Dec5%, %Bin8%]] tokens to convert calculations to other bases. +
-* Added [[token:​CalculateFormat|%CalculateFormat%]] token with selected or specified format. +
-* Added [[token:​RandomUUID|%RandomUUID%]] token to generate ​random Unique ID. +
-* Added [[token:AudioOutputDevice|%AudioOutputDevice%]] token to return the currently selected Audio Output Device. +
-* Support [[/XPath|XPath]] ​in the [[token:​SafariField|%SafariField%]] (and othertokens. +
-Added [[token:​FrontBrowserTitle|%FrontBrowserTitle%]],​ [[token:​FrontBrowserURL|%FrontBrowserURL%]],​ etc tokens+
-* Added [[token:​FoundImage|%FoundImage%]] token to return ​the results of the last attempt to find an image ([[https://​forum.keyboardmaestro.com/​t//​3806|forum]]). +
-* Added [[token:​AlertButton|%AlertButton%]],​ [[token:​PromptButton|%PromptButton%]],​ [[token:​HTMLResult|%HTMLResult%]] tokens ​Deprecated equivalent variables ​([[https://​forum.keyboardmaestro.com/​t//​406|forum]])+
- +
-==== New Functions ==== +
- +
-* Added [[function:​FRONTBROWSERTABCOUNT|FRONTBROWSERTABCOUNT]],​ [[function:​FRONTBROWSERTABINDEX|FRONTBROWSERTABINDEX]],​ [[function:​FRONTBROWSERISCOMPLETE|FRONTBROWSERISCOMPLETE]] functions. +
-* Added [[function:​PIXEL|PIXEL(Red|Green|Blue|Hue|Saturation|Brightness|White|Cyan|Magenta|Yellow|Black,​x,​y)]] color function. +
-* Added context sensitive [[function:​DPI|DPI(X|Y)]] and [[function:​SOURCEDPI|SOURCEDPI(X|Y)]] functions. +
- +
- +
-==== Engine Improvements ==== +
- +
-* Added preference to show Conflict Palettes in the Touch Bar. +
-* Support text with percent characters in text functions in token fields. +
-* Only require Shift-Option-Control click on status menu to cancel all macros+
-* Added Machine Learning system to Trigger Macro by Name selector+
-Added options ​to macro groups ​to be always active and show a palette sometimes+
-Variables used in calculations can themselves contain calculations that are implicitly evaluated. +
-* Support == as synonym for = in calculations. +
-* Support negative array indices for access from end of an array (calculation or Variable token). +
-Support 0 array indices for count of the elements ​in an array (calculation or Variable token). +
-* Support executing an array of actions from AppleScript "do script"​ commands. +
-* Restore front application before executing kmtrigger: macros ​([[https://​forum.keyboardmaestro.com/​t//​5715|forum]]). +
-Display Text window closes immediately if Return is hit once ([[https://​forum.keyboardmaestro.com/​t//​6936|forum]]). +
-Added an option to turn off notifications of macro groups being activated/​deactivated ​([[https://​forum.keyboardmaestro.com/​t//​3902|forum]]). +
-Adjusted Typed String triggers ​with "​affects ​actions" option to only uppercase the first letter+
-Added "​Activate Clipboard Switcher" ​to the Paste status menu+
-Periodically write the clipboard history to disk. +
- +
- +
-==== Minor Improvements and Changes ==== +
- +
-* Removed or renamed confusing use of "​Default Clipboard"​+
-Prefer %SystemClipboard% over the older %CurrentClipboard%. +
-* Support Home/​End ​in Trigger Macro By Name and Add Action windows+
-Adjusted the Select Menu action to return ​failed ActionResult if the menu item is disabled. +
-* Turning on/off the iOS web server preference properly changes the Rendezvous publications. +
-* Changing any web browser settings kills all existing connections. +
-* Added "​disabled"​ option to importMacros AppleScript command. +
-* Default to importing macros disabled unless the Option key is held down. +
-* Adjusted a case where a "for one action"​ palette opens a Conflict Palette. +
-* Adjusted the iTunes Control AppleScripts. +
-* Added "​exit",​ "​break",​ "​loop"​ as search strings to various actions. +
-* Added "​ask",​ "​input",​ "​InputBox"​ as search strings to prompt actions. +
-* Added the Keyboard Maestro version number to the Share text. +
-* Resolved display of executing macros for asynchronously executed macros ​([[https://​forum.keyboardmaestro.com/​t//​7034|forum]])+
-* Improved error message for File Action. +
-* Fixed Fast User Switch action. +
-* Disallow return characters in macro/group names. +
-* Updated Share to Forum category names to match forum changes. +
-* Removed Growl support. +
-* Removed Always Hide Other Applications support. +
- +
-==== Bug Fixes ===== +
- +
-* Fixed behaviour of Close After Action when you Command-V in the Clipboard Switcher. +
-* Fixed Corsair K95 RGB Gaming Keyboard Device Key name display. +
-* Fixed width issue with various scrolling lists+
-* Fixed a possible ​crash with Folder change triggers+
-* Fixed an issue compiling scripts that reference Keyboard Maestro itself. +
-* Fixed an issue cropping images with non-nominal (72) DPIs ([[https://​forum.keyboardmaestro.com/​t/​/​5876|forum]]). +
-* Fixed an issue composing on to images ​with non-nominal (72) DPIs ([[https://​forum.keyboardmaestro.com/​t/​/6860|forum]]). +
-* Fixed an issue if macros hold multiple semaphore locks+
-* Fixed an issue with Set Network Location ​and non-ASCII names. +
-* Fixed a possible issue with columns resizing unexpectedly. +
-* Fixed consistency of arrows for meaning left, right, width, height in actions ​([[https://​forum.keyboardmaestro.com/​t/​/​6130|forum]]). +
-* Fixed unlocalized display ​of Focused Window trigger in non-edit mode. +
-* Fixed issue with number steppers and empty fields ([[https://​forum.keyboardmaestro.com/​t/​/6120|forum]]). +
-* Fixed inconsistent "Exit From Loop" menu name to "Break From Loop"​. +
-* Fixed icon centering in Icon Chooser. +
-* Fixed double clicking ​macro names to select ​the title field. +
-* Fixed some cases where popup menus occluded text fields.+
  
 ==== Download ===== ==== Download =====
Line 443: Line 208:
  
 Alternatively,​ you can [[mailto:​support@stairways.com|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. Alternatively,​ you can [[mailto:​support@stairways.com|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: 2024/05/21 02:31 by peternlewis