Differences

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

--- manual:Preferences [2020/10/23 02:11]
peternlewis Ignored Clipboard Flavors
+++ manual:Preferences [2021/10/04 04:40]
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]].
-{{ 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 92: / Line 92: @@
 ===== Preferences Set by Command Line =====
-You can configure various preferences using defaults write from the Mac OS X Terminal.  Some preferences will take effect immediately, but others may require the editor or engine to be relaunched.
+You can configure various preferences using defaults write from the Mac OS X Terminal.  Some preferences will take effect immediately, but others may require the editor or engine to be relaunched. These preferences are documented here only to provide utility. Their behaviour may change in the future, or have unexpected consequences.
 ==== Editor ====
@@ Line 165: / Line 165: @@
 defaults write com.stairways.keyboardmaestro.engine MaxClipboardHistory -int 200
 </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.
 **Maximum Clipboard Flavor Size** (default 100MB)
@@ Line 199: / Line 202: @@
 **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 207: / Line 210: @@
 **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 419: / Line 422: @@
 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:
     {

Keyboard Maestro Wiki

User Tools

Site Tools

Differences

Page Tools