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/25 00:17] peternlewis |
manual:Preferences [2019/06/30 22:22] peternlewis [Engine] |
||
---|---|---|---|
Line 138: | Line 138: | ||
</code> | </code> | ||
- | ==== Engine ==== | + | 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) | You can set the maximum number of items in the clipboard history (default 200) | ||
Line 146: | Line 162: | ||
</code> | </code> | ||
- | You can set the maximum position of concealed (password) items in the clipboard history (default 10) | + | You can set the maximum clipboard flavor size (default 100MB) |
<code bash> | <code bash> | ||
- | defaults write com.stairways.keyboardmaestro.engine MaxConcealedPosition -int 10 | + | defaults write com.stairways.keyboardmaestro.engine ClipboardFlavorMaximumSize -int 100000000 |
</code> | </code> | ||
- | You can set the maximum clipboard flavor size (default 100MB) | + | You can set the maximum position of concealed (password) items in the clipboard history (default 10) |
<code bash> | <code bash> | ||
- | defaults write com.stairways.keyboardmaestro.engine ClipboardFlavorMaximumSize -int 100000000 | + | defaults write com.stairways.keyboardmaestro.engine MaxConcealedPosition -int 10 |
</code> | </code> | ||
Line 164: | 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 215: | Line 247: | ||
<code bash> | <code bash> | ||
defaults write com.stairways.keyboardmaestro.engine TypedStringClearTime -float 5.0 | defaults write com.stairways.keyboardmaestro.engine TypedStringClearTime -float 5.0 | ||
+ | </code> | ||
+ | |||
+ | You can force Keyboard Maestro to simulate keystrokes only as Unicode characters, rather than typing them as you would on the keyboard | ||
+ | |||
+ | <code bash> | ||
+ | defaults write com.stairways.keyboardmaestro.engine ForceInsertTextByTypingToUseUnicode -bool YES | ||
</code> | </code> | ||
Line 271: | Line 309: | ||
defaults write com.stairways.keyboardmaestro.engine DisplayLargeTextDisplayPeriod -float 5.0 | defaults write com.stairways.keyboardmaestro.engine DisplayLargeTextDisplayPeriod -float 5.0 | ||
</code> | </code> | ||
- | |||
- | You can configure a custom palette theme color style with: | ||
- | |||
- | <code bash> | ||
- | defaults write com.stairways.keyboardmaestro.engine CustomPaletteTheme -string "0,90,74, 110,90,74, 256,90,74" | ||
- | </code> | ||
- | |||
- | 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. | ||
By default recorded clicks do not restore the mouse location, but you can change that with: | By default recorded clicks do not restore the mouse location, but you can change that with: | ||
Line 309: | Line 339: | ||
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 === | ||
+ | |||
+ | You can configure a custom palette theme color style with: | ||
+ | |||
+ | <code bash> | ||
+ | defaults write com.stairways.keyboardmaestro.engine CustomPaletteTheme -string "0,90,74, 110,90,74, 256,90,74" | ||
+ | </code> | ||
+ | |||
+ | 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: | ||
+ | |||
+ | { | ||
+ | "ExcludeTexture":<BOOLEAN>, | ||
+ | "TitleBackground":<COLORorGRADIENT>, | ||
+ | "TitleBorder":<COLORorGRADIENT>, | ||
+ | "BodyBackground":<COLORorGRADIENT>, | ||
+ | "BodyBackgroundSelected":<COLORorGRADIENT>, | ||
+ | "Frame":<COLOR>, | ||
+ | "TitleText":<COLOR>, | ||
+ | "Text":<COLOR>, | ||
+ | "TextHighlighted":<COLOR>, | ||
+ | "TextSelected":<COLOR>, | ||
+ | "TextSelectedHighlighted":<COLOR>, | ||
+ | } | ||