Differences

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

--- manual:Preferences [2023/10/16 07:21] – [General Preferences] peternlewis
+++ manual:Preferences [2024/07/16 12:10] (current) – [Browser Used in Actions & Tokens] peternlewis
@@ Line 93: / Line 93: @@
 ===== Security Preferences =====
-Keyboard Maestro is designed to act on your behave and to do many things for you - essentially acting as you in performing tasks. As such, it needs a wide variety of security permissions to perform these tasks.
+Keyboard Maestro is designed to act on your behalf and to do many things for you - essentially acting as you in performing tasks. As such, it needs a wide variety of security permissions to perform these tasks.
 This preference panel aims to summarise the important preferences and allow you to explicitly request them as needed.
@@ Line 243: / Line 243: @@
 **Change which Safari-based Browser will be targeted by the "Safari" Actions, Tokens, and Functions.**
-These preferences change AppleScript Application name that is used to control the respective browser in the form of CODE{{{tell application "<browser name>"}}}.  Note that the Safari browser must still behave like Safari, and the Chrome browser must behave like Chrome, or the actions will not work.  Do not bother trying to set them to Firefox or something like that as it will not work.  All this allows you to do is select a specific version of Safari or Chrome respectively.
+These preferences change the AppleScript Application name that is used to control the respective browser in the form of CODE{{{tell application "<browser name>"}}}.  Note that the Safari browser must still behave like Safari, and the Chrome browser must behave like Chrome, or the actions will not work.  Do not bother trying to set them to Firefox or something like that as it will not work.  All this allows you to do is select a specific version of Safari or Chrome respectively.
-You can Safari-based Browser targeted in Actions, etc, as well as the name of the Safari browser shown in applications:
+You can configure which Safari-based Browser is targeted in Safari Actions, as well as the name of the Safari browser shown in the actions:
 <code bash>
 defaults write com.stairways.keyboardmaestro.engine AppleScriptSafariBundleID -string "com.apple.SafariTechnologyPreview"
 defaults write com.stairways.keyboardmaestro.engine BrowserSafariName -string "Safari Tech"
-</code>
-or
-<code bash>
-defaults write com.stairways.keyboardmaestro.engine AppleScriptSafariName -string "com.apple.Safari"
 </code>
@@ Line 303: / Line 297: @@
 :!: Note:  if the bundle ID includes “safari”, it is considered a Safari browser, otherwise it is considered a Chrome-based browser.
+==== Tokens ====
+Tokens are limited to 0.9 seconds in execution time, and are executed somewhat asynchronously in Ventura and later. You can control this with:
+<code bash>
+defaults write com.stairways.keyboardmaestro.engine TokenTimeout -float 0.9
+defaults write com.stairways.keyboardmaestro.engine ForceSynchronousTokens -bool YES
+</code>
 ==== Engine Animation ====
@@ Line 361: / Line 364: @@
 defaults write com.stairways.keyboardmaestro.engine MaxTapUpTime -float 1.0
 </code>
+The default allowable down time is the double click interval, and the default allowable up time is twice the double click interval.
 ==== Sounds ====
@@ Line 402: / Line 407: @@
 </code>
-The default allowable down time is the double click interval, and the default allowable up time is twice the double click interval.
+==== Status Menu ====
 You can set configure whether the Status Menu includes the Paste submenu and how many items it includes with:
@@ Line 411: / Line 416: @@
 </code>
-You can set configure Display Large text color and display period with:
+==== Display Large Text ====
+You can set configure Display Large Text color and display period with:
 <code bash>