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/25 02:56]
peternlewis
manual:Preferences [2020/02/20 21:42]
peternlewis [Engine]
Line 137: Line 137:
 defaults write com.stairways.keyboardmaestro.editor DisableAnimation -bool YES defaults write com.stairways.keyboardmaestro.editor DisableAnimation -bool YES
 </​code>​ </​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 ==== ==== Clipboard ====
Line 176: Line 192:
 defaults write com.stairways.keyboardmaestro.engine ExcludeMultipleImageFlavors -bool NO defaults write com.stairways.keyboardmaestro.engine ExcludeMultipleImageFlavors -bool NO
 </​code>​ </​code>​
- 
- 
  
 ==== Engine ==== ==== Engine ====
Line 218: Line 232:
  
 <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 293: 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 332: 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 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.
manual/Preferences.txt · Last modified: 2023/11/07 00:14 by peternlewis