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/08/13 20:58] peternlewis |
||
---|---|---|---|
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 245: | ||
<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 307: | ||
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 310: | Line 338: | ||
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: | ||
+ | |||
+ | { | ||
+ | "IncludeTexture":<BOOLEAN>, | ||
+ | "TitleBackground":<COLORorGRADIENT>, | ||
+ | "TitleBorder":<COLORorGRADIENT>, | ||
+ | "BodyBackground":<COLORorGRADIENT>, | ||
+ | "BodyBackgroundSelected":<COLORorGRADIENT>, | ||
+ | "Frame":<COLOR>, | ||
+ | "TitleText":<COLOR>, | ||
+ | "Text":<COLOR>, | ||
+ | "TextHighlighted":<COLOR>, | ||
+ | "TextSelected":<COLOR>, | ||
+ | "TextSelectedHighlighted":<COLOR>, | ||
+ | } | ||
+ | |||
+ | ^ Type ^ Value ^ | ||
+ | | <BOOLEAN> | “true” or “false” | | ||
+ | | <COLOR> | an array of three numbers, being hue (0-360), saturation (0-100), and brightness (0-100) | | ||
+ | | <COLORorGRADIENT> | either a <COLOR> or a dictionary {"c1":<COLOR>, "c2":<COLOR>, "angle":<0-360>} | | ||
+ | |||
+ | IncludeTexture specifies whether Keyboard Maestro includes the subtle mottling texture on the main background. | ||
+ | |||
+ | For example: | ||
+ | |||
+ | defaults write com.stairways.keyboardmaestro.engine CustomPaletteTheme -string '{ | ||
+ | "IncludeTexture":false, | ||
+ | "TitleBackground":{"c1" : [180,30,53], "c2" : [180,30,40], "angle":270}, | ||
+ | "TitleBorder":[180,30,40], | ||
+ | "BodyBackground":{"c1" : [180,30,50], "c2" : [180,30,38], "angle":270}, | ||
+ | "BodyBackgroundSelected":[180,30,60], | ||
+ | "Frame":[180,30,40], | ||
+ | "TitleText":[180,40,92], | ||
+ | "Text":[180,40,92], | ||
+ | "TextHighlighted":[180,40,70], | ||
+ | "TextSelected":[180,40,98], | ||
+ | "TextSelectedHighlighted":[180,40,75], | ||
+ | }' | ||
+ | |||
+ | NoteL the “-string” is important - otherwise the `defaults` command will interpret the JSON itself and that will not work. |