Differences

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

--- manual:Preferences [2021/03/21 20:26]
peternlewis [Preferences Set by Command Line]
+++ manual:Preferences [2023/10/04 03:30]
peternlewis [Typed String Buffer]
@@ 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]].
-{{ preferencesgeneral.png?472 |Preferences General Pane }}
+{{ preferencesgeneral.png?522&nolink |Preferences General Pane }}
 The preferences are divided into sections.
@@ Line 15: / Line 15: @@
 * Show or hide the [[Applications_Palette|Applications Palette]].
 * configure whether to detect clipboards that resemble passwords and obscure them.
-* configure the light/dark appearance (v9.0+, OS X 10.14+).
+* configure the light/dark appearance (macOS 10.14+).
 * configure the default text size used in various places.
 * configure whether and how to show the status menu.
@@ Line 166: / Line 166: @@
 </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.
@@ Line 173: / Line 172: @@
 <code bash>
 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>
@@ Line 202: / Line 209: @@
 **Include Microsoft PDFs in Clipboards**
-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:**
+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 excludes PDF flavors from clipboards copied in Microsoft applications by default, but you can turn this off with:
 <code bash>
@@ Line 210: / Line 217: @@
 **Include Microsoft Image Formats**
-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:**
+Microsoft applications also include flavors for every possible image format with every copy.  Keyboard Maestro excludes secondary image flavors like BMP when there is a PNG or TIFF flavor available.  You can turn this off with:
 <code bash>
@@ Line 224: / Line 231: @@
 </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.**
@@ Line 242: / Line 249: @@
 defaults write com.stairways.keyboardmaestro.engine AppleScriptSafariName -string "com.apple.Safari"
 </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.**
@@ Line 267: / Line 272: @@
 </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 ====
@@ Line 277: / Line 303: @@
 </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>
@@ Line 285: / Line 311: @@
 </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>
@@ Line 291: / Line 317: @@
 </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>
 defaults write com.stairways.keyboardmaestro.engine TypedStringClearTime -float 5.0
 </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 ====
@@ Line 401: / Line 434: @@
 defaults write com.stairways.keyboardmaestro.engine ReportUpdatesWhenEditorActivates -bool YES
 </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 ====
@@ Line 422: / Line 466: @@
 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:
+Alternatively, you can specify the theme using JSON and including all the details for the theme including optional gradients.  The format is:
     {
@@ Line 461: / Line 505: @@
 	}'
-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.

Keyboard Maestro Wiki

User Tools

Site Tools

Differences

Page Tools