Differences

This shows you the differences between two versions of the page.

--- manual:Preferences [2019/06/25 00:44]
peternlewis
+++ manual:Preferences [2020/02/20 21:42]
peternlewis [Engine]
@@ Line 137: / Line 137: @@
 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 ====
@@ Line 146: / Line 162: @@
 </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>
-defaults write com.stairways.keyboardmaestro.engine MaxConcealedPosition -int 10
+defaults write com.stairways.keyboardmaestro.engine ClipboardFlavorMaximumSize -int 100000000
 </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>
-defaults write com.stairways.keyboardmaestro.engine ClipboardFlavorMaximumSize -int 100000000
+defaults write com.stairways.keyboardmaestro.engine MaxConcealedPosition -int 10
 </code>
@@ Line 163: / Line 179: @@
 defaults write com.stairways.keyboardmaestro.engine LooksLikePassword -string "^[a-zA-Z0-9]+$"
 defaults write com.stairways.keyboardmaestro.engine LooksLikeNotPassword -string "^[a-zA-Z0-9]+$"
+</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>
@@ Line 204: / Line 232: @@
 <code bash>
-defaults write com.stairways.keyboardmaestro.engine TypedStringResetWithShiftSpace -bool NO
+defaults write com.stairways.keyboardmaestro.engine TypedStringClearWithShiftSpace -bool NO
 </code>
@@ Line 217: / Line 245: @@
 <code bash>
 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>
@@ Line 273: / Line 307: @@
 defaults write com.stairways.keyboardmaestro.engine DisplayLargeTextDisplayPeriod -float 5.0
 </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:
@@ Line 312: / Line 338: @@
 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 for 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.

Keyboard Maestro Wiki

User Tools

Site Tools

Differences

Page Tools