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/06/20 22:35]
peternlewis [Variables Preferences]
manual:Preferences [2019/06/25 03:11]
peternlewis [Editor]
Line 73: Line 73:
  
 You can paste an image into a Named~~Clipboard by selecting it in the list and pasting an image (if you select part of the text, it will paste the image into the styled text, which works but is probably not what you want). You can paste an image into a Named~~Clipboard by selecting it in the list and pasting an image (if you select part of the text, it will paste the image into the styled text, which works but is probably not what you want).
 +
 +You can also inspect variables and other values in the [[Windows#​Value_Inspector_Window |Value Inspector]].
  
 ===== Variables Preferences ===== ===== Variables Preferences =====
Line 79: Line 81:
  
 You do not need to create variables, just using them and giving them a value is all that is required for them to spring into existence. ​ You can also inspect variables and other values in the [[Windows#​Value_Inspector_Window |Value Inspector]]. You do not need to create variables, just using them and giving them a value is all that is required for them to spring into existence. ​ You can also inspect variables and other values in the [[Windows#​Value_Inspector_Window |Value Inspector]].
 +
 ===== Excluded Preferences ===== ===== Excluded Preferences =====
  
Line 91: Line 94:
 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.
  
-You can set the maximum number of items in the clipboard history (default 200)+==== Editor ==== 
 + 
 +You can adjust ​the get mouse location delay with:
  
 <code bash> <code bash>
-defaults write com.stairways.keyboardmaestro.engine MaxClipboardHistory ​-int 200+defaults write com.stairways.keyboardmaestro.editor MouseGetCountdown ​-int 5
 </​code>​ </​code>​
  
-You can set the maximum position ​of concealed (password) items in the clipboard history (default 10)+You can adjust ​the spelling ​of Favorites with:
  
 <code bash> <code bash>
-defaults write com.stairways.keyboardmaestro.engine MaxConcealedPosition ​-int 10+defaults write com.stairways.keyboardmaestro.editor FavoritesDisplayName -string "​Favourites"​ 
 +</​code>​ 
 + 
 +You can turn off automatic completion (autocomplete) with: 
 + 
 +<code bash> 
 +defaults write com.stairways.keyboardmaestro.editor AutomaticCompletion -bool NO 
 +</​code>​ 
 + 
 +You can limit the maximum undo stack size in the editor with (default 200MB): 
 + 
 +<code bash> 
 +defaults write com.stairways.keyboardmaestro.editor MaximumUndoSize ​-int 200000000 
 +</​code>​ 
 + 
 +You can add some custom styling to the detail view displays with: 
 + 
 +<code bash> 
 +defaults write com.stairways.keyboardmaestro.editor DetailDisplayExtraStyle -string '​div.ActionComment div.UserText { font-family:"​Monaco";​ }' 
 +</​code>​ 
 + 
 +You can set your preferred first day of the week (1=Sunday, 7=Saturday):​ 
 + 
 +<code bash> 
 +defaults write com.stairways.keyboardmaestro.editor FirstDayOfWeek -int 2 
 +</​code>​ 
 + 
 +You can disable all animation in the editor with: 
 + 
 +<code bash> 
 +defaults write com.stairways.keyboardmaestro.editor DisableAnimation -bool YES 
 +</​code>​ 
 + 
 +You can configure the fonts used for the various action text views with: 
 + 
 +<code bash> 
 +defaults write com.stairways.keyboardmaestro.editor Font-Normal -string "​Monaco"​ 
 +defaults write com.stairways.keyboardmaestro.editor Font-Shell -string "​USER"​ 
 +defaults write com.stairways.keyboardmaestro.editor Font-AppleScript -string "​FIXED"​ 
 +defaults write com.stairways.keyboardmaestro.editor Font-JavaScript -string "​SYSTEM"​ 
 +defaults write com.stairways.keyboardmaestro.editor Font-Swift -string "​Times"​ 
 +defaults write com.stairways.keyboardmaestro.editor Font-HTML -string "​Courier:​25"​ 
 +defaults write com.stairways.keyboardmaestro.editor Font-JSON -string "​Marker Felt:10
 +defaults write com.stairways.keyboardmaestro.editor Font-Comment -string "​Palatino:​20"​ 
 +</​code>​ 
 + 
 +The value of this field can be one of “USER”, “FIXED” or “SYSTEM” (for the default user, fixed and system fonts), or a font name.  This can optionally be followed by a colon and the point size.  The default point size is 13.  The font size is scaled based on the Large Text setting, and this size is used for the //Normal// setting. 
 + 
 + 
 +==== Clipboard ==== 
 + 
 +You can set the maximum number of items in the clipboard history (default 200) 
 + 
 +<code bash> 
 +defaults write com.stairways.keyboardmaestro.engine MaxClipboardHistory -int 200
 </​code>​ </​code>​
  
Line 107: Line 166:
 <code bash> <code bash>
 defaults write com.stairways.keyboardmaestro.engine ClipboardFlavorMaximumSize -int 100000000 defaults write com.stairways.keyboardmaestro.engine ClipboardFlavorMaximumSize -int 100000000
 +</​code>​
 +
 +You can set the maximum position of concealed (password) items in the clipboard history (default 10)
 +
 +<code bash>
 +defaults write com.stairways.keyboardmaestro.engine MaxConcealedPosition -int 10
 </​code>​ </​code>​
  
Line 115: Line 180:
 defaults write com.stairways.keyboardmaestro.engine LooksLikeNotPassword -string "​^[a-zA-Z0-9]+$"​ defaults write com.stairways.keyboardmaestro.engine LooksLikeNotPassword -string "​^[a-zA-Z0-9]+$"​
 </​code>​ </​code>​
 +
 +Microsoft applications include a PDF flavor with every copy, and starting up the PDF rendering engine is slow, making the first copy after launching a Microsoft application. ​ Keyboard Maestro (v9.0+) excludes PDF flavors from clipboards copied in Microsoft applications by default, but you can turn this off with:
 +
 +<code bash>
 +defaults write com.stairways.keyboardmaestro.engine ExcludeMicrosoftPDFFlavor -bool NO
 +</​code>​
 +
 +Microsoft applications also include flavors for every possible image format with every copy.  Keyboard Maestro (v9.0+) excludes secondary image flavors like BMP when there is a PNG or TIFF flavor available. ​ You can turn this off with:
 +
 +<code bash>
 +defaults write com.stairways.keyboardmaestro.engine ExcludeMultipleImageFlavors -bool NO
 +</​code>​
 +
 +
 +
 +==== 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 143: Line 224:
  
 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.
 +
 +You can disable all animation in the engine with:
 +
 +<code bash>
 +defaults write com.stairways.keyboardmaestro.engine DisableAnimation -bool YES
 +</​code>​
  
 You can disable Shift-Space from clearing the Typed String buffer You can disable Shift-Space from clearing the Typed String buffer
Line 162: Line 249:
 </​code>​ </​code>​
  
-You can set the maximum key down trigger time for Hot Key triggers (default 10 seconds)+You can force Keyboard Maestro to simulate keystrokes only as Unicode characters, rather than typing them as you would on the keyboard
  
 <code bash> <code bash>
-defaults write com.stairways.keyboardmaestro.engine ​MaxKeyRepeatTime ​-float 10.0+defaults write com.stairways.keyboardmaestro.engine ​ForceInsertTextByTypingToUseUnicode ​-bool YES
 </​code>​ </​code>​
  
-You can disable all animation in the editor with:+You can set the maximum key down trigger time for Hot Key triggers (default 10 seconds)
  
 <code bash> <code bash>
-defaults write com.stairways.keyboardmaestro.editor DisableAnimation ​-bool YES +defaults write com.stairways.keyboardmaestro.engine MaxKeyRepeatTime ​-float 10.0
-</​code>​ +
- +
-or the engine with: +
- +
-<code bash> +
-defaults write com.stairways.keyboardmaestro.engine DisableAnimation -bool YES+
 </​code>​ </​code>​
  
Line 199: Line 280:
  
 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 adjust the get mouse location delay with: 
- 
-<code bash> 
-defaults write com.stairways.keyboardmaestro.editor MouseGetCountdown -int 5 
-</​code>​ 
  
 You can have the conflict palette use sequential hot keys from the first letter with: You can have the conflict palette use sequential hot keys from the first letter with:
Line 263: Line 338:
 <code bash> <code bash>
 defaults write com.stairways.keyboardmaestro.engine ReportUpdatesWhenEditorActivates -bool YES defaults write com.stairways.keyboardmaestro.engine ReportUpdatesWhenEditorActivates -bool YES
-</​code>​ 
- 
-You can adjust the spelling of Favorites with: 
- 
-<code bash> 
-defaults write com.stairways.keyboardmaestro.editor FavoritesDisplayName -string "​Favourites"​ 
-</​code>​ 
- 
-You can turn off automatic completion (autocomplete) with: 
- 
-<code bash> 
-defaults write com.stairways.keyboardmaestro.editor AutomaticCompletion -bool NO 
-</​code>​ 
- 
-You can limit the maximum undo stack size in the editor with (default 200MB): 
- 
-<code bash> 
-defaults write com.stairways.keyboardmaestro.editor MaximumUndoSize -int 200000000 
-</​code>​ 
- 
-You can add some custom styling to the detail view displays with: 
- 
-<code bash> 
-defaults write com.stairways.keyboardmaestro.editor DetailDisplayExtraStyle -string '​div.ActionComment div.UserText { font-family:"​Monaco";​ }' 
-</​code>​ 
- 
-You can set your preferred first day of the week (1=Sunday, 7=Saturday):​ 
- 
-<code bash> 
-defaults write com.stairways.keyboardmaestro.editor FirstDayOfWeek -int 2 
 </​code>​ </​code>​
  
Line 302: Line 347:
  
 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.
 +
manual/Preferences.txt · Last modified: 2024/05/27 21:26 by peternlewis