This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision Next revision Both sides next revision | ||
manual:Preferences [2019/06/30 22:41] peternlewis [Engine] |
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. | 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. | 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> | </code> | ||
- | + | ==== AppleScript OSA Command ==== | |
- | + | ||
- | ==== Engine ==== | + | |
You can set the command line tool that is used to execute AppleScripts | You can set the command line tool that is used to execute AppleScripts | ||
Line 203: | Line 201: | ||
</code> | </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> | <code bash> | ||
Line 216: | Line 220: | ||
</code> | </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> | <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 AppleScriptGoogleChromeBundleID -string "com.google.Chrome.canary" | ||
defaults write com.stairways.keyboardmaestro.engine BrowserGoogleChromeName -string "Chrome Canary" | defaults write com.stairways.keyboardmaestro.engine BrowserGoogleChromeName -string "Chrome Canary" | ||
</code> | </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: | You can disable all animation in the engine with: | ||
Line 230: | Line 253: | ||
defaults write com.stairways.keyboardmaestro.engine DisableAnimation -bool YES | defaults write com.stairways.keyboardmaestro.engine DisableAnimation -bool YES | ||
</code> | </code> | ||
+ | |||
+ | ==== Typed String Buffer ==== | ||
You can disable Shift-Space from clearing the Typed String buffer | You can disable Shift-Space from clearing the Typed String buffer | ||
<code bash> | <code bash> | ||
- | defaults write com.stairways.keyboardmaestro.engine TypedStringResetWithShiftSpace -bool NO | + | defaults write com.stairways.keyboardmaestro.engine TypedStringClearWithShiftSpace -bool NO |
</code> | </code> | ||
Line 248: | Line 273: | ||
defaults write com.stairways.keyboardmaestro.engine TypedStringClearTime -float 5.0 | defaults write com.stairways.keyboardmaestro.engine TypedStringClearTime -float 5.0 | ||
</code> | </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 | You can force Keyboard Maestro to simulate keystrokes only as Unicode characters, rather than typing them as you would on the keyboard | ||
Line 254: | Line 281: | ||
defaults write com.stairways.keyboardmaestro.engine ForceInsertTextByTypingToUseUnicode -bool YES | defaults write com.stairways.keyboardmaestro.engine ForceInsertTextByTypingToUseUnicode -bool YES | ||
</code> | </code> | ||
+ | |||
+ | ==== Hot Key Triggers ==== | ||
You can set the maximum key down trigger time for Hot Key triggers (default 10 seconds) | You can set the maximum key down trigger time for Hot Key triggers (default 10 seconds) | ||
Line 260: | Line 289: | ||
defaults write com.stairways.keyboardmaestro.engine MaxKeyRepeatTime -float 10.0 | defaults write com.stairways.keyboardmaestro.engine MaxKeyRepeatTime -float 10.0 | ||
</code> | </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: | You can silence the clipboard transfer sounds with: | ||
Line 272: | Line 310: | ||
defaults write com.stairways.keyboardmaestro.engine SilenceRecordingSounds -bool YES | defaults write com.stairways.keyboardmaestro.engine SilenceRecordingSounds -bool YES | ||
</code> | </code> | ||
+ | |||
+ | ==== Recordings ==== | ||
You can adjust the recording delay with: | You can adjust the recording delay with: | ||
Line 281: | Line 321: | ||
Note: you can option click the Record button to avoid the delay. | 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> | <code bash> | ||
- | defaults write com.stairways.keyboardmaestro.engine SequentialConflictPalette -bool YES | + | defaults write com.stairways.keyboardmaestro.engine AlwaysRecordAbsoluteClicks -bool YEA |
</code> | </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> | <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> | </code> | ||
Line 315: | Line 358: | ||
defaults write com.stairways.keyboardmaestro.engine RecordedClickRestoresMouseLocation -bool NO | defaults write com.stairways.keyboardmaestro.engine RecordedClickRestoresMouseLocation -bool NO | ||
</code> | </code> | ||
+ | |||
+ | ==== Notifications ==== | ||
You can control which notifications are displayed with: | You can control which notifications are displayed with: | ||
Line 325: | Line 370: | ||
defaults write com.stairways.keyboardmaestro.engine "Notification-ReceivedClipboard" -bool YES | defaults write com.stairways.keyboardmaestro.engine "Notification-ReceivedClipboard" -bool YES | ||
</code> | </code> | ||
+ | |||
+ | ==== Software Updates ==== | ||
You can have new versions reported only when the editor activates with: | You can have new versions reported only when the editor activates with: | ||
Line 331: | Line 378: | ||
defaults write com.stairways.keyboardmaestro.engine ReportUpdatesWhenEditorActivates -bool YES | defaults write com.stairways.keyboardmaestro.engine ReportUpdatesWhenEditorActivates -bool YES | ||
</code> | </code> | ||
+ | |||
+ | ==== WebKit Inspector for HTML Prompt ==== | ||
You can enable the WebKit inspector with: | You can enable the WebKit inspector with: | ||
Line 340: | Line 389: | ||
Then you can control-click on elements and use Inspect Element and get an inspector window, including a Console tab. | Then you can control-click on elements and use Inspect Element and get an inspector window, including a Console tab. | ||
- | === Custom Palette Theme === | + | ==== Custom Palette Theme ==== |
You can configure a custom palette theme color style with: | You can configure a custom palette theme color style with: | ||
Line 350: | Line 399: | ||
The style includes 3 or 6 HSB colors (being background, text, highlighted letter, selected background, selected text, selected highlight letter) each specified as hue,saturation,brightness. The background brightness is dropped by 33%, but if there are only three colors, then the selected background color is the background without the 33% drop. You can select the Custom style in the Theme Editor. | The style includes 3 or 6 HSB colors (being background, text, highlighted letter, selected background, selected text, selected highlight letter) each specified as hue,saturation,brightness. The background brightness is dropped by 33%, but if there are only three colors, then the selected background color is the background without the 33% drop. You can select the Custom style in the Theme Editor. | ||
- | Alternatively (v9.0+), you can specify the theme using JSON and including all the details fo the theme including optional gradients. The format is: | + | Alternatively (v9.0+), you can specify the theme using JSON and including all the details for the theme including optional gradients. The format is: |
{ | { |