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
manual:Preferences [2022/04/13 23:18]
peternlewis
manual:Preferences [2023/10/16 03:21] (current)
peternlewis [General Preferences]
Line 3: Line 3:
 To configure Keyboard~~Maestro,​ first launch Keyboard~~Maestro and choose [[Menus#​Keyboard_Maestro_Preferences|Preferences]] from the [[Menus#​Keyboard_Maestro|Keyboard Maestro menu]]. To configure Keyboard~~Maestro,​ first launch Keyboard~~Maestro and choose [[Menus#​Keyboard_Maestro_Preferences|Preferences]] from the [[Menus#​Keyboard_Maestro|Keyboard Maestro menu]].
  
-{{ preferencesgeneral.png?​522&nolink |Preferences General Pane }}+{{ preferencesgeneral.png?​nolink&​582x641 ​| Preferences General Pane }}
  
 The preferences are divided into sections. The preferences are divided into sections.
Line 19: Line 19:
 * configure whether and how to show the status menu. * configure whether and how to show the status menu.
 * configure the style of the status menu. * configure the style of the status menu.
 +* configure whether to include macro icons in the status menu.
 * configure whether to include pasting clipboards in the status menu. * configure whether to include pasting clipboards in the status menu.
 * configure whether to include applications in the status menu. * configure whether to include applications in the status menu.
Line 73: Line 74:
  
 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 80: Line 79:
 In the [[Windows#​Preferences_Variables_Pane|Variables preference pane]] you can add and remove variables and see and change their values. In the [[Windows#​Preferences_Variables_Pane|Variables preference pane]] you can add and remove variables and see and change their values.
  
-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 89: Line 90:
  
 You can also add and remove applications from the clipboard history exclusion list.  When an excluded application is at the front, Keyboard Maestro will not automatically record the clipboard history each time it changes. ​ It will still read the current System Clipboard if you explicitly ask for it in a macro or open the Clipboard History Switcher. You can also add and remove applications from the clipboard history exclusion list.  When an excluded application is at the front, Keyboard Maestro will not automatically record the clipboard history each time it changes. ​ It will still read the current System Clipboard if you explicitly ask for it in a macro or open the Clipboard History Switcher.
 +
 +===== Security Preferences =====
 +
 +Keyboard Maestro is designed to act on your behave and to do many things for you - essentially acting as you in performing tasks. As such, it needs a wide variety of security permissions to perform these tasks.
 +
 +This preference panel aims to summarise the important preferences and allow you to explicitly request them as needed.
  
 ===== Preferences Set by Command Line ===== ===== Preferences Set by Command Line =====
Line 142: Line 149:
 <code bash> <code bash>
 defaults write com.stairways.keyboardmaestro.editor Font-Normal -string "​Monaco"​ defaults write com.stairways.keyboardmaestro.editor Font-Normal -string "​Monaco"​
 +defaults write com.stairways.keyboardmaestro.editor Font-Fixed -string "​Monaco"​
 defaults write com.stairways.keyboardmaestro.editor Font-Shell -string "​USER"​ 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-AppleScript -string "​FIXED"​
Line 283: Line 291:
 * com.brave.Browser.beta * com.brave.Browser.beta
 * com.vivaldi.Vivaldi * com.vivaldi.Vivaldi
 +* com.vivaldi.Vivaldi.snapshot
 * com.microsoft.edgemac * com.microsoft.edgemac
  
Line 303: Line 312:
 </​code>​ </​code>​
  
-==== Typed String ​Buffer ​====+==== Typed String ====
  
-You can disable Shift-Space from clearing the Typed String buffer+You can disable Shift-Space from clearing the Typed String buffer ​with:
  
 <code bash> <code bash>
Line 311: Line 320:
 </​code>​ </​code>​
  
-and you can disable clicks from clearing the Typed String buffer+and you can disable clicks from clearing the Typed String buffer ​with:
  
 <code bash> <code bash>
Line 317: Line 326:
 </​code>​ </​code>​
  
-and you can set the idle time for clearing the Typed String buffer (default 5 seconds)+and you can set the idle time for clearing the Typed String buffer (default 5 seconds) ​with:
  
 <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>​ </​code>​
 +
 +You can disable modifiers taps in the Typed String buffer with:
 +
 +<code bash>
 +defaults write com.stairways.keyboardmaestro.engine AllowModifiersInTypedStrings -bool NO
 +</​code>​
 +
  
 ==== Use Unicode for Keystrokes ==== ==== Use Unicode for Keystrokes ====
Line 427: Line 443:
 defaults write com.stairways.keyboardmaestro.engine ReportUpdatesWhenEditorActivates -bool YES defaults write com.stairways.keyboardmaestro.engine ReportUpdatesWhenEditorActivates -bool YES
 </​code>​ </​code>​
 +
 +==== Prompt With List Show All Limit ====
 +
 +
 +You can set the limit for the maximum number of items shown by default in the [[action:​Prompt_With_List|Prompt With List]] action with:
 +
 +<code bash>
 +defaults write com.stairways.keyboardmaestro.engine PromptWithListShowAllLimit -int 100
 +</​code>​
 +
 +When there is more items than this in the list, by default the action will not show the items as the list may be too long to be practical.
  
 ==== WebKit Inspector for HTML Prompt ==== ==== WebKit Inspector for HTML Prompt ====
Line 487: Line 514:
  }'  }'
  
-NoteL the “-string” is important - otherwise the `defaults` command will interpret the JSON itself and that will not work.+Note that the “-string” is important - otherwise the `defaults` command will interpret the JSON itself and that will not work.
manual/Preferences.1649906310.txt.gz · Last modified: 2022/04/13 23:18 by peternlewis