User Tools

Site Tools


Clipboards

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
Clipboards [2017/09/04 04:24]
peternlewis [Display History]
Clipboards [2018/07/25 19:32]
JMichaelTX [System Clipboard] Add section on Pause Until
Line 9: Line 9:
   * **Past Clipboards** — Prior Versions of the *System Clipboard* stored in the Keyboard Maestro [[#​Clipboard_History]]   * **Past Clipboards** — Prior Versions of the *System Clipboard* stored in the Keyboard Maestro [[#​Clipboard_History]]
   * **Trigger Clipboard** — The clipboard referenced by a [[trigger:​Clipboard Filter]] menu selection (or the System Clipboard otherwise).   * **Trigger Clipboard** — The clipboard referenced by a [[trigger:​Clipboard Filter]] menu selection (or the System Clipboard otherwise).
 +
 ===== System Clipboard ===== ===== System Clipboard =====
  
-The System Clipboard is the clipboard that you will use and work with the most.\\+The System Clipboard is the clipboard that you will use and work with the most.
  
 (!) Keep in mind that **the System Clipboard is involved in all operations (Actions)** that transfer data between the user interface (documents, menus, web pages,etc) and Keyboard Maestro. (!) Keep in mind that **the System Clipboard is involved in all operations (Actions)** that transfer data between the user interface (documents, menus, web pages,etc) and Keyboard Maestro.
Line 20: Line 21:
   * [[action:​Paste_from_Named_Clipboard]]   * [[action:​Paste_from_Named_Clipboard]]
   * and many others   * and many others
 +
 +**Pause Until Clipboard Changes**
 +
 +Sometimes you will need to wait until the app has completed setting the Clipboard. ​ You can use the [[function:​CLIPBOARDSEED|]],​ in a calculation (`CBSeedBefore ≠ CLIPBOARDSEED()`) condition in the [[action:​Pause_Until|Pause Until Action]] to achieve this.  Of course you will need to set the Keyboard Maestro Variable `CBSeedBefore` in an Action _before_ the Action to set the Clipboard.
  
 The System Clipboard is a complicated entity, and often contains many different flavors of the same data last copied from an app.  To better understand how Keyboard Maestro processes the System Clipboard, see [[https://​forum.keyboardmaestro.com/​t/​ulysses-no-text-in-clipboard/​6742/​23?​u=jmichaeltx | this Forum post by @PeterNLewis]]. ​ In particular, this post deals with getting plain text from the System Clipboard. The System Clipboard is a complicated entity, and often contains many different flavors of the same data last copied from an app.  To better understand how Keyboard Maestro processes the System Clipboard, see [[https://​forum.keyboardmaestro.com/​t/​ulysses-no-text-in-clipboard/​6742/​23?​u=jmichaeltx | this Forum post by @PeterNLewis]]. ​ In particular, this post deals with getting plain text from the System Clipboard.
Line 35: Line 40:
 ==== Display History ==== ==== Display History ====
  
-The Clipboard History Switcher is a built-in Macro, which you can find in the Keyboard Maestro ​Editor, in the //Switcher Group// in the [[Macro_Groups|Macro Groups]].+The Clipboard History Switcher is a built-in Macro, which you can find in the Keyboard Maestro ​editor, in the //Switcher Group// in the [[Macro_Groups|Macro Groups]].
  
 To trigger the Clipboard History Switcher, press the default hotkey of <​key>​⌘</​key><​key>​⌃</​key><​key>​⇧</​key><​key>​V</​key>​ (or a hot key of your choosing). To trigger the Clipboard History Switcher, press the default hotkey of <​key>​⌘</​key><​key>​⌃</​key><​key>​⇧</​key><​key>​V</​key>​ (or a hot key of your choosing).
Line 55: Line 60:
  
 For more discussion on this, see [[https://​forum.keyboardmaestro.com/​t/​how-can-i-get-the-second-to-last-item-in-clipboard/​6615/​6?​u=jmichaeltx | this Keyboard Maestro Forum post]] ​  . For more discussion on this, see [[https://​forum.keyboardmaestro.com/​t/​how-can-i-get-the-second-to-last-item-in-clipboard/​6615/​6?​u=jmichaeltx | this Keyboard Maestro Forum post]] ​  .
- 
  
  
Line 75: Line 79:
  
 (!) Note that Keyboard Maestro provides a named clipboard with the name of "​Default Clipboard"​. ​ It is nothing special, and acts like any other named clipboard. ​ The "​Default"​ in the name means nothing more than that it was provided by default. ​ Do not mistake this for the System Clipboard. (!) Note that Keyboard Maestro provides a named clipboard with the name of "​Default Clipboard"​. ​ It is nothing special, and acts like any other named clipboard. ​ The "​Default"​ in the name means nothing more than that it was provided by default. ​ Do not mistake this for the System Clipboard.
 +
 +
 +===== Trigger Clipboard =====
 +
 +The Trigger Clipboard is not a clipboard per se, but a reference to a clipboard, either the System Clipboard, a past clipboard in the Clipboard History, or a Named Clipboard. ​ It is the clipboard referenced by a [[trigger:​Clipboard Filter]] menu selection in the Clipboard Switcher.
  
 ===== Clipboard Actions ===== ===== Clipboard Actions =====
Line 92: Line 101:
     * [[action:​Copy_Clipboard_to_Clipboard]]     * [[action:​Copy_Clipboard_to_Clipboard]]
     * [[action:​Apply_Style_to_Clipboard]]     * [[action:​Apply_Style_to_Clipboard]]
-    * [[action:Filter_Clipboard]]+    * [[action:Filter]]
     * [[action:​Search_and_Replace_Clipboard]]     * [[action:​Search_and_Replace_Clipboard]]
     * [[action:​Search_Clipboard]]     * [[action:​Search_Clipboard]]
Line 106: Line 115:
 ===== Clipboard Tokens ===== ===== Clipboard Tokens =====
  
-In addition to the above Actions that use Clipboards, there are several Clipboard Tokens that can be used in any Action which has a field for Clipboards, Variables, or text.\\+In addition to the above Actions that use Clipboards, there are several Clipboard Tokens that can be used in any Action which has a field for Clipboards, Variables, or text. 
 These Include: These Include:
 +
   * [[token:​CurrentClipboard|%CurrentClipboard%]] (same as System Clipboard)   * [[token:​CurrentClipboard|%CurrentClipboard%]] (same as System Clipboard)
   * [[token:​NamedClipboard|%NamedClipboard%]]   * [[token:​NamedClipboard|%NamedClipboard%]]
Line 113: Line 124:
  
 ===== See Also ===== ===== See Also =====
- 
----- 
  
 === Actions === === Actions ===
Line 124: Line 133:
 * [[:​Actions|See all Actions]] * [[:​Actions|See all Actions]]
  
-----+=== Functions === 
 + 
 +* [[function:​CLIPBOARDSEED|]] ​-- used to determine when Clipboard has changed 
 + 
 +=== Triggers === 
 + 
 +* [[trigger:​Clipboard Filter]] trigger
  
 ==== Forum ==== ==== Forum ====
Clipboards.txt · Last modified: 2021/10/01 03:14 by peternlewis