User Tools

Site Tools


manual:Whats_New

Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
Next revision Both sides next revision
manual:Whats_New [2018/03/22 00:44]
peternlewis [8.2]
manual:Whats_New [2019/06/12 00:27]
peternlewis v9
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.3 ​or later recommended).+Keyboard~~Maestro~~expands on the powerful base of previous versions, ​adding Dark Mode, multiple ​editor ​windowsand support ​for OCR and JSONtogether with lots of new actions and additions. Keyboard~~Maestro~~requires OS X 10.11.0 El Capitan ​or later.
  
-==== 8.2 ====+==== Major Changes ​====
  
-Added a new [[manual:​Applications_Palette|Applications Palette]] which displays running applications+Support multiple editor windows
-Added [[action:​Apply_Modifiers_to_a_Specific_Application|Apply Modifiers to a Specific Application]] action ​(mimics the behaviour of [[manual:​Applications_Palette|Applications Palette]]). +Support Dark Mode (requires 10.14+). 
-* Added [[trigger:​Dragged_File|Dragged File]] trigger to support ​dragging files to macros in macro palettes+* Added JSON support. 
-* Added a Macro Library entry for an Application Palette group (a set of fixed applications displayed as a palette)+* Added OCR support
-Warn about translocated applications when setting them in the Application popup menus+Added extended Regex support
-Fixed an issue with Prompt With List (and other By Name windows) ([forum](https://​forum.keyboardmaestro.com/​t//​9596/​))+Added support for Stream Deck.  
-Fixed i‗displayWhat != NamedClipboardPopupMenuControllerDisplay::​kUnknown assertion. +Hardened Runtime ​Notarized
-* Fixed i‗displayAttributedString assertion+Requires 10.11+.
-Fixed issue with Set File Attribute field kind mark and token insertion([forum](https://​forum.keyboardmaestro.com/​t/​9695/​3)). +
-* Fixed an issue with AppleScript creation of actions.+
  
-==== 8.1.1 ====+==== Extended Regex support ​====
  
-Fixed Append to File action([forum](https://​forum.keyboardmaestro.com/​t//​9461)) +Support \U, \u, \L, \l and \E in token fields including Search & Replace fields
-Fixed AppleScript for creating dictionaries and dictionary keys. ([forum](https://​forum.keyboardmaestro.com/​t//​9421)+Support named capture groups ​($(name}in Replace fields ​(10.13+).
-* Fixed an issue with Trigger Macro by Name. ([forum](https://​forum.keyboardmaestro.com/​t//​9456))+
  
-==== 8.1 ====+==== Dark Mode ====
  
-Added initial search string to Prompt With List action. ​([forum](https://​forum.keyboardmaestro.com/​t//​7998)) +Support Dark Mode (requires 10.14+)
-* Added title to Prompt With List action. ​([forum](https://​forum.keyboardmaestro.com/​t//​7998)) +* Added Dark Mode preference ​(System, Light or Dark) (requires ​ 10.14+)
-* Added configurable width to Prompt With List action. ​([forum](https://​forum.keyboardmaestro.com/​t//​7998)) +* Added Set/Toggle System Dark Mode actions ​(requires ​ 10.14+)
-* Added automatic width to Prompt With List action. +* Added Set/Toggle Keyboard Maestro Dark Mode actions (requires ​ 10.14+). 
-* Write File trashes any pre-existing target file/directory before writing (rather than overwriting directories!). ([forum](https://​forum.keyboardmaestro.com/​t//​9396)) +* Added [[function:DARKMODE|DARKMODE]] and [[function:​KMDARKMODE|KMDARKMODE]
-* Highlight undisclosed "​(n ​actions)" when search matches within the actions. ​([forum](https://​forum.keyboardmaestro.com/​t//​9197)+ ​functions ​(requires ​ 10.14+).
-* 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 ====+==== JSON ====
  
-* Added support for frames in [[actions:​Browser_Form_Actions|actions:​Browser Form Actions]]+* Added Set JSON Value action
-Support local and instance variables in Calculate and ProcessTokens from [[action:​Custom_HTML_Prompt|Custom HTML Prompt]] actions+Added Set Variables to JSON action. 
-Option-click the Favorites button in [[manual:​Clipboard_History_Switcher|Clipboard History Switcher]] ​to toggle “Favorites Only”+Added Set Dictionary ​to JSON action
-Fixed a problem with Clipboard History not showing after certain copied data+Added %JSONValue%VarName[2+3].field.{%Variable%FieldName%}% token (and Pretty variant)
-Fixed the Switch action not processing text tokens+Added %JSONFromVariables%Prefix% token (and Pretty and Strict variants)
-Improved the unused variable warning for the For Each action+Added %JSONFromDictionary%Dictionary% token (and Pretty variant)
-Fixed MIDI trigger "​increases"​ setting not sticking+Added JSONVALUE(VarName[2+3].field.{%Variable%FieldName%}) function
-Fixed an issue with AppleScript editing a macro that was not visible to the current search filter+Added JSON Keys collection
-Fixed an issue with latest version of Microsoft Word and restoring the clipboard.  +Added context sensitive COUNT() function within JSON array accesses
-Fixed a few typos.+Added filter to JSON Compact and JSON Pretty.
  
 +==== Stream Deck ====
  
-==== 8.0.4 ====+* Added Stream Deck Plug In. 
 +* Added Stream Deck Plug In to USB Device Key trigger. 
 +* Added Stream Deck Set Title action. 
 +* Added Stream Deck Set Image action. 
 +* Added Stream Deck Show OK action. 
 +* Added Stream Deck Show Alert action.
  
-* Added "​increases"​ and "​decreases"​ options to MIDI controller change trigger ([forum](https://​forum.keyboardmaestro.com/​t//​7944)) +==== Editor ​====
-* Support array index for many tokens (eg `%TriggerValue[3]%`). +
-  * `FrontWindow*`,​ `Window*`, `Screen*`. +
-  * `SystemClipboard`,​ `PastClipboard`,​ `NamedClipboard`,​ `TriggerClipboard`. +
-  * `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 ====+* Support multiple editor windows. 
 +* Support for Increased Contrast. 
 +* Support contextual menu in Macros column. 
 +* Support contextual menu in Macro Groups column. 
 +* In the Insert Action/​Token/​Function by Name windows, Option-Double Click, and Option-Return open the wiki help. ([[https://​forum.keyboardmaestro.com/​t/​is-there-any-action-that-can-run-an-url-like-this/​13071/​6)|forum]]) 
 +* Dragging a folder in to a macro group now creates an [[action:​Open_a_File_Folder_or_Application| Open Folder]] macro. 
 +* Dragging a workflow into a macro now creates an [[action:​Execute_an_Automator_Workflow|Execute an Automator Workflow]] action. 
 +* Use VarName as the default variable name in more places. 
 +* Changed “Import Macros Disabled…” menu name to “Import Macros Safe…” to avoid confusion. 
 +* Added a Sort Disabled Macros to Bottom option. 
 +* Select from Recently Executed now focuses on Macros Column/​Macro in non-Edit mode. 
 +* Added macros to Spotlight index (requires 10.13+). ([[https://​forum.keyboardmaestro.com/​t/​how-can-i-include-km-macros-in-my-macos-spotlight-searches/​9805)|forum]]) 
 +* Adjust macro name / trigger column resizing to allow for longer trigger names. 
 +* Better display of invalid calculations in the editor. ([[https://​forum.keyboardmaestro.com/​t/​request-change-behavior-of-km-editor-display-of-invalid-actions/​11237)|forum]]) 
 +* No display of calculation errors in the editor if the issue is only that a Local or Instance variable has no value. ([[https://​forum.keyboardmaestro.com/​t/​request-change-behavior-of-km-editor-display-of-invalid-actions/​11237)|forum]]) 
 +* Large Text setting now affects resizable text views in actions. 
 +* Added hidden preferences to allow setting the font/size of text views in actions, including fixed width script fonts. 
 +* Added Toolbar labels to enhance accessibility. ([[https://​mjtsai.com/​blog/​2019/​05/​22/​mac-toolbar-labels-and-accessibility/​|mjtsai]]) 
 +* Enhanced the Interactive Help with further support for when a macro is triggered but not doing what you want. 
 +* Added detection of Mojave accessibility setting bugs to the Interactive Help system (sigh).
  
-* Prompt For User Input supports Local/​Instance variables ([forum](https://​forum.keyboardmaestro.com/​t//​7946)). +==== Engine ====
-* Custom HTML Prompt supports Local/​Instance variables ([forum](https://​forum.keyboardmaestro.com/​t//​7946)). +
-* 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 ====+* Added Display Layout Changed trigger. 
 +* Added Iconaholic Rotate status menu icon. 
 +* Added default Clipboard Filters group. 
 +* Support sorting the Applications Palette by launch date. (Quinn) 
 +* Preserve DPI of images in image actions. ([[https://​forum.keyboardmaestro.com/​t/​problems-with-km-image-tools-retina-screens/​6860)|forum]]) 
 +* Add “real-time” recording mode. ([[https://​forum.keyboardmaestro.com/​t/​realtime-recording-and-playback-of-keys-and-mouse/​12355)|forum]]) 
 +* Avoid copying as PDF in Microsoft apps (Microsoft apps are still slow on first copy while starting the RTF engine). 
 +* Avoid copying many different image formats on the clipboard, only save TIFF and PNG formats. 
 +* Support “Place Under Mouse” in Clipboard History Switcher. 
 +* Large Text setting now affects Quick Look and Display Text in Window plain text size. 
 +* Support button keys with or without command keys in Prompt For User Input windows with no text fields. ([[https://​forum.keyboardmaestro.com/​t//​9935)|forum]]) 
 +* Added JavaScript in Front Browser script condition. ([[https://​forum.keyboardmaestro.com/​t//​9912)|forum]]) 
 +* Treat clipboard entries with file references to images as images. 
 +* Add Large Text Display period to the [[action:​Set_Action_Delay|Set Action Delay]] action settings. 
 +* Support the AppleScript “windows” property returning all the panel windows in the Engine. ([[https://​forum.keyboardmaestro.com/​t/​clipboard-history-switcher-window-remember-placement-or-move-via-macro-script/​8110)|forum]]) 
 +* Triggering a macro will not necessarily cancel a conflict palette or “for once” palette. ​ This may change in the future.
  
-* Ensure changes are saved after selecting variable/​function/​tokens by name ([forum](https://​forum.keyboardmaestro.com/​t//​8044)). +==== Themes ====
-* Fixed the spelling of "​Systen"​ in Write System Clipboard to File. ([forum](https://​forum.keyboardmaestro.com/​t//​7948/​13)) +
-* Set Clipboard to clipboard filters in the Clipboard Switcher were pasting. ([forum](https://​forum.keyboardmaestro.com/​t//​8072)) +
-* Corrected the Tool Tip of the Action and Trigger warnings. ([forum](https://​forum.keyboardmaestro.com/​t//​8044)) +
-* Avoid a crashing bug when renaming macros. ([forum](https://​forum.keyboardmaestro.com/​t//​8057)) +
-* Forcibly remove any invalid variables from variable database. ([forum](https://​forum.keyboardmaestro.com/​t//​7946/​49)) +
-* Adjusted Play a Specific Tracklist to play more than the first track. ([forum](https://​forum.keyboardmaestro.com/​t//​7960)) +
-* Fixed deactivating macro groups that are configured Always Activated. ([forum](https://​forum.keyboardmaestro.com/​t//​8018)) +
-* Fixed issues with hot key errors. +
-* Adjusted Local and Instance variables to not require the space (eg "​LocalVar"​). +
-* Remove line endings from macro names. +
-* Limit export file names to 200 characters. +
-* Added more search keywords for Get File Action. +
-* 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 ====+* Added Dark Mode palette theme. 
 +* Added Mojave Night palette theme([[https://​forum.keyboardmaestro.com/​t/​custom-palette-style-colors/​3516/​12)|forum]]) 
 +* Added Blue Lagoon palette theme. 
 +* Added Blue Night palette theme. 
 +* Added Purple Dream palette theme. 
 +* Added Orange Light palette theme. 
 +* Added enhanced custom palette theme with gradient options. ([[https://​forum.keyboardmaestro.com/​t/​custom-palette-style-colors/​3516/​6)|forum]]) 
 +* Added an option to center or not center the text in palette themes. ([[https://​forum.keyboardmaestro.com/​t/​custom-palette-style-colors/​3516/​14)|forum]])
  
-* Fixed a bug with non-matching capture groups in search & replace action. +==== Clipboard Switcher ​====
-* Fixed a bug that could cause the engine crash when a palette closed. +
-* Fixed an issue in 10.10 where "​R"​ is removed from macro names! +
-* Fixed a display issue with the Variable condition display. +
-* Fixed the Run Macro menu always being disabled. +
-* Fixed an issue with the Search & Replace action. +
-* Fixed behaviour of "case must match" Typed String triggers. +
-* Fixed Tool Tip of Info button in Clipboard Switcher +
-* Possibly worked around High Sierra Color Picker crash when editor launches. +
-* Removed double-struct L and I for Local and Instance variables.+
  
 +* If multiple items are selected in the Clipboard Switcher, Command-C merges them into the system clipboard.
 +* If multiple items are selected in the Clipboard Switcher, Command-V merges and then pastes them.
 +* If multiple images are selected, merging them creates a single larger image (horizontally or vertically, depending on the separator).
 +* Added a contextual menu to select the Multiple Clipboard Separator.
 +* If a single item is selected in the Clipboard History Switcher, command-C sets the system clipboard to it.
  
-===== 8.0 =====+==== Actions ​====
  
-==== Editor Improvements ====+* Added OCR (Optical Character Recognition) action for screen and images. 
 +* Added OCR condition for screen and images. 
 +* Added Set Desktop Image action. 
 +* Add Cancel a Specific Macro action. 
 +* Added Append/​Prepend to Variable actions. 
 +* Added Set Clipboard to Image action. 
 +* Added Set Clipboard to File Reference action. 
 +* Added Append Text to Variable option for various outputs (eg Execute Script output). 
 +* Added Show/​Hide/​Toggle Applications Palette action. 
 +* Updated Open 1Password action to work with 1Password 7.3+. 
 +* Added URL selction to Open 1Password action (requires 1Password 7.3+). 
 +* Added Display Name option to Filter and Get File Attribute. 
 +* Added modifiers to Simulate the Hardware Key action. 
 +* Added Small Increase/​Decrease System Sound Volume actions. 
 +* Added Small Increase/​Decrease System Brightness actions. 
 +* Add clipboard and file options to Find Image action. 
 +* Add clipboard and file options to Click at Found Image action. 
 +* Add clipboard and file options to Found Images collection and condition. 
 +* Added bottom to top and right to left options for Found Images collection. 
 +* Added image selection (eg “rightmost”) options to Find Image action. 
 +* Added non-unique image selection (eg “rightmost”) options to Click at Found Image action. 
 +* Added %ApplicationPath%1% token. 
 +* Added “All”, “Foreground”,​ “Background” options to Application tokens. 
 +* Added “All” option to Window and Screen tokens. 
 +* Added %ExecutingInstance% token representing the current execution instance. 
 +* Added %ExecutingInstances% listing the current execution instances. 
 +* Added %ExecutingInstanceName%instance% giving the name of a specific instance. 
 +* Added %FrontBrowser%,​ %FrontBrowserBundleID% and %FrontBrowserPath% tokens. 
 +* Added HEX, OCT, and BIN functions.  
 +* Added DIV operator. 
 +* Support two-parameter variants of RANDOM and RAND functions. ([[https://​forum.keyboardmaestro.com/​t/​random-negative-numbers/​12561)|forum]]) 
 +* Support SCREENVISIBLE(VarName,​…) when VarName is “Back”, etc ([[https://​forum.keyboardmaestro.com/​t/​variables-in-move-and-resize-front-window/​1560)|forum]]) 
 +* Support “Index” as a coordinate to the SCREEN and SCREENVISIBLE function. 
 +* Support Smart Groups in Trigger Macro By Name action. 
 +* Support Smart Groups in Show Palette of Macros action. 
 +* Added an option to select the units for the Pause action. 
 +* Added screen selection menu options for second, third, external, internal, etc in various actions. 
 +* Added an option to not sort entires in the Prompt With List action. ([[https://​forum.keyboardmaestro.com/​t/​feature-request-sorting-options-in-prompt-with-list-action/​8579)|forum]]) 
 +* Added an option to set the title of the Prompt For File action. ([[https://​forum.keyboardmaestro.com/​t/​feature-request-add-titles-to-all-km8-prompts/​8423)|forum]]) 
 +* Added an option to set the initial directory of the Prompt For File action. ([[https://​forum.keyboardmaestro.com/​t/​default-folder-location-for-prompt-for-file-action/​8782)|forum]]) 
 +* Added a parameter option to the Get a URL action. 
 +* Added a parameter option to the Remote Trigger action. 
 +* Added an option to the Open URL action to open the URL in the background. 
 +* Support token processing options in the various web browser actions. 
 +* Tokens that start with %Local or %Instance but that do not match an existing local/​instance variable are assume to be empty variables. ([[https://​forum.keyboardmaestro.com/​t/​using-local-variable-token-without-the-variable-prefix/​10893/​7)|forum]])
  
-* Added new [[manual:​Assistance|Assistance]] system to help novices trouble shoot any early issues. +==== Speed ====
-* Large Text size support in editor lists (Macros, Groups, Library, etc). +
-* Added Machine Learning system to By Name selectors. +
-* Support dragging macros and macro groups into the macro action list. +
- * No modifiers: Execute the Macro / Show the Macro Group +
- * Option: insert a copy of the macro’s actions +
- * Command-Shift:​ Enable the Macro / Macro Group +
- * Option-Shift:​ Mark the Macro +
-* Added dragging of macros/​macro groups to action macro selector popup menus. +
-* Support dragging files in as macros or actions. +
- * Applications as Activate Application action. +
- * Scripts as the appropriate Execute Script action. +
- * Other files as Open File actions. +
-* Added basic Touch Bar support. +
-* Added Actions menu. +
-* Added Run Macro menu and toolbar item to run the currently selected macro. +
-* Added Engroup Actions (into a new Group, Macro, For Each, While, etc) ([[https://​forum.keyboardmaestro.com/​t//​3538|forum]]). +
-* Added Degroup Actions. +
-* Added Paste Replacing for actions ([[https://​forum.keyboardmaestro.com/​t//​4904|forum]]). +
-* Added Select Macro by Name. +
-* Added Insert Function by Name. +
-* Added Insert Token by Name. +
-* Added Insert Variable by Name. +
-* Added File ➤ Share menu. +
-* Added Import Macros Disabled menu command. +
-* Adjusted Import Macros menu command to require the Option key. +
-* Added Edit ➤ Insert Token ➤ Named Clipboard hierarchical menu. +
-* Added %Delete% to the Insert Token menu. +
-* Show an indiciator of the kind (token, variable, calculation) of each field in the editor. +
-* Support negation (-) in the search fields ([[https://​forum.keyboardmaestro.com/​t//​4343|forum]]). +
-* Default to last used variable when creating new actions. +
-* Support changing Safari actions to/from Google Chrome actions. +
-* Support styled text in comments. +
-* Added an option to hide disabled macro groups. +
-* Added wiki search to Help menu.  +
-* Added Make Alias for macros (and command-option dragging macros to groups). +
-* Play Sound supports sounds in ~/​Library/​Sounds and ~/Sounds. +
-* Click on macro group label (top right) to select the enclosing macro group. +
-* Adjusted the disclosure behaviour of Execute Macro action. +
-* Added Space, Escape, and Help to the Hot Key selection menu. +
-* Added a 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 ====+* Improved launch speed, especially with multiple editor windows. 
 +* Improved speed displaying ​the All Macros group with large numbers of macros. 
 +* Improved Clipboard History display speed and memory usage with lots of large images. 
 +* Improved Clipboard History save/load speed with lots of large images. 
 +* Improved Named Clipboard save/load speed with lots of large images.
  
-* Macro Groups, Smart Groups, Macros, Triggers, Actions are all [[/​Scripting_the_Keyboard_Maestro_editor|AppleScirpt OSA objects]]. ​ Examples: +==== Minor ====
- * 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 ====+* Added “web” and “website” as a search synonym for Open URL and Get URL actions. 
 +* Added “load” and “save” as search synonyms for Read File and Write File actions. 
 +* Added “create” and “directory” as search synonyms for New Folder action. 
 +* Added “annotate” as search synonyms for Composite onto Image action. 
 +* Added “dialog” and “window” as search synonyms for Alert and Prompt for User Input actions. 
 +* Added “Insert Styled Text by Pasting” to action insertion lists. 
 +* Added hidden preference settings to configure the fonts in scripts, HTML, JSON and Comment actions. 
 +* Added options to match applications based on just Bundle ID (rather than Path & Bundle ID). 
 +* Expanded hex character tokens to include emoji (eg %01F300%). 
 +* Adjusted Filter Percent Encode for URL to encode all non-alphanumeric characters. 
 +* Adjusted Search the Web action to token expand the Title field. ([[https://​forum.keyboardmaestro.com/​t/​search-the-web-action-macro-name-as-background-text/​13272)|forum]]) 
 +* Default shell environment to UTF-8 if not explicitly set. 
 +* Changed Application Trigger to set TriggerValue to the path of the application. (may break macros) 
 +* Include Smart Groups in macro selector popup menu. 
 +* Trigger Macro by Name initial search now processes tokens. 
 +* Adjusted Comment action to enable automatic link detection.  
 +* Adjusted Insert Styled text and Display Styled Text action to enable automatic link detection. 
 +* Adjusted the palette displays slightly, de-bolded the content text and added some space. ([[https://​forum.keyboardmaestro.com/​t/​ui-palette-suggestion/​13942)|forum]]) 
 +* Disabled Smart Copy/Paste in most text fields. ([[https://​forum.keyboardmaestro.com/​t/​wish-list-or-alternative-solution-insert-url-in-comment-action/​13281)|forum]]) 
 +* Attempt to better support control over Smart Quote/​Dash/​Link Substitution/​Detection. 
 +* Detect AppleScript errors and abort/fail the Execute AppleScript action. (may break macros) 
 +* Detect Shell script errors and abort/fail the Execute Shell Script action. (may break macros) 
 +* Detect Plug In script errors and abort/fail the Plug In action. (may break macros)([[https://​forum.keyboardmaestro.com/​t/​how-do-i-abort-macro-if-plugin-script-gets-error/​10558)|forum]]) 
 +* Avoid New Folder action failing in the case where the folder already exists. 
 +* Improve error display of text script errors (remove long extraneous temporary path). 
 +* Hidden Windows show slightly dimmed text in the Window ​Switcher
 +* Handle kmtrigger: URLs with bogus slash (/) at the end added by Word. 
 +* Worked around Google Chrome’s stupid window title accessibility issue. ([[https://​forum.keyboardmaestro.com/​t/​found-images-suddenly-broken-in-google-chrome/​11510)|forum]]) 
 +* Worked around Safari 12.1 not disabling the Stop menu when the page is finished loading (radar://​49309868). 
 +* Worked around an issue with dates and times not being localized in Mojave. (CFBundleAllowMixedLocalizations) 
 +* Support Brave and Vivaldi browsers as a Chrome-compatible Front Browser. ([[https://​forum.keyboardmaestro.com/​t/​using-a-non-safari-non-chrome-browser/​13712)|forum]]) 
 +* Rate-limit ​Named Clipboard ​Change notifications. 
 +* Rate-limit Allow JavaScript from Apple Events notifications. 
 +* Improved Search Using Regular Expressions to indicate invalid variables in red. ([[https://​forum.keyboardmaestro.com/​t/​bug-variables-illegal-characters-without-warning-via-search-using-regex-action/​11003)|forum]]) 
 +* Invalid variables that are entered in various fields and show up red will not be saved. 
 +* Improve error display of numeric errors. ([[https://​forum.keyboardmaestro.com/​t/​is-there-any-name-of-action-to-repeat-some-macro-till-last-tab-of-the-window/​13798/​4)|forum]]) 
 +* Added primary trigger to Macro Inspector / Trigger Macro by Name windows.  
 +* Adjusted the Continue/​Retry Loop action icon to a Control Flow icon instead of a Stop icon. 
 +* Adjusted the Share to Forum default name to be less verbose. ([[https://​forum.keyboardmaestro.com/​t/​change-request-macro-upload-name/​7951)|forum]]) 
 +* Detect Universal Clipboards and display a network icon as the source. 
 +* Removed support for signatures in Send Mail Message as Mail.app’s signature support is broken.  
 +* Detect more Audio Output Device changes. ([[https://​forum.keyboardmaestro.com/​t/​macro-not-triggering-on-audio-output-change/​12651)|forum]])
  
-* New combined appearance. +==== Fixes ====
-* 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 ==== +Fixed Revert ​to interact properly ​with Undo/Redo. ([[https://​forum.keyboardmaestro.com/​t/​how-to-discard-undo-the-revert-macros-action/13240)|forum]]) 
- +Fixed the title of the Set Action Delay action. ([[https://​forum.keyboardmaestro.com/​t/​set-action-delay-title-doesnt-update-correctly/13344)|forum]]) 
-Added [[trigger:​MIDI|MIDI Control Change]] trigger. +Fixed a crash if the engine is launched via a .kmtrigger file
-* Added [[trigger:​MIDI|MIDI raw packet]] trigger (SysEx, HUI protocol, etc). +Fixed the non-edit display of the Macro condition
-* Support MIDI trigger recording when the text fields are focused in background. +Fixed the non-edit display of the Modifiers condition
-* Added [[actions:​Send_MIDI|Send MIDI]] raw packets so you can send any kind of MIDI packet. +Fixed the non-edit display of the Text condition
-* Send MIDI action uses calculations so you can send varying notes and control changes. +Fixed performance issue with Word Count filter. ([[https://​forum.keyboardmaestro.com/​t/​filtering-large-amounts-of-text-in-the-clipboard/13575)|forum]]) 
-* Handle and split multiple MIDI packets received in a single system MIDI packet. +Fixed an issue where the “ends with” condition fails if the end string is also in the middle of the string. ​([[https://​forum.keyboardmaestro.com/​t/​switch-ends-with-bug/13619)|forum]]) 
- +Fixed an issue where macro groups that were inactive ​and then had their configuration changed would not necessarily activate.  
-==== Added Local and Instance Variables ==== +Fixed an issue with Prompt With List action ​not showing as much as possible of long entries
- +Fixed an issue with gestures of single diagonal direction being allowed.  
-* Added the concept of [[manual:​Variables| Local Variables]],​ local to the macro they are in. +Fixed an issue with the character selection menu highlighting in the Icon Chooser Character display
-* Added the concept of [[manual:​Variables| Instance Variables]],​ local to macro execution group they are in. +Fixed an issue with highlighting display ​of truncated names in Window Switcher
- +Fixed an issue when running ​macro from the editor immediately after making a change
-==== Added Dictionaries ==== +Fixed an issue where Conflict Palettes could not use the key they were triggered with. ([[https://​forum.keyboardmaestro.com/​t/​how-to-double-tap-a-non-alphanumeric-conflict-palette-trigger/8089)|forum]]) 
- +Fixed Command-V ​in the search field in the Clipboard Switcher
-* Added the concept of [[Dictionaries|dictionaries]],​ mapping (case insensitively) a dictionary name and key name to a value. +Fixed crash in ThemedPaletteMatrixCell when the entry is tracking the mouse but the palette ​changes
-* Added Set Dictionary Value action. +Fixed an issue with the Prompt ​for File action not honouring ​the file types. ([[https://​forum.keyboardmaestro.com/​t/​prompt-for-file-allowed-types-not-working/13807)|forum]]) 
-* Added %Dictionary[Dict,​Key]% text token. +Fixed an issue where the editor ​window ​would hide if you selected Help from a Insert By Name window. ​([[https://​forum.keyboardmaestro.com/​t/​is-there-any-action-that-can-run-an-url-like-this/13071/6)|forum]]) 
-* Added collection of Dictionaries and Keys in a Dictionary. +Fixed Icon Chooser sorting applications case sensitively
-* Added full AppleScript support for accessing Dictionaries. +Fixed an issue with Enable/Disable macros resulting ​in a delay in operation of Typed String trigger. ([[https://​forum.keyboardmaestro.com/​t/​delay-after-enabling-macro/14060)|forum]]) 
- +* Fixed Break From Loop, Retry Loop, Continue Loop considering a Group to be loop. ([[https://​forum.keyboardmaestro.com/​t/​bug-group-treated-as-loop/11632)|forum]]) 
-==== New Triggers ==== +* Fixed an issue with Emoji character transparency in palettes. ​([[https://​forum.keyboardmaestro.com/​t/​transparency-issue-with-palettes-and-emoji/13971)|forum]]) 
- +* Fixed Get Touch Bar to properly handle Code__Title options. ([[https://​forum.keyboardmaestro.com/​t/​touch-bar-prompt-values/13566)|forum]])
-* 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 ​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 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 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 a 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 a 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 other) tokens. +
-* 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 a 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 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 =====
manual/Whats_New.txt · Last modified: 2023/12/05 01:59 by peternlewis