User Tools

Site Tools


manual:Preferences

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:Preferences [2019/08/13 20:58]
peternlewis
manual:Preferences [2020/08/17 21:11]
JMichaelTX [Engine] ADD commands to restore Google Chrome. Add TOC
Line 193: Line 193:
 </​code>​ </​code>​
  
-==== Engine ​====+==== AppleScript ​====
  
 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 200: Line 200:
 defaults write com.stairways.keyboardmaestro.engine OSAScriptCommand -string "/​usr/​bin/​arch -i386 /​usr/​bin/​osascript"​ defaults write com.stairways.keyboardmaestro.engine OSAScriptCommand -string "/​usr/​bin/​arch -i386 /​usr/​bin/​osascript"​
 </​code>​ </​code>​
 +
 +==== Safari Browser Used in Actions & Tokens ====
  
 You can set the AppleScript name of the Safari application,​ as well as the name of the Safari browser shown in applications:​ You can set the AppleScript name of the Safari application,​ as well as the name of the Safari browser shown in applications:​
Line 214: Line 216:
 </​code>​ </​code>​
  
-Similarly for Google ​Chrome:+==== Chrome ​Browser Used in Actions & Tokens ====
  
 <code bash> <code bash>
 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>​
 +
 +To restore the defaults back to use Google Chrome, just delete the preferences:​
 +
 +<code bash>
 +defaults delete com.stairways.keyboardmaestro.engine AppleScriptGoogleChromeBundleID
 +defaults delete com.stairways.keyboardmaestro.engine BrowserGoogleChromeName
 </​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. 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.
 +
 +==== Engine Animation ====
  
 You can disable all animation in the engine with: You can disable all animation in the engine with:
Line 228: Line 239:
 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 246: Line 259:
 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 252: Line 267:
 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 258: Line 275:
 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 270: Line 296:
 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 279: Line 307:
 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 "​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 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 313: Line 344:
 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 323: Line 356:
 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 329: Line 364:
 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 348: Line 385:
 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:
  
     {      { 
manual/Preferences.txt · Last modified: 2023/11/07 00:14 by peternlewis