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 [2021/10/04 04:40] peternlewis |
manual:Preferences [2023/10/04 03:38] peternlewis |
||
---|---|---|---|
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 142: | Line 142: | ||
<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 166: | Line 167: | ||
</code> | </code> | ||
- | :!: **Alert**: You should **never** set the max number of items to zero.\\ | ||
If you set the max number of items to zero, then the Copy action will fail. | If you set the max number of items to zero, then the Copy action will fail. | ||
Line 173: | Line 173: | ||
<code bash> | <code bash> | ||
defaults write com.stairways.keyboardmaestro.engine ClipboardFlavorMaximumSize -int 100000000 | defaults write com.stairways.keyboardmaestro.engine ClipboardFlavorMaximumSize -int 100000000 | ||
+ | </code> | ||
+ | |||
+ | **Multiple Clipboard Separator** (default Return) | ||
+ | |||
+ | The separator added if you paste multiple items from the Clipboard Switcher can be configured in the gear menu or set to something else with the command: | ||
+ | |||
+ | <code bash> | ||
+ | defaults write com.stairways.keyboardmaestro.engine MultipleClipboardSeparator " and " | ||
</code> | </code> | ||
Line 224: | Line 232: | ||
</code> | </code> | ||
- | ==== Safari Browser Used in Actions & Tokens ==== | + | ==== Browser Used in Actions & Tokens ==== |
**Change which Safari-based Browser will be targeted by the "Safari" Actions, Tokens, and Functions.** | **Change which Safari-based Browser will be targeted by the "Safari" Actions, Tokens, and Functions.** | ||
Line 242: | Line 250: | ||
defaults write com.stairways.keyboardmaestro.engine AppleScriptSafariName -string "com.apple.Safari" | defaults write com.stairways.keyboardmaestro.engine AppleScriptSafariName -string "com.apple.Safari" | ||
</code> | </code> | ||
- | |||
- | ==== Chrome Browser Used in Actions & Tokens ==== | ||
**Change which Chrome-based Browser will be targeted by the various Keyboard Maestro "[[token:ChromeTitle|Chrome Related]]" Actions, Tokens, and Functions.** | **Change which Chrome-based Browser will be targeted by the various Keyboard Maestro "[[token:ChromeTitle|Chrome Related]]" Actions, Tokens, and Functions.** | ||
Line 267: | Line 273: | ||
</code> | </code> | ||
+ | **Add additional Browsers to the Front Browser Actions, Tokens, and Functions.** | ||
+ | The current list of browsers supported in Keyboard Maestro as a potential front browser include: | ||
+ | |||
+ | * com.apple.Safari | ||
+ | * com.apple.SafariTechnologyPreview | ||
+ | * com.google.Chrome | ||
+ | * com.google.Chrome.canary | ||
+ | * com.brave.Browser | ||
+ | * com.brave.Browser.beta | ||
+ | * com.vivaldi.Vivaldi | ||
+ | * com.microsoft.edgemac | ||
+ | |||
+ | Plus whatever browser is specified as the Safari or GoogleChrome above. | ||
+ | |||
+ | You can add additional browsers supported as the Front Browser by including their bundle IDs in the `AdditionalWebBrowserBundleIDs` preference. You can list as many as you like, separated by spaces or commas. | ||
+ | |||
+ | <code bash> | ||
+ | defaults write com.stairways.keyboardmaestro.engine AdditionalWebBrowserBundleIDs -string "com.example.Safari,com.example.Chrome" | ||
+ | </code> | ||
+ | |||
+ | :!: Note: if the bundle ID includes “safari”, it is considered a Safari browser, otherwise it is considered a Chrome-based browser. | ||
==== Engine Animation ==== | ==== Engine Animation ==== | ||
Line 277: | Line 304: | ||
</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 285: | Line 312: | ||
</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 291: | Line 318: | ||
</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 401: | Line 435: | ||
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 461: | Line 506: | ||
}' | }' | ||
- | 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. |