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
manual:Whats_New [2021/10/18 04:57]
peternlewis [Minor]
manual:Whats_New [2023/12/05 01:59] (current)
peternlewis [Changed in 11.0.1]
Line 1: Line 1:
 ====== What’s New? ====== ====== What’s New? ======
  
-Keyboard~~Maestro~~10 expands on the powerful base of previous versions, improving the editor, adding many new actions and triggers, ​Paste by Namestatus menu displaysubroutines, and more. Keyboard~~Maestro~~10 requires macOS 10.13 High Sierra or later.+Keyboard~~Maestro~~11 expands on the powerful base of previous versions, improving the editor, adding many new actions and triggers, ​New Macro Wizarda new Security preference pane, a keyboardmaestro command line toolsupport for Apple Text Recognition, and more. Keyboard~~Maestro~~11 requires macOS 10.13 High Sierra or later.
  
-This version ​is dedicated ​to Jim Underwood ​([[https://​forum.keyboardmaestro.com/​u/jmichaeltx|JMichaelTX]]), who sadly passed away this year, with thanks for his outstanding assistance ​and generosity on the forum, ​spending thousands ​of hours helping folks get more out of Keyboard MaestroHe will be sorely missed.+==== Changed in 11.0.2 ==== 
 + 
 +* Resolved an issue [[action:​Display_Text|Display Large Text]] action stealing focus in Sonoma. 
 +* Worked around an issue when setting window position and size when the system ​is animating the changes and gets confused. 
 +* Fixed the [[action:​Alert|Alert]] action ​to honor the [[action:​Set_Next_Engine_Window_Position|Set Next Engine Window Position]] action. ​([forum](https://​forum.keyboardmaestro.com/​t/​possible-bug-the-alert-window-does-not-respond-to-the-set-next-engine-window-action/​33870)) 
 +* Resolved an issue with keys in the status menu not being handled for a period of time after the Status Menu is opened. 
 +* Resolved an issue with [[action:​Set_Variable_to_Text|Set Variable to Text]] action and arrays within tokens. ([forum](https://​forum.keyboardmaestro.com/​t/bug-version-11-set-variable-to-text-variable-name-by-indirection-variable-name-from-array-with-custom-delimiter/​33934)) 
 +* [[action:​Set_Variable_to_Text|Set Variable to Text]] action will error if it is setting an indexed element and the index is out of range. ([forum](https://​forum.keyboardmaestro.com/​t/​how-to-write-to-a-position-in-an-array-variable/​25702/​7)
 +* Resolved a performance issue with the [[token:​FrontDocumentPath|%FrontDocumentPath%]] token in the editor. 
 +* Possibly resolved an issue with [[trigger:​USB_Device_Key|USB Device Key]] triggers when lots of 0 packets are sent by the device. 
 +* Fixed an issue with the non-edit display of OCR languages. 
 +* Fixed an issue with non-integer screen refresh rates. 
 + 
 +==== Changed in 11.0.1 ==== 
 + 
 +* Request Calendar permission when using the [[action:​Create_Calendar_Event|Create Calendar Event]] action. 
 +* Fixed an issue with [[action:​Press_a_Button|Press a Button]] ​and other actions when it fails but does not abort the macro. 
 +* Fixed some issues with the [[action:​Select_Menu_by_Name|Select Menu by Name]] action. 
 +* Fixed [[action:​Search_and_Replace|Search and Replace]] action to fail when the source cannot be read. 
 +* Mitigate issue with 1Password corrupted bookmarks causing a crash/​lag. 
 +* Fixed an issue with [[action:​Show_Palette_of_Macros|Show Palette of Macros]] action not using the default theme initially. ([forum](https://​forum.keyboardmaestro.com/​t/​palettes-all-changed-with-v11/​33685)) 
 +* Fixed the [[token:​TriggerBase|%TriggerBase%]] token for the PeriodicTime of Day and other triggers. ([forum](https://​forum.keyboardmaestro.com/​t/​possible-bug-periodic-trigger-s-triggerbase-value-has-changed-in-km11/​33607)) 
 +* Fixed an issue with [[token:​FinderSelections|%FinderSelections%]] and other tokens on pre-Ventura systems.  
 +* Added a TokenTimeout and ForceSynchronousTokens preference. ([forum](https://​forum.keyboardmaestro.com/​t/​possible-bug-finderselections-token-returns-inaccurate-results-when-selecting-large-number-of-items/​33713)) 
 +* Fixed some false positives with modifier only [[trigger:​Typed_String|Typed String]] triggers. 
 +* Fixed an issue with [[action:​Find_Image_on_Screen|Find Image]] & [[action:​Move_or_Click_Mouse|Click Mouse With Found Image]] actions when Waiting For Match. 
 +* Resolved an issue with the macro group Toggle window stealing focus in Sonoma. 
 +* Fixed a possible issue with some [[trigger:​Wireless_Network|Wireless Network]] trigger names. 
 +* Fixed a minor issue with the non-Edit display of Smart Groups.
  
 ==== Editor ==== ==== Editor ====
  
-* Added configurable Favorite Actions([[https://​forum.keyboardmaestro.com/​t/​can-i-add-custom-action-to-other-actions-and-for-it-to-be-searchable-and-have-a-custom-name/​4843|forum]]) ([[https://​forum.keyboardmaestro.com/​t/​macro-kmfam-favorite-actions-and-macros/​4854|forum]]) +* Added New Macro Wizard to quickly make new macros. 
-* Added Select Macro by Name to the macro selector popup. ([[https://​forum.keyboardmaestro.com/​t/​request-make-it-easier-to-choose-a-macro-for-actions-like-enable-disable-macro/​22807|forum]]+* Added Security ​[[manual:Preferences|preference pane]] to summarise the state and adjust the various system security settings.  
-* Added This Macro and This Macro Group options to the macro selector popup. ([[https://​forum.keyboardmaestro.com/​t/​request-make-it-easier-to-choose-a-macro-for-actions-like-enable-disable-macro/22807|forum]]+* Added [[manual:Macro_Groups|Macro Group]] synching option to Disable ​Macro Group on All Macs. ([forum](https://​forum.keyboardmaestro.com/​t/​request-new-group-creation-pref-disabled-on-this-mac-on-all-cpus/32698)
-Added search field to macro selector popup+Report if macros that are deleted are in use by other macros
-* Added Evaluate Condition Results option+* Added deprecated: [[manual:​Search_Strings|search string]]
-Disable Evaluate Condition Results after action ​or safe macro import+Added action:1234 [[manual:​Search_Strings|search string]]
-Support dragging a .kmactions file in to an action list. +Added word:​wombat ​[[manual:Search_Strings|search string]]
-* Add Get functionality to Area selection for various actions like Move & Resize Window and Capture Screen. +* Show Click Location in Quick Look view of images in [[action:​Move_or_Click_Mouse|Click ​at Found Image]] action ​(contstant offsets only)
-* Used new [[action:Prompt_for_Screen_Rectangle|Prompt for Screen Rectangle]] for Get facility ​of [[action:​Move_or_Click_Mouse|Click ​Mouse]] action. +* Added “Do Not Ask Again” option ​to Evaluate Conditions alert
-* Added search field to Insert All Actions, All Functions, All Tokens, and Variables menus+* Added link to wiki [[manual:Preferences|Preferences]] in the General preferences settings.  
-* Added Select Last Aborted Action menu item. +Support inserting “¬” characters with option-Return in AppleScript script fields
-* Added `Or by Execute Macro` ​to macros editor listing the [[action:Execute_a_Macro|Execute a Macro]] actions referring to this macro([[https://​forum.keyboardmaestro.com/​t/​suggestion-macro-inspector-executed-by/​8182|forum]]) +Support text completion ​for Path fields
-Added Cut, Copy & Delete to contextual menu for Macro Group and Macro columns+Support ​`macros` in AppleScript smart groups. ([forum](https://​forum.keyboardmaestro.com/​t/​feature-request-applescript-parity-between-macro-groups-and-smart-macro-groups/14602/4)
-Added Copy as Execute a Macro, Set Macro Enable and Mark Macro actions to contextual menu for Macro column+Added warning if the Keyboard Maestro application is moved while it is running. ([link](https://www.keyboardmaestro.com/​action/​linkthru?​applicationmoved)
-Added Copy as Set Macro Group Enable and Toggle Macro Group actions to  contextual menu for Macro Group column. +* Added Find button when deleting a named clipboard that is used by one or more macros. 
-* Added Paste to the `No Actiondrag target contextual menu when the clipboard contains actions. +* Added Move Action Up/Down menu items
-* Support double-clicking dividers ​in the editor window to set ideal size. +* Added support ​to [[action:​Press_a_Button|Press a Button]] action to scan application windows for buttons
-* Support control-up/​down arrow in action lists to move actions up/down. Also command-control for top/bottom. ([[https://​forum.keyboardmaestro.com/​t/​is-there-any-shortcut-to-move-actions/2244|forum]]+Default new [[action:Execute_a_JavaScript_in_Front_Browser|Execute a JavaScript]] actions ​to modern syntax.  
-Support shift-insert action to insert ​the action above the current selection. ([[https://forum.keyboardmaestro.com/​t/​feature-request-insert-action-above/23927|forum]]+* Added live results ​to the [[action:​Search_and_Replace|Search and Replace]] ​action. ​([forum](https://​forum.keyboardmaestro.com/​t/​action-live-result-display/​3124))
-* Added Edit ➤ Insert ICU Date Field menu to insert the various ICU Date components. +
-* Added Edit ➤ Insert ICU Date Field By Name (^D) to insert the various ICU Date components ​by name. +
-* Added File ➤ Export as Folder and Export All Macros as Folder to export ​macros ​as individual files. +
-* Support tapping modifiers in editor search field to insert modifier symbol+
-* Added Sort Macros by Size+
-* Added size to Macro Inspector+
-Added “size:10000” ​to search filter+
-* Added “And 99 Filtered Macros” pseudo macro entry to Macros column when some macros are filtered by the search field. +
-* Added warning on Cancel All Macros, Cancel This Macro, Retry Loop, etc actions if it is not the last action ​of a sequence.+
  
 ==== Engine ==== ==== Engine ====
  
-* Added option to include ​[[manual:Macro_Groups|Macro Groups]] in the status menu bar. ([[https://​forum.keyboardmaestro.com/​t/​feature-request-add-optional-customizable-status-menus/19249|forum]]+* Added [[trigger:keyboardmaestro|keyboardmaestro]] command line tool for triggering or editing macros. 
-Updating icons and title+* Added modern JavaScript syntax mode. 
-Updating information ​in the menu. +* Added support for limiting variables passed to scripts. 
-Executing on selection or automatically when the menu is displayed+* Added Apple Text Recognition to OCR options (macOS 10.15+). ([forum](https://​forum.keyboardmaestro.com/​t/​apple-vision-ocr-instead-of-tessaract/24464)
- * Added [[trigger:Group_Status_Menu|Group Status Menu]] trigger+Added Active Macro Groups palette to show which groups are active (available via the Help menu or the Status Menu)
-Added support for manipulating Keyboard Maestro Engine windows in the [[action:Manipulate_a_Window|Manipulate a Window]] action. +Simplified `Paste "​xyz"​` submenu ​in the status ​menu to just display the text
-* Added [[action:Set_Next_Engine_Window_Position|Set Next Engine Window Position]] action. +Added an option to include macro icons in the status ​menu. 
-Subroutines +* Added an option to include macro icons in the group status menus. 
-Added [[trigger:Subroutine|Subroutine]] trigger which defined parameters to be passed ​to the macro+* AppleScript `do script` now returns results from the [[action:Return_from_Subroutine|Return]] action
-Added [[action:Execute_a_Subroutine|Execute a Subroutine]] action ​to execute ​a macro, passing it parameters+Execute Macro shortcut returns results from the [[action:Return_from_Subroutine|Return]] action. 
-Added [[action:Return_from_Subroutine|Return from Subroutine]] action ​to return ​a value from subroutine macros.+* Added Blue Topaz palette theme. ([forum](https://​forum.keyboardmaestro.com/​t/​custom-palette-style-colors/​3516/​28)) 
 +* Request Screen Recording permission if the [[condition:​Pixel|Pixel]] condition is used. 
 +* Request Contacts permission if the [[token:​AddressBook|%AddressBook%]] token is used. 
 +* Allow [[action:Create_Unique_File|Create Unique File]] action ​without an output variable to execute without error
 +Improved detection and reporting of errors in [[actions:​Browser_Actions|Browser Actions]]. 
 +Use custom ​[[action:For_Each|For Each]] action name in Display Progress title. ([forum](https://​forum.keyboardmaestro.com/​t/​for-each-action-now-has-its-own-progress-bar-km10/​26437/​8)) 
 +* Added an option ​to show only images in the [[manual:​Clipboard_History_Switcher|Clipboard History Switcher]]([forum](https://​forum.keyboardmaestro.com/​t/​search-filter-images-only-in-clipboard-history-switcher/​30123)) 
 +Support Command & Command-Shift Arrows in Spotlight-like windows. 
 +* Support `\` processing in variable token array item separators (eg %Variable%Lines[3]\n%). 
 +* Limit [[token:FrontBrowserJavaScript|%JavaScript%]] tokens maximum execution time to half second. 
 +* Support arbitrarily large numbers of files [[trigger:​Dragged_File|dropped on a palette entry]]. ([forum](https://​forum.keyboardmaestro.com/​t/​increase-maximum-number-of-files-that-can-be-dropped-on-a-macro/31285)) 
 +* Resolve symlinks for Applications (specifically this helps with the move of Safari in Ventura)
 +Removed use of deprecated SecKeychainUnlock et al. 
 +* Remove the "The text is" (and similar) from the Display Text windows. ([forum](https://​forum.keyboardmaestro.com/​t/​change-manipulate-the-title-of-the-display-text-in-window/​32567/​4)) 
 +* Allow [[action:Prompt_for_User_Input|Prompt for User Input]] sliders ​to return ​decimals([forum](https://​forum.keyboardmaestro.com/​t/​slider-keeps-rounding-my-values-down/​32936/​2))
  
 ==== Triggers ==== ==== Triggers ====
  
-* Added [[trigger:Unlock|Unlock]] trigger. ([[https://​forum.keyboardmaestro.com/​t/​execute-macro-every-time-mac-unlocks/​2347|forum]]) +* Added [[trigger:Space_Changed|Space Changed]] trigger. ([forum](https://​forum.keyboardmaestro.com/​t/​feature-request-new-trigger-desktop-space-change/32640)
-* Added [[trigger:​Appearance_Changed|Appearance Changed]] trigger. ​([[https://​forum.keyboardmaestro.com/​t/​trigger-request-change-in-dark-mode/21119|forum]]+* Added tapped only once/​twice/​3 times options to [[trigger:​Hot_Key|Hot Key]] and [[trigger:​USB_Device_Key|USB Device Key]] triggers. 
-* Added [[trigger:​Power_Status_Changed|Power Status Changed]] trigger. +Added support for modifiers in [[trigger:​Typed_String|Typed String]] ​triggers (eg “em⇧” means e, m, tap the shift key). ([forum](https://​forum.keyboardmaestro.com/​t/​suggestion-use-key-sequences-including-modifiers-to-trigger-macros/​27093))
-* Added “long press” option for [[trigger:​Hot_Key|Hot Key]] and [[trigger:​USB_Device_Key|USB Device Key]] triggers. +
-Disallow adding duplicate redundant ​triggers (like two Power Status Changed triggers).+
  
 ==== Actions ==== ==== Actions ====
  
-* Added [[action:Paste_by_Name|Paste by Name]] action ​giving Spotlight-like search of clipboard history+* Added [[action:Prompt_for_Snippet|Prompt for Snippet]] action. 
-* Added [[action:Prompt_for_Screen_Rectangle|Prompt for Screen Rectangle or Location]] action. +* Added [[action:Create_Calendar_Event|Create Calendar Event]] action ​(macOS 10.14+)
-* Added [[action:Try_or_Catch|Try/Catch]] and [[action:Throw|Throw]] actions([[https://forum.keyboardmaestro.com/​t/​email-notification-upon-macro-failure/​18416|forum]]) ([[https://forum.keyboardmaestro.com/​t/​feature-request-try-catch-finally/​5954|forum]]) +* Added [[action:Send_Pushover_Notification|Send Pushover Notification]] action. 
-* Added [[action:Display_Progress|Display Progress]] action. +* Added [[action:Set_Screen_Resolution|Set Screen Resolution]] action. 
-* Added Display Progress ​option to [[action:For_Each|For Each]] action. +* Added [[action:Select_Menu_by_Name|Select Menu by Name]] action. 
-* Added [[action:Pause_Until_Change|Pause Until Change]] action to detect clipboard, modifiers, keyboard, mouse, or application changes+* Added [[action:​Remove_Clipboard_Flavors|Remove Clipboard Flavors]] action. 
-* Added [[action:Create_Unique_File|Create Unique File]] action. +* Added [[action:Set_Audio_Device|Set Audio Input/Output/Sound Effects Device]] actions 
-* Added additional field types to the [[action:Prompt_for_User_Input|Prompt for User Input]] action+* Added [[action:​Mute_Audio_Device|Mute/Unmute Audio Device]] actions. 
- * Added Date, Time and Date & Time picker fields+* Added [[action:Get_Location|Get Location]] action. 
- * Added Slider fields. +* Added option to [[action:Move_or_Click_Mouse|Click at Found Image]] action ​to wait for the image to appear
- * Added Color Well fields+* Added option to [[action:Find_Image_on_Screen|Find Image on Screen]] action to wait for the image to appear
-* Added icon chooser selection ​to [[action:Set_File_Icon|Set File Icon]] and [[action:Set_Clipboard_to_Image|Set Clipboard to Image]] and other actions+* Added Progress Bar option to [[action:Group|Group]] action. ​([forum](https://​forum.keyboardmaestro.com/​t/​for-each-action-now-has-its-own-progress-bar-km10/​26437/​12)) 
-* Added support for selecting multiple files or folders in the [[action:Prompt_for_File|Prompt for File]] action. ([[https://​forum.keyboardmaestro.com/​t/​prompt-for-multiple-files/15297|forum]]). +* Added Progress Bar option ​to [[action:Repeat|Repeat]] action. 
-* Added support for creating the folder when selecting a new folder in the [[action:Prompt_for_File|Prompt for File]] action. +* Added support for other kinds of behaviours (eg showing a menu) to the [[action:​Press_a_Button|Press a Button]] action([forum](https://​forum.keyboardmaestro.com/​t/​whats-the-best-way-to-work-with-mini-menus-not-the-menu-bar/​10853/​2)) 
-* Added *separated by* option to [[collection:Substrings_In|Substrings In]] collection([[https://​forum.keyboardmaestro.com/​t/​suggestion-for-new-collection-for-for-each-list-items/23014/4|forum]]) +* Added an optional HelpURL field to [[manual:Plug_In_Actions|Plug In Actions]]. ([forum](https://​forum.keyboardmaestro.com/​t/​feature-request-support-for-proper-help-information-in-third-party-plugins/​20285)) 
-* Added option to control text processing of input text for a variety of actions. ([[https://​forum.keyboardmaestro.com/​t/​bug-regex-replace-that-converts-some-text-to-lower-case-in-error-macro-v9-2/21168|forum]]+* Added support to [[action:Set_JSON_Value|Set JSON Value]] action to delete dictionary or array entries by setting to `%Delete%`
-* Added option to [[action:Search_and_Replace|Search and Replace]] action ​to replace only the first or last match. ([[https://​forum.keyboardmaestro.com/​t/​request-add-switch-to-km-search-replace-to-turn-global-matches-on-off/22986|forum]]+* Added explicit File Move and File Rename options to the [[action:Move_or_Rename_a_File|Move or Rename a File]] action. ([forum](https://​forum.keyboardmaestro.com/​t/​wiki-update-file-actions/11023)
-Added option to control volume of [[action:Speak_Text|Speak Text]] action. ([[https://​forum.keyboardmaestro.com/​t/​speak-text-volume/18362|forum]]+* Added Hide Other Applications,​ Bring All Windows to Front and Reopen Initial Windows options to [[action:Activate_a_Specific_Application|Activate a Specific Application]] action ​when already at front
-Added a variety of macro environment variables (eg KMINFO‗TriggerValue) to the [[action:​Execute_a_Shell_Script|Execute ​a Shell Script]] action. +* Added an option to reduce the CPU usage of [[action:Pause_Until|Pause Until]] actions for long running pauses. 
-Added a calculation option ​to [[action:Switch_or_Case|Switch]] other actions. +* Support ​[[action:​Set_Variable_to_Text|Set Variable to Text]] action setting array elements of a variable. ([forum](https://​forum.keyboardmaestro.com/​t/​how-to-loop-through-array-variable/​13498/​3)) 
-An [[action:Assert|Assert]] action with an empty condition ​now always asserts.+* Added configurable themes ​for [[action:​Show_Palette_of_Macros|Show Palette of Macros]] action. ([forum](https://​forum.keyboardmaestro.com/​t/​how-to-have-multiple-conflict-palette-styles/29239)) 
 +* Added option to [[manual:​Applications_Palette|Applications Palette]] to default to Hide Others when switching. 
 +* Added option to [[action:​Apply_Modifiers_to_a_Specific_Application|Apply Modifiers to Application]] action to default to Hide Others when switching. 
 +* Add options ​for All Windows and Reopen Windows to [[action:​Activate_Last_Application|Activate Last Application]] action. ([forum](https://​forum.keyboardmaestro.com/​t/​is-there-a-km-action-equivalent-to-btt-switch-to-previous-window/31917/25)
 +* Added File option to [[action:Stream_Deck_Set_Image|Stream Deck Set Image]] action. ([forum](https://​forum.keyboardmaestro.com/​t/​stream-deck-set-the-image-to-a-file-like-found-image-works/22619)
 +Support Save to File as an output ​option to the [[action:Get_a_URL|Get a URL]], [[action:​Execute_a_Shell_Script|Execute Script]]/​[[action:​Execute_Shortcut|Shortcut]],​ and [[action:​Plug_In|Plug In]] actions. ([forum](https://​forum.keyboardmaestro.com/​t/​copying-an-image-from-a-web-page-into-clipboard-having-some-issues-best-approach/30527/6)
 +Support saving images to Clipboard/​File in a variety of formats for [[action:​Get_a_URL|Get a URL]], ​[[action:​Execute_a_Shell_Script|Execute Script]]/[[action:​Execute_Shortcut|Shortcut]],​ and [[action:​Plug_In|Plug In]] actions
 +Adjusted [[action:​Hide_Front_Application|Hide Front Application]] action ​to wait for the application to no longer be active before proceeding. 
 +* Adjusted ​[[action:Quit_a_Specific_Application|Quit Application]] (et al) actions ​to wait for the application to terminate (or relaunch). 
 + 
 +==== Conditions ==== 
 + 
 +Add a [[condition:File_Attribute|File Attribute]] condition. ([forum](https://​forum.keyboardmaestro.com/​t/​how-prevent-an-action-from-working-under-certain-conditions/​24333)) 
 +* Added [[condition:​Macro|Macro is Executing]] condition ​condition.
  
 ==== Filters ==== ==== Filters ====
  
-* Added [[manual:​Filters|filter]] ​Sort, Reverse and Shuffle Lines([[https://​forum.keyboardmaestro.com/​t/​help-randomizing-a-list-of-words/​3409|forum]]) ​ +* Added Sentence Case [[manual:​Filters|filter]]. 
-* Added [[manual:​Filters|filter]] ​Escape for Regular Expression. +* Added Styled Text to/from RTF [[manual:​Filters|filter]]. ​([forum](https://​forum.keyboardmaestro.com/​t/​request-for-a-new-token-compositetextwidth/23344/15)
-* Added [[manual:​Filters|filter]] Quote for JSON. +Adjusted the Word Count [[manual:​Filters|filter]] ​so that “1.49” is one word.
-* Added [[manual:​Filters|filter]] URL components such as scheme, host and path. ([[https://​forum.keyboardmaestro.com/​t/​extract-domain-from-url-with-regex/15736/8|forum]]+
-Added [[manual:​Filters|filter]] ​Encode & Decode Base64. +
-* Added [[manual:​Filters|filter]] Encode HTML With Numeric Entities. +
-* Added [[manual:​Filters|filter]] Calculate MD5. +
-* Updated to the latest of John Gruber & Aristotle Pagaltzis Title Case [[manual:​Filters|filter]],​ and internalized it to remove perl dependency.+
  
 ==== Tokens ==== ==== Tokens ====
  
-* Added [[token:LastWindowID|%LastWindowID%]] token. +* Added [[token:FrontBrowserWindowName|%Safari/​Chrome/​FrontBrowserWindowName%]] tokens. 
-* Added [[token:PromptWithListText|%PromptWithListText%]] token. +* Added [[token:​FrontBrowserVersion|%Safari/​Chrome/​FrontBrowserVersion/​LongVersion%]] tokens
-* Added [[token:PasteByNameText|%PasteByNameText%]] token. +* Added [[token:FrontBrowserPath|%Safari/​ChromeBundleID/​Path/​Name%]] tokens. 
-* Added [[token:UserHome|%UserHome%]] token. +* Added [[token:​FrontDocumentPath|%FrontDocumentPath%]] token (thanks Chris!). ([forum](https://​forum.keyboardmaestro.com/​t/​finding-the-file-path-for-the-front-document-in-the-front-application/​7095)) 
-* Added [[token:FinderSelection|%FinderSelection%]] and [[token:FinderSelections|%FinderSelections%]]  tokens. +* Added [[token:ApplicationVersion|%ApplicationVersion/​LongVersion%]] tokens. ([forum](https://​forum.keyboardmaestro.com/​t/​feature-request-an-enhancement-to-get-hardware-and-software-based-information-without-coding/​31812)) 
-* Added [[token:AccessedVariables|%AccessedVariables%]] token.+* Added [[token:​KeyboardMaestroVersion|%KeyboardMaestroVersion/​LongVersion%]] tokens([forum](https://​forum.keyboardmaestro.com/​t/​feature-request-an-enhancement-to-get-hardware-and-software-based-information-without-coding/​31812)) 
 +* Added [[token:SystemVersion|%SystemVersion/​LongVersion%]] tokens. ([forum](https://​forum.keyboardmaestro.com/​t/​feature-request-an-enhancement-to-get-hardware-and-software-based-information-without-coding/​31812)) 
 +* Added [[token:​LastAbortedActionID|%LastAbortedActionID%]] token. ​([forum](https://​forum.keyboardmaestro.com/​t/​try-catch-would-love-to-get-more-details-in-tokens/​25244/​3)) 
 +* Added [[token:OptionReturn|%OptionReturn%]] token (valid in Insert Text by Typing only). 
 +* Added [[token:​ScreenResolution|%ScreenResolution(s)%]] tokens. 
 +* Added [[token:​AudioInputDevice|%AudioInputDevice(UID)%]] tokens. 
 +* Added [[token:​AudioOutputDevice|%AudioOutputDevice(UID)%]] tokens. 
 +* Added [[token:​AudioSoundEffectsDevice|%AudioSoundEffectsDevice(UID)%]] tokens. 
 +* Added [[token:​AudioInputDevices|%AudioInputDevices%]] and [[token:AudioOutputDevices|%AudioOutputDevices%]] tokens. 
 +* Added [[token:MusicPlayerState|%MusicPlayerState%]] token. 
 +* Added [[token:​SystemClipboardFlavors|%SystemClipboardFlavors%]] token 
 +* Added [[token:​PastClipboardFlavors|%PastClipboardFlavors%]] token 
 +* Added [[token:​NamedClipboardFlavors|%NamedClipboardFlavors%]] token 
 +* Added [[token:​TriggerClipboardFlavors|%TriggerClipboardFlavors%]] token 
 +* Adjusted the [[token:​FinderSelection|%FinderSelection(s)%]] tokens to return the selected item, not the target of an alias/link. ([forum](https://​forum.keyboardmaestro.com/​t/​finderselections-with-symbolic-links/​29015))
  
 ==== Functions ==== ==== Functions ====
  
-* Added [[function:DOUBLECLICKINTERVAL|DOUBLECLICKINTERVAL]][[function:KEYREPEATDELAY|KEYREPEATDELAY]][[function:KEYREPEATINTERVAL|KEYREPEATINTERVAL]] functions+* Added [[function:PROCESSORS|PROCESSORS()]] function. ([forum](https://​forum.keyboardmaestro.com/​t/​feature-request-an-enhancement-to-get-hardware-and-software-based-information-without-coding/​31812)) 
-* Added [[function:SCREENINDEX|SCREENINDEX]] function ​that returns the index of the specified screen. +* Added [[function:MEMORY|MEMORY()]] function. ([forum](https://​forum.keyboardmaestro.com/​t/​feature-request-an-enhancement-to-get-hardware-and-software-based-information-without-coding/​31812)) 
 +* Added [[function:UPTIME|UPTIME()]] function. ([forum](https://​forum.keyboardmaestro.com/​t/​feature-request-an-enhancement-to-get-hardware-and-software-based-information-without-coding/​31812)) 
 +* Added an optional second parameter to [[function:ROUND|ROUND]], [[function:​CEIL|CEIL]],​ [[function:​FLOOR|FLOOR]],​ and [[function:​TRUNC|TRUNC]] functions.
  
-==== Clipboard History ​==== +==== Fixes ====
- +
-* Added Characters / Words / Lines count to [[manual:​Clipboard_History_Switcher|Clipboard History Switcher]]. +
-* Adjusted [[manual:​Clipboard_History_Switcher|Clipboard History Switcher]] numbering to match [[token:​PastClipboard|%PastClipboard%]]. +
-* Added Command-Control/​Option/​Shift-numbers to [[manual:​Clipboard_History_Switcher|Clipboard History Switcher]] to Paste or Set optionally plain clipboards. +
-* Added Option-double-click (or option-Return) in [[manual:​Clipboard_History_Switcher|Clipboard History Switcher]] to set the system clipboard. +
- +
-==== Custom HTML Prompt ==== +
- +
-* Added ProcessAppleScript command to [[action:​Custom_HTML_Prompt|Custom HTML Prompt]]. +
-* Added option to turn off title bar on [[action:​Custom_HTML_Prompt|Custom HTML Prompt]] window. ([[https://​forum.keyboardmaestro.com/​t/​why-isnt-custom-html-prompt-resizable/​4602/​8|forum]]) +
-* Added option to make [[action:​Custom_HTML_Prompt|Custom HTML Prompt]] window transparent. ([[https://​forum.keyboardmaestro.com/​t/​why-isnt-custom-html-prompt-resizable/​4602/​8|forum]]) +
-* Added context sensitive [[function:​WINDOW|WINDOW]] function for [[action:​Custom_HTML_Prompt|Custom HTML Prompt]] window resizing operations.  +
- +
-==== Debugger ==== +
- +
-* Added a button in the debugger to edit the macro action. ([[https://​forum.keyboardmaestro.com/​t/​request-provide-km-macro-debugger-button-to-take-you-to-the-editor-macro-in-use/​14111|forum]]) +
-* Added display of recently accessed variables in the debugger. ([[https://​forum.keyboardmaestro.com/​t/​request-provide-dynamic-display-of-macro-variables-in-debugger/​13655|forum]]) ([[https://​forum.keyboardmaestro.com/​t/​bug-report-local-instance-variables-show-in-variable-token-list/​14241/​2|forum]]) +
- +
-==== AppleScript ==== +
- +
-* Added support for getting and setting the Display in Menu Bar Macro Group settings via AppleScript. +
-* Added “xml” AppleScript property for macros, macro groups and smart groups. ([[https://​forum.keyboardmaestro.com/​t/​suggestion-quick-diff-for-macros-inside-km/​20307/​6|forum]]) +
-* Added “group xml” AppleScript property for macro groups. +
-* Added “last used” AppleScript property for macros. ([[https://​forum.keyboardmaestro.com/​t/​km-last-execution-date/​16166|forum]]) +
-* Added “modification date” AppleScript property for macro groups and smart groups. +
-* Added AppleScript support to the editor for showing preference panes. +
-* Added support for AppleScript “edit” command, eg “edit macro 1”. +
-* Added support for AppleScript to get/set the editing property of an editor window. +
-* Added option to Search & Replace to replace only the first or last match. +
-* Added instance parameter to process tokens and calculate commands. +
-* Added selectAction command to select a specific action by id. +
-* Added divider1 and divider2 properties to the editor window. +
-* Added size property to Macro Groups and Macros. +
- +
-==== Minor ==== +
- +
-* Added SF Symbols to Icon Chooser (11.0+) +
-* Added Export as Text Service. +
-* Added Export as Finder Quick Action. +
-* Show notification when the launching editor quits the engine. +
-* Excluded com.microsoft.ole.source..* flavors from clipboard for better Microsoft compatibility. +
-* Adjusted Copy action to note clipboard changes even if the clipboard is not read. ([[https://​forum.keyboardmaestro.com/​t/​copy-function-timeouts-without-updating-system-clipboard/​14959/​23|forum]]) +
-* Adjusted VoiceOver to speak marked status in palette entries. ([[https://​forum.keyboardmaestro.com/​t/​midi-control-change-for-blind-users/​20031/​29|forum]]) +
-* Use ENV‗PWD to set the current working directory for shell scripts. ([[https://​forum.keyboardmaestro.com/​t/​node-js-dirname-pointing-to-a-temporary-folder/​23570/​9|forum]]) +
-* Improved the Share to Forum sheet. ([[https://​forum.keyboardmaestro.com/​t/​suggested-ui-change-for-sharing-uploading-macros-actions-from-km-editor/​14909|forum]]) +
-* Support longer variable names in Prompt For User Input when they will fit under the icon. +
-* Support formatting AppelScript and JavaScript conditions. +
-* Support shift arrow selection in Prompt With List (Multiple Selections). ([[https://​forum.keyboardmaestro.com/​t/​help-to-create-a-macro-list-delimiters-item-enumeration/​20223/​8|forum]]) +
-* Converted use of WebView to WKWebView. +
-* Improved appearance of Preferences toolbar in Big Sur.  +
-* Improved display of CALCULATE function when the contents are potentially valid. +
-* Support Return/​Enter as a keystroke for the ↩ character in the Conflict Palette. ([[https://​forum.keyboardmaestro.com/​t/​space-or-return-to-trigger-the-first-macro-in-a-conflict-panel/​23327/​8|forum]]) +
-* Added Audio Input and Camera entitlements to the Engine (to allow their use via scripts etc). +
-* Added Restore Excluded Application entry to Applications Palette contextual menu. +
-* Added Tooltips for Palettes. ([[https://​forum.keyboardmaestro.com/​t/​feature-request-palette-with-icons-only-show-hints/​3739|forum]]) ([[https://​forum.keyboardmaestro.com/​t/​request-tooltips-for-palette-nuttons/​16273|forum]]) +
-* Added AdditionalWebBrowserBundleIDs preference to add alternative bundle IDs for front browser list. +
-* Allow Microsoft Edge and Brave Beta as a possible Front Browser Chrome-equivalent. +
-* Allow Spotlight-like windows to be movable. +
-* Adjusted the hit boxes for various application and macro popup menus. ([[https://​forum.keyboardmaestro.com/​t/​moving-actions-that-have-selection-options-within-a-macro/​22335|forum]]) +
-* Ignore the option key when switching applications in the Applications Switcher if the option key is used in the trigger. +
-* Remove “Instance ” and “Local ” from variable names in [[action:​Prompt_for_User_Input|Prompt for User Input]] form. +
-* Report lack of Screen Recording permission when that stops an action from working. +
-* Better reporting of lack of Screen Reporting errors in Find Image and Click Mouse actions. +
-* Added control over OCR Image behaviour when the action fails. +
-* The Macro Group macros in the Global Macro Palette use the Macro Group’s custom icon if any. +
-* Prompt For User Input no longder displays hidden fields in non-edit mode. ([[https://​forum.keyboardmaestro.com/​t/​plug-ins-hidden-parameters-showing-in-editor/​22521|forum]]) +
-* Switched to CWWiFiClient for Wireless Network trigger, token and conditions. +
-* Display some editor alerts within the editor window. +
-* Display some logged error messages more prominently. +
-* Display time trigger time in localized format in non-edit mode. +
-* Avoid logging repeated errors. +
-* Adjusted Write File to fail rather than trash a folder that will be replaced with a file. ([[https://​forum.keyboardmaestro.com/​t/​setting-path-as-folder-in-write-to-file-empties-the-folder/​23666/​19|forum]]) +
-* Only report large variables excluded from environment every ten minutes. +
-* Added appropriate window titles (visible via AppleScript/​accessibility) to the various “By Name” windows. ([[https://​forum.keyboardmaestro.com/​t/​how-to-get-the-position-of-a-keyboard-maestro-user-prompt-window/​24011|forum]]) +
-* Avoid selecting the macro/group name when deleting macro/​groups. +
-* Added action id to failed action log message. ([[https://​forum.keyboardmaestro.com/​t/​error-handling-debugging-line-numbers/​14133|forum]]) +
-* Added a few more default status menu icon options. +
-* Added additional protections for the Write File action. +
-* Fixed activation of windows so you can use the Clipboard Switcher to paste in to other Keyboard Maestro Engine windows. +
-* Fixed a bug enabling the Send button in the Report Bugs form (irony). +
-* Fixed width of Trigger Macro by Name and other Spotlight-like windows in Big Sur. ([[https://​forum.keyboardmaestro.com/​t/​display-bug-in-trigger-macro-by-name-layout-in-big-sur/​20711/​4|forum]]) +
-* Fixed Paste XML actions. ([[https://​forum.keyboardmaestro.com/​t/​what-is-the-status-of-the-paste-xml-action-feature/​21815|forum]]). +
-* Fixed an issue with Prompt For User Input and long variable names. ([[https://​forum.keyboardmaestro.com/​t/​request-stop-shortening-long-variable-names-in-prompt-for-user-input/​16271|forum]]). +
-* Fixed an issue with a couple actions not saving changes when a token was selected. +
-* Fixed an issue with file references to images that included non-ASCII characters. +
-* Improve accessibility of editor toolbar buttons. +
-* Fixed Login Window action in Big Sur  (CGSession no longer exists). +
-* Fixed a display issue for popup menus in Plug In Actions. ([[https://​forum.keyboardmaestro.com/​t/​bug-report-parameter-display-truncated-in-third-party-plug-ins/​22694|forum]]) +
-* Fixed Trim Image to keep the full resolution and DPI. +
-* Fixed a potential crash with the Reveal a File action. +
-* Fixed an issue related to ^ in the Substrings In collection. ([[https://​forum.keyboardmaestro.com/​t/​issue-with-regex-in-for-each-to-extract-first-string-in-each-line/​22724|forum]]) +
-* Fixed an issue where renaming a macro via the contextual menu would not scroll the name field in to view. +
-* Fixed an issue with Search and Replace matching multiple times at the end of the string. ([[https://​forum.keyboardmaestro.com/​t/​keyboard-maestro-regular-expression-bug-trim-whitespace-from-start-and-end-of-a-string/​22963|forum]]). +
-* Fixed an issue where the engine might not be notified of macro changes if the editor is quit immediately after making the change. +
-* Fixed an issue with the [[action:​Sleep_Screen|Sleep Screen]] action in Apple Silicon Macs.+
  
 +* Fixed a performance issue in the editor switching to/from macros with large numbers of triggers. ([forum](https://​forum.keyboardmaestro.com/​t/​performance-of-a-macro-with-many-key-triggers/​16128))
 +* Fixed a crash that could happen if the icon of one macro was dependent on another recursively. ([forum](https://​forum.keyboardmaestro.com/​t/​km-editor-crashing-at-launch/​32735))
 +* Fixed a possible crash after duplicate [[trigger:​Typed_String|Typed String]] triggers fire and the macros are immediately reloaded.
 +* Fixed an issue with [[action:​Prompt_for_User_Input|Prompt for User Input]] sliders with initial values above 100. ([forum](https://​forum.keyboardmaestro.com/​t/​slider-keeps-rounding-my-values-down/​32936/​2))
 +* Fixed some issues with the Ruler in text views.
 +* Fixed an issue with the [[token:​VBAR|%|%]] token and emoji. ([forum](https://​forum.keyboardmaestro.com/​t/​bug-cursor-positioned-incorrectly-after-inserting-text-with-emojis/​32446))
 +* Fixed an issue searching for greater than 16-bit unicode characters. ([forum](https://​forum.keyboardmaestro.com/​t/​im-not-sure-that-emoji-are-reliably-searchable-in-the-keyboard-maestro-editor/​16852))
 +* Fixed some issues with truncating strings with greater than 16-bit unicode characters.
 +* Fixed a glitch in the KeyCaps.icns file. ([forum](https://​forum.keyboardmaestro.com/​t/​other-icons-export-as-trigger-file/​31740/​3))
 +* Fixed an issue with [[token:​FinderSelection|%FinderSelection%]] and [[token:​FinderSelections|%FinderSelections%]] tokens.
 +* Fixed an issue with [[trigger:​USB_Device_Key|USB Device Key]] trigger and MacBook Pro M2 Product ID = 0 keyboards.
 +* Fixed [[action:​Execute_a_JavaScript_in_Custom_Prompt|Execute a JavaScript in Custom Prompt]] action to process tokens on script paths.
 +* Fixed using Helvetica in the Spotlight-like windows.
 +* Fixed [[manual:​URL_Schemes|keyboardmaestro:​ URL]] so it works when the editor is launched.
 +* Fixed [[trigger:​Typed_String|Typed String]] triggers with regular expressions to produce conflict palettes if appropriate.
 +* Fixed an issue with the non-edit trigger display of times in certain time zones. ([forum](https://​forum.keyboardmaestro.com/​t/​set-a-time-trigger-shows-a-different-time/​29059))
 +* Fixed setting [[action:​Trigger_Macro_by_Name|Trigger Macro by Name]] to a Smart Macro Group. ([forum](https://​forum.keyboardmaestro.com/​t/​trigger-macro-by-name-limit-to-smart-group-results/​29546))
 +* Fixed a memory leak when finding images. ([forum](https://​forum.keyboardmaestro.com/​t/​excessive-keyboard-maestro-engine-memory-usage/​30175/​))
 +* Fixed an issue with the Interactive Help listing macro execution multiple times.
 +* Fixed an issue with the Interactive Help not listing recorded Quick Macro executions.
 +* Added some logging for failed Accessibility window manipulations.
 +* Fixed issue where a duplicated search string matched action does not appear matched.
 +* Fixed an issue with overly enthusiastic search field completion suggestions. ​
 +* Fixed issue with Palettes displaying wide enough to hold a title that is not shown. ([forum](https://​forum.keyboardmaestro.com/​t/​cant-understand-why-palette-contains-a-wide-blank-area/​33081/​4))
 +* Fixed an issue with the window switcher switching to different monitors. ([forum](https://​forum.keyboardmaestro.com/​t/​window-switcher-activate-window-on-other-monitor/​33018))
  
 ==== Download ===== ==== Download =====
Line 210: Line 195:
  
 Alternatively,​ you can [[mailto:​support@stairways.com|contact us]] if you have a question about whether Keyboard Maestro can solve your automation needs. We want all our customers to be satisfied, so we are happy to help you understand how Keyboard Maestro can achieve your automation goals. Alternatively,​ you can [[mailto:​support@stairways.com|contact us]] if you have a question about whether Keyboard Maestro can solve your automation needs. We want all our customers to be satisfied, so we are happy to help you understand how Keyboard Maestro can achieve your automation goals.
 +
manual/Whats_New.1634547426.txt.gz · Last modified: 2021/10/18 04:57 by peternlewis