Differences

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

--- manual:Preferences [2019/11/19 22:14]
peternlewis typo
+++ manual:Preferences [2020/08/17 21:53]
JMichaelTX [Chrome Browser Used in Actions & Tokens]
@@ Line 90: / Line 90: @@
 You can also add and remove applications from the clipboard history exclusion list.  When an excluded application is at the front, Keyboard Maestro will not automatically record the clipboard history each time it changes.  It will still read the current System Clipboard if you explicitly ask for it in a macro or open the Clipboard History Switcher.
-===== Other Hidden Preferences =====
+===== Preferences Set by Command Line =====
 You can configure various preferences using defaults write from the Mac OS X Terminal.  Some preferences will take effect immediately, but others may require the editor or engine to be relaunched.
@@ Line 193: / Line 193: @@
 </code>
-==== Engine ====
+==== AppleScript OSA Command ====
 You can set the command line tool that is used to execute AppleScripts
@@ Line 201: / Line 201: @@
 </code>
-You can set the AppleScript name of the Safari application, as well as the name of the Safari browser shown in applications:
+==== Safari Browser Used in Actions & Tokens ====
+**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.
+You can Safari-based Browser targeted in Actions, etc, as well as the name of the Safari browser shown in applications:
 <code bash>
@@ Line 214: / Line 220: @@
 </code>
-Similarly for Google Chrome:
+==== Chrome Browser Used in Actions & Tokens ====
+**Change which Chrome-based Browser will be targeted by the various Keyboard Maestro "[[token:ChromeTitle|Chrome Related]]" Actions, Tokens, and Functions.**
+:!: Note:  By using the [[token:FrontBrowserTitle|FrontBrowser Related]] Tokens, Actions, and Functions, you may not need to change the below.  Just use these _FrontBrowser_ entities and whatever Browser is currently (or most recently) frontmost will be targeted.  This includes all Safari-based Browsers and Chrome-based Browsers.
 <code bash>
+# ~~~ For Brave Browser ~~~
+defaults write com.stairways.keyboardmaestro.engine AppleScriptGoogleChromeBundleID -string "com.brave.Browser"
+defaults write com.stairways.keyboardmaestro.engine BrowserGoogleChromeName -string "Brave Browser"
+# ~~~For Chrome Canary ~~~
 defaults write com.stairways.keyboardmaestro.engine AppleScriptGoogleChromeBundleID -string "com.google.Chrome.canary"
 defaults write com.stairways.keyboardmaestro.engine BrowserGoogleChromeName -string "Chrome Canary"
 </code>
-The AppleScript name is used in AppleScript's which control the respective browser in the form of CODE{{{tell app "<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.
+**To restore the defaults** back to use Google Chrome, just delete the preferences:
+<code bash>
+# ~~~ Restore to Google Chrome ~~~
+defaults delete com.stairways.keyboardmaestro.engine AppleScriptGoogleChromeBundleID
+defaults delete com.stairways.keyboardmaestro.engine BrowserGoogleChromeName
+</code>
+==== Engine Animation ====
 You can disable all animation in the engine with:
@@ Line 228: / Line 253: @@
 defaults write com.stairways.keyboardmaestro.engine DisableAnimation -bool YES
 </code>
+==== Typed String Buffer ====
 You can disable Shift-Space from clearing the Typed String buffer
 <code bash>
-defaults write com.stairways.keyboardmaestro.engine TypedStringResetWithShiftSpace -bool NO
+defaults write com.stairways.keyboardmaestro.engine TypedStringClearWithShiftSpace -bool NO
 </code>
@@ Line 246: / Line 273: @@
 defaults write com.stairways.keyboardmaestro.engine TypedStringClearTime -float 5.0
 </code>
+==== Use Unicode for Keystrokes ====
 You can force Keyboard Maestro to simulate keystrokes only as Unicode characters, rather than typing them as you would on the keyboard
@@ Line 252: / Line 281: @@
 defaults write com.stairways.keyboardmaestro.engine ForceInsertTextByTypingToUseUnicode -bool YES
 </code>
+==== Hot Key Triggers ====
 You can set the maximum key down trigger time for Hot Key triggers (default 10 seconds)
@@ Line 258: / Line 289: @@
 defaults write com.stairways.keyboardmaestro.engine MaxKeyRepeatTime -float 10.0
 </code>
+You can configure the timing of a "tap" (Hot Key and USB Device Key triggers) with:
+<code bash>
+defaults write com.stairways.keyboardmaestro.engine MaxTapDownTime -float 1.0
+defaults write com.stairways.keyboardmaestro.engine MaxTapUpTime -float 1.0
+</code>
+==== Sounds ====
 You can silence the clipboard transfer sounds with:
@@ Line 270: / Line 310: @@
 defaults write com.stairways.keyboardmaestro.engine SilenceRecordingSounds -bool YES
 </code>
+==== Recordings ====
 You can adjust the recording delay with:
@@ Line 279: / Line 321: @@
 Note: you can option click the Record button to avoid the delay.
-You can have the conflict palette use sequential hot keys from the first letter with:
+You can have all recorded clicks recorded in absolute coordinates by default with:
 <code bash>
-defaults write com.stairways.keyboardmaestro.engine SequentialConflictPalette -bool YES
+defaults write com.stairways.keyboardmaestro.engine AlwaysRecordAbsoluteClicks -bool YEA
 </code>
-You can configure the timing of a "tap" (Hot Key and USB Device Key triggers) with:
+By default, clicks are recorded relative to the front window, if that window has remained the front window and retained its size and position for some time.  Note that for a short time after recording, you can change the relative field in the action, and the values will update to appropriate values.
+==== Conflict Palette ====
+You can have the conflict palette use sequential hot keys from the first letter with:
 <code bash>
-defaults write com.stairways.keyboardmaestro.engine MaxTapDownTime -float 1.0
+defaults write com.stairways.keyboardmaestro.engine SequentialConflictPalette -bool YES
-defaults write com.stairways.keyboardmaestro.engine MaxTapUpTime -float 1.0
 </code>
@@ Line 313: / Line 358: @@
 defaults write com.stairways.keyboardmaestro.engine RecordedClickRestoresMouseLocation -bool NO
 </code>
+==== Notifications ====
 You can control which notifications are displayed with:
@@ Line 323: / Line 370: @@
 defaults write com.stairways.keyboardmaestro.engine "Notification-ReceivedClipboard" -bool YES
 </code>
+==== Software Updates ====
 You can have new versions reported only when the editor activates with:
@@ Line 329: / Line 378: @@
 defaults write com.stairways.keyboardmaestro.engine ReportUpdatesWhenEditorActivates -bool YES
 </code>
+==== WebKit Inspector for HTML Prompt ====
 You can enable the WebKit inspector with:

Keyboard Maestro Wiki

User Tools

Site Tools

Differences

Page Tools