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/06/13 23:05]
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.1 ====+==== Major Changes ​====
  
-Added created:1w, modified:​1d,​ used:1h filters(see [[manual:​Search_Strings|Search Strings]]) +Support multiple editor windows
-Added an option to omit the title bar from palette themes. ​(see [[manual:​Palettes#​Controlling_The_Display_of_Palettes|Palettes]]+Support Dark Mode (requires 10.14+). 
-* Added USB Device Keys to the gethotkeys AppleScript results+* Added JSON support
-* Added a few more locations to look for 1Password bookmarks+* Added OCR support
-Fixed a bug with USB Device Key triggers when changing pressed/​release mode([forum](https://​forum.keyboardmaestro.com/​t//​9848)) +Added extended Regex support
-Fixed a bug with typing text into the columns field of the theme editor+Added support for Stream Deck.  
-Fixed password variable names (not values!) showing up in the Variables preferences([forum](https://​forum.keyboardmaestro.com/​t//​2669/​6)) +Hardened Runtime ​Notarized
-Fixed some sanitiser issues. +Requires 10.11+.
-* 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 ====+==== Extended Regex support ​====
  
-Added a new [[manual:​Applications_Palette|Applications Palette]] which displays running applications. +Support \U, \u, \L, \l and \E in token fields including Search & Replace 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]]). +Support named capture groups ​($(name}) in Replace fields ​(10.13+).
-* Added [[trigger:​Dragged_File|Dragged File]] trigger to support dragging files to macros ​in macro palettes+
-Added a Macro Library entry for an Application Palette group (a set of fixed applications displayed as a palette)+
-* Warn about translocated applications when setting them in the Application popup menus. +
-* Fixed an issue with Prompt With List (and other By Name windows) ([forum](https://​forum.keyboardmaestro.com/​t//​9596/​)). +
-* Fixed i‗displayWhat != NamedClipboardPopupMenuControllerDisplay::​kUnknown assertion. +
-* Fixed i‗displayAttributedString assertion. +
-* 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.+
  
 +==== Dark Mode ====
  
-==== 8.1.1 ====+* Support Dark Mode (requires 10.14+). 
 +* Added Dark Mode preference (System, Light or Dark) (requires ​ 10.14+). 
 +* Added Set/Toggle System Dark Mode actions (requires ​ 10.14+). 
 +* Added Set/Toggle Keyboard Maestro Dark Mode actions (requires ​ 10.14+). 
 +* Added [[function:​DARKMODE|DARKMODE]] and [[function:​KMDARKMODE|KMDARKMODE]] 
 + ​functions (requires ​ 10.14+).
  
-* Fixed Append to File action. ([forum](https://​forum.keyboardmaestro.com/​t//​9461)) +==== JSON ====
-* 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 Set JSON Value action. 
 +* Added Set Variables to JSON action. 
 +* Added Set Dictionary to JSON action. 
 +* Added %JSONValue%VarName[2+3].field.{%Variable%FieldName%}% token (and Pretty variant). 
 +* Added %JSONFromVariables%Prefix% token (and Pretty and Strict variants). 
 +* Added %JSONFromDictionary%Dictionary% token (and Pretty variant). 
 +* Added JSONVALUE(VarName[2+3].field.{%Variable%FieldName%}) function. 
 +* Added JSON Keys collection. 
 +* Added context sensitive COUNT() function within JSON array accesses. 
 +* Added filter to JSON Compact and JSON Pretty.
  
-* Added initial search string to Prompt With List action. ([forum](https://​forum.keyboardmaestro.com/​t//​7998)) +==== Stream Deck ====
-* 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 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 support for frames in [[actions:​Browser_Form_Actions|actions:​Browser Form Actions]]. +==== Editor ====
-* 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.+
  
 +* 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).
  
-==== 8.0.4 ====+==== Engine ​====
  
-* Added "​increases"​ and "​decreases"​ options to MIDI controller change ​trigger ([forum](https://​forum.keyboardmaestro.com/​t//​7944)) +* Added Display Layout Changed ​trigger
-Support array index for many tokens ​(eg `%TriggerValue[3]%`). +* Added Iconaholic Rotate status menu icon. 
-  * `FrontWindow*`,​ `Window*`, `Screen*`+* Added default Clipboard Filters group. 
-  `SystemClipboard`,​ `PastClipboard``NamedClipboard`,​ `TriggerClipboard`+* Support sorting the Applications Palette by launch date. (Quinn) 
-  `TriggerValue`,​ `CurrentMouse`,​ `FoundImage`+* Preserve DPI of images in image actions. ​([[https://​forum.keyboardmaestro.com/​t/​problems-with-km-image-tools-retina-screens/6860)|forum]]
-Added Search & Replace ​and Count/Find facility to Keyboard Maestro Engine AppleScript dictionary+Add “real-time” recording mode. ([[https://​forum.keyboardmaestro.com/​t/​realtime-recording-and-playback-of-keys-and-mouse/​12355)|forum]]) 
-Added Report Updates Only When Editor Activates to General Preferences. +Avoid copying as PDF in Microsoft apps (Microsoft apps are still slow on first copy while starting the RTF engine)
-* Added more clipboard flavor exclusions for Microsoft Word to yet again avoid the bookmark link issue. +Avoid copying many different image formats on the clipboardonly save TIFF and PNG formats
-* Remember Clipboard Switcher Info button setting+Support “Place Under Mouse” in Clipboard History Switcher
-Worked around Chrome not liking certain characters in JavaScript ​strings ​([forum](https://​forum.keyboardmaestro.com/​t//​8195)). +Large Text setting now affects Quick Look and Display Text in Window plain text size
-Detect case where either ​the Engine or editor is translocated (previously only detected case where both were)+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]]) 
-Fixed an issue where you could not edit some fields ​in disabled actions ​([forum](https://​forum.keyboardmaestro.com/​t//​8185)). +Added JavaScript ​in Front Browser script condition. ​([[https://​forum.keyboardmaestro.com/​t//​9912)|forum]]) 
-Fixed Dictionary Key condition field not saving when you typed in to it +* Treat clipboard entries with file references to images as images
-* Fixed Command-K toggling ​the Action Selector.+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.
  
-==== 8.0.3 ====+==== Themes ​====
  
-Prompt For User Input supports Local/​Instance variables ​([forum](https://​forum.keyboardmaestro.com/​t//​7946)). +Added Dark Mode palette theme. 
-Custom HTML Prompt supports Local/​Instance variables ​([forum](https://​forum.keyboardmaestro.com/​t//​7946)). +* Added Mojave Night palette theme. ​([[https://​forum.keyboardmaestro.com/​t/​custom-palette-style-colors/3516/12)|forum]]) 
-Local/​Instance varibles passed as environment variables ​to scripts ​([forum](https://​forum.keyboardmaestro.com/​t//​7946)). +* Added Blue Lagoon palette theme. 
-* Allow reading and writing Local/Instance variables from AppleScripts (via [[/​AppleScript#​Examples|KMINSTANCE environment variable]])+* Added Blue Night palette theme
-* Added [[action:​Custom_HTML_Prompt#​Using_JavaScript|KMWillCloseWindow()]] call when window will close in Custom HTML Prompt. +Added Purple Dream palette theme. 
-* Added [[action:​Custom_HTML_Prompt#​Using_JavaScript|GetDictionary(and SetDictionary()]] in Custom HTML Prompt. +* Added Orange Light palette theme. 
-* Corrected the spelling of "​matches"​ in the Cron entry in the trigger menu. +* Added enhanced custom palette theme with gradient options. ​([[https://​forum.keyboardmaestro.com/​t/​custom-palette-style-colors/3516/6)|forum]]
-* Allow [[action:​Split_Path|Split Path]] action to split just file names (parent path will be "/​Nowhere"​). +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]])
-* 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 ====+==== Clipboard Switcher ​====
  
-Ensure changes ​are saved after selecting variable/​function/​tokens by name ([forum](https://​forum.keyboardmaestro.com/​t//​8044)). +If multiple items are selected in the Clipboard ​Switcher, Command-C merges them into the system clipboard
-* Fixed the spelling of "​Systen"​ in Write System ​Clipboard ​to File([forum](https://​forum.keyboardmaestro.com/​t//​7948/​13)) +If multiple items are selected ​in the Clipboard Switcher, Command-V merges ​and then pastes them
-Set Clipboard to clipboard filters ​in the Clipboard Switcher ​were pasting. ([forum](https://​forum.keyboardmaestro.com/​t//​8072)) +If multiple images are selected, merging them creates ​single larger image (horizontally or vertically, depending on the separator). 
-* Corrected the Tool Tip of the Action ​and Trigger warnings([forum](https://​forum.keyboardmaestro.com/​t//​8044)) +Added contextual menu to select ​the Multiple Clipboard Separator
-Avoid crashing bug when renaming macros. ​([forum](https://​forum.keyboardmaestro.com/​t//​8057)+If a single item is selected in the Clipboard History Switcher, command-C sets the system clipboard ​to it.
-* Forcibly remove any invalid variables from variable database([forum](https://​forum.keyboardmaestro.com/​t//​7946/​49)) +
-Adjusted Play 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 ====+==== Actions ​====
  
-Fixed bug with non-matching capture groups in search & replace ​action. +Added OCR (Optical Character Recognition) action for screen and images. 
-Fixed a bug that could cause the engine crash when palette closed+* Added OCR condition for screen and images. 
-Fixed an issue in 10.10 where "​R" ​is removed from macro names! +* Added Set Desktop Image action. 
-Fixed display issue with the Variable condition display+* Add Cancel ​Specific Macro action. 
-Fixed the Run Macro menu always being disabled+* Added Append/​Prepend to Variable actions. 
-Fixed an issue with the Search & Replace ​action. +* Added Set Clipboard to Image action. 
-Fixed behaviour ​of "case must match" Typed String triggers+* Added Set Clipboard to File Reference action. 
-Fixed Tool Tip of Info button ​in Clipboard Switcher +* Added Append Text to Variable option for various outputs (eg Execute Script output). 
-Possibly worked around High Sierra Color Picker crash when editor launches+* Added Show/​Hide/​Toggle Applications Palette action. 
-Removed double-struct L and I for Local and Instance variables.+* 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 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 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]])
  
 +==== Speed ====
  
-===== 8.0 =====+* 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.
  
-==== Editor Improvements ​====+==== Minor ====
  
-* Added new [[manual:​Assistance|Assistance]] system to help novices trouble shoot any early issues. +* Added “web” ​and “website” as search synonym for Open URL and Get URL actions. 
-* Large Text size support in editor lists (Macros, Groups, Library, etc). +* Added “load” and “save” ​as search synonyms for Read File and Write File actions. 
-* Added Machine Learning system to By Name selectors. +Added “create” and “directory” ​as search synonyms for New Folder ​action. 
-* Support dragging macros ​and macro groups into the macro action list. +Added “annotate” ​as search synonyms for Composite onto Image action. 
- * No modifiers: Execute the Macro / Show the Macro Group +Added “dialog” and “window” ​as search synonyms for Alert and Prompt for User Input actions. 
- * Option: insert ​copy of the macro’s ​actions +* Added “Insert Styled Text by Pasting” to action insertion lists
- * Command-Shift:​ Enable the Macro / Macro Group +* Added hidden preference settings to configure the fonts in scripts, HTML, JSON and Comment actions
- * Option-Shift:​ Mark the Macro +* Added options ​to match applications based on just Bundle ID (rather than Path & Bundle ID)
-* Added dragging of macros/​macro groups to action macro selector popup menus. +Expanded hex character tokens to include emoji (eg %01F300%). 
-* Support dragging files in as macros or actions. +Adjusted Filter Percent Encode for URL to encode all non-alphanumeric characters
-Applications ​as Activate Application ​action. +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]]) 
-Scripts ​as the appropriate Execute Script ​action. +Default shell environment to UTF-8 if not explicitly set
-Other files as Open File actions. +Changed Application Trigger to set TriggerValue to the path of the application(may break macros) 
-* Added basic Touch Bar support+Include Smart Groups in macro selector popup menu
-* Added Actions menu+Trigger Macro by Name initial search now processes tokens
-* Added Run Macro menu and toolbar item to run the currently selected macro+* Adjusted ​Comment action ​to enable automatic link detection.  
-Added Engroup Actions ​(into a new Group, Macro, For Each, While, etc) ([[https://​forum.keyboardmaestro.com/​t//​3538|forum]]). +Adjusted ​Insert ​Styled text and Display Styled Text action ​to enable automatic link detection
-Added Degroup Actions+Adjusted ​the palette displays slightlyde-bolded ​the content text and added some space. ([[https://​forum.keyboardmaestro.com/​t/​ui-palette-suggestion/13942)|forum]]) 
-Added Paste Replacing for actions ​([[https://​forum.keyboardmaestro.com/​t//​4904|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]]
-Added Select Macro by Name+Attempt to better support control over Smart Quote/Dash/Link Substitution/Detection
-Added Insert Function by Name+Detect AppleScript errors and abort/fail the Execute AppleScript action. ​(may break macros
-Added Insert Token by Name+Detect Shell script errors and abort/​fail ​the Execute ​Shell Script ​action. ​(may break macros) 
-Added Insert Variable ​by Name+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]]) 
-* Added File ➤ Share menu. +Avoid New Folder action failing in the case where the folder already exists
-* Added Import Macros Disabled menu command+Improve error display of text script errors (remove long extraneous temporary path)
-* Adjusted ​Import Macros menu command ​to require the Option key+Hidden Windows show slightly dimmed text in the Window Switcher
-Added Edit ➤ Insert ​Token ➤ Named Clipboard hierarchical menu. +Handle kmtrigger: URLs with bogus slash (/) at the end added by Word
-* Added %Delete% ​to the Insert Token menu+Worked around Google Chrome’s stupid window title accessibility issue. ​([[https://​forum.keyboardmaestro.com/​t/​found-images-suddenly-broken-in-google-chrome/11510)|forum]]) 
-Show an indiciator of the kind (tokenvariable, calculation) of each field in the editor. +Worked around Safari 12.1 not disabling ​the Stop menu when the page is finished loading (radar://​49309868)
-* Support negation (-) in the search fields ​([[https://​forum.keyboardmaestro.com/​t//​4343|forum]]). +Worked around ​an issue with dates and times not being localized in Mojave(CFBundleAllowMixedLocalizations) 
-Default to last used variable when creating new actions. +Support Brave and Vivaldi browsers as Chrome-compatible Front Browser. ([[https://​forum.keyboardmaestro.com/​t/​using-a-non-safari-non-chrome-browser/13712)|forum]]) 
-* Support changing Safari actions to/from Google Chrome actions. +* Rate-limit Named Clipboard Change notifications
-* Support styled ​text in comments. +Rate-limit Allow JavaScript from Apple Events notifications
-* Added an option to hide disabled macro groups. +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]]) 
-* Added wiki search to Help menu +* Invalid variables that are entered in various fields and show up red will not be saved
-* Added Make Alias for macros (and command-option dragging macros to groups). +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]]) 
-Play Sound supports sounds in ~/Library/Sounds and ~/Sounds+Added primary trigger to Macro Inspector / Trigger Macro by Name windows.  
-Click on macro group label (top rightto select the enclosing macro group. +Adjusted the Continue/​Retry Loop action icon to Control Flow icon instead of a Stop icon
-Adjusted ​the disclosure behaviour of Execute ​Macro action. +Adjusted the Share to Forum default name to be less verbose. ​([[https://​forum.keyboardmaestro.com/​t/​change-request-macro-upload-name/7951)|forum]]) 
-Added Space, Escape, ​and Help to the Hot Key selection menu. +Detect Universal Clipboards and display a network icon as the source
-* Added a disabled color to the action ​color menu to indicate the color means a matched search. +* Removed ​support for signatures in Send Mail Message as Mail.app’s signature support is broken.  
-* Added Copy as XML to copy macro groups, ​macros ​or actions as XML ([[https://​forum.keyboardmaestro.com/​t//​3842|forum]]). +Detect more Audio Output Device changes. ​([[https://​forum.keyboardmaestro.com/​t/​macro-not-triggering-on-audio-output-change/12651)|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 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 ​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 ​====+==== Fixes ====
  
-Macro Groups, Smart Groups, Macros, Triggers, Actions are all [[/​Scripting_the_Keyboard_Maestro_editor|AppleScirpt OSA objects]]. ​ Examples: +Fixed Revert ​to interact properly ​with Undo/Redo. ([[https://​forum.keyboardmaestro.com/​t/​how-to-discard-undo-the-revert-macros-action/13240)|forum]]) 
- * properties of smart group "​Enabled"​ +Fixed the title of the Set Action Delay action. ([[https://​forum.keyboardmaestro.com/​t/​set-action-delay-title-doesnt-update-correctly/13344)|forum]]) 
- * make new smart group with properties {name:"​Enabled",​ search strings:​{"​enabled:​yes"​}} +Fixed a crash if the engine is launched via a .kmtrigger file
- * set search strings of smart group "​Test2" ​to {"​ABC",​ "​DEF"​} +Fixed the non-edit display of the Macro condition
- * set name of macro 1 to "​Great!"​ +Fixed the non-edit display of the Modifiers condition
- * tell macro group "New Stuff" to make new macro +Fixed the non-edit display of the Text condition
- * select action 1 through 3 of action 2 of macro "​Working"​ +Fixed performance issue with Word Count filter. ([[https://​forum.keyboardmaestro.com/​t/​filtering-large-amounts-of-text-in-the-clipboard/13575)|forum]]) 
- * set enable of macro group "Turn Off" to false +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]]) 
- * set color of action 1 of macro "​Bright"​ to "​red"​ +Fixed an issue where macro groups that were inactive ​and then had their configuration changed would not necessarily activate.  
- * set selection to global macro group +Fixed an issue with Prompt With List action ​not showing as much as possible of long entries
- * move first action of macro "​Source Macro" to end of actions of macro "Dest Macro"​ +Fixed an issue with gestures of single diagonal direction being allowed.  
- * delete second action of macro "​Target Macro"​ +Fixed an issue with the character selection menu highlighting in the Icon Chooser Character display
- * duplicate every macro group whose name starts ​with "​Test"​ +Fixed an issue with highlighting display ​of truncated names in Window Switcher
- * set m to duplicate action 1 of macro "​Macro33"​ to after action 2 of macro "​Macro32"​ +Fixed an issue when running ​macro from the editor immediately after making a change
- * duplicate (selected macros) to macro group "​Test4"​ +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
-==== Revamp Clipboard History Switcher & Named Clipboard Switcher ==== +Fixed crash in ThemedPaletteMatrixCell when the entry is tracking the mouse but the palette ​changes
- +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]]) 
-* New combined appearance. +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]]) 
-* Additional information (source, type, size, pixel size, time, index). +Fixed Icon Chooser sorting applications case sensitively
-* Drag Reordering. +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]]) 
-* Drag from the switcher to image or text fields. +* 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]]) 
-* Contextual menu to Paste, Paste Plain, or Paste Image, Duplicate. +* Fixed an issue with Emoji character transparency in palettes. ​([[https://​forum.keyboardmaestro.com/​t/​transparency-issue-with-palettes-and-emoji/13971)|forum]]) 
-* Contextual menu to just set the current clipboard without pasting. +* Fixed Get Touch Bar to properly handle Code__Title options. ([[https://​forum.keyboardmaestro.com/​t/​touch-bar-prompt-values/13566)|forum]])
-* 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 ​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