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 [2020/08/17 21:53]
JMichaelTX [Chrome Browser Used in Actions & Tokens]
manual:Preferences [2021/03/21 20:26]
peternlewis [Preferences Set by Command Line]
Line 92: Line 92:
 ===== Preferences Set by Command Line ===== ===== 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 ==== ==== Editor ====
Line 156: Line 156:
 ==== Clipboard ==== ==== Clipboard ====
  
-You can set the maximum number of items in the clipboard history ​(default 200)+If you wish to effectively disable the Keyboard Maestro Clipboard History, you can do so by setting the history size to zero, and then Keyboard Maestro will only read the clipboard when you explicitly ask it to use the clipboard. 
 + 
 +You can set the following preferences for the Clipboard History 
 + 
 +**Maximum Number of Items** ​(default 200)
  
 <code bash> <code bash>
Line 162: Line 166:
 </​code>​ </​code>​
  
-You can set the maximum clipboard flavor size (default 100MB)+:!: **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)
  
 <code bash> <code bash>
Line 168: Line 175:
 </​code>​ </​code>​
  
-You can set the maximum position ​of concealed ​(passworditems in the clipboard ​history ​(default 10)+**Ignored Clipboard Flavors** 
 + 
 +You can add additional clipboard flavors to be ignored using: 
 + 
 +<code bash> 
 +defaults write com.stairways.keyboardmaestro.engine ExtraIgnoredClipboardFlavors "​com.whatever.badflavor"​ 
 +</​code>​ 
 + 
 +The string should be a bar (`|`) separated list of flavors ​(technically a regular expression). These flavors will be excluded from the clipboard ​when Keyboard Maestro reads the clipboard. 
 + 
 +You can also write to `IgnoredClipboardFlavors`,​ which will set the entire list of ignored clipboard flavors, but that is a bad idea since the flavors that are ignored, are ignored for a reason, and overwriting the list will produce negative results. 
 + 
 +**Maximum Position of Concealed (Password) Items** ​(default 10)
  
 <code bash> <code bash>
Line 174: Line 193:
 </​code>​ </​code>​
  
-You can set a regular expression which matches text you think should ​or should not be concealed ​as passwords.+**Regular Expression Which Matches Text You Think Should ​or Should Not Be Concealed ​as Passwords**
  
 <code bash> <code bash>
Line 181: Line 200:
 </​code>​ </​code>​
  
-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:+**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:**
  
 <code bash> <code bash>
Line 187: Line 208:
 </​code>​ </​code>​
  
-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:+**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:**
  
 <code bash> <code bash>
manual/Preferences.txt · Last modified: 2023/11/07 00:14 by peternlewis