Differences

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

--- manual:Clipboard_History_Switcher [2021/02/04 01:23] – ccstone
+++ manual:Clipboard_History_Switcher [2023/10/03 08:19] (current) – peternlewis
@@ Line 1: / Line 1: @@
-{{:clipboards-sm-icon.png?nolink|}}
 ====== Clipboard History Switcher ======
@@ Line 5: / Line 4: @@
-**The _Clipboard History Switcher_ (CHS) allows you to:**
+The _Clipboard History Switcher_ allows you to:
 * Save a copy of the System Clipboard every time you make a copy from anywhere.
@@ Line 14: / Line 13: @@
 * Paste multiple Clipboards with a user-selected delimiter
 * Trigger Your Custom Macros to operate on the selected Clipboard.
-* Saves up to 200 items (the number is user adjustable in the [Hidden Clipboard Preferences](https://wiki.keyboardmaestro.com/manual/Preferences?s%5B%5D=hidden&s%5B%5D=preferences#Clipboard)).
+* Saves up to 200 items (the number is user adjustable in the [[Preferences]]).
 A typical display of the _Clipboard History Switcher_ looks like this:
-{{ clipboardhistoryswitcher.png?nolink&673x706 | Clipboard History Switcher Window }}
+{{ manual:clipboardhistoryswitcher.png?nolink&674x718 | Clipboard History Switcher Window }}
+The Clipboard History Switcher will also shown information such as the size and dimensions of images, and the character, word and line count of text.
 ===== How To Use =====
-==== Display the CHS ====
+==== Display the Clipboard History Switcher====
 The _Clipboard History Switcher_ is displayed using the [[action:Activate_Clipboard_History_Switcher|Activate Clipboard History Switcher]] Action.  You can find a Macro that uses this Action in the _Switcher Group_ Macro Group (which  comes installed with Keyboard Maestro).
-==== Pasting from the CHS ====
+==== Pasting from the Clipboard History Switcher====
 * To Paste the Selected Clipboard as is, do any of these:
-  * Double-Click on the Clipboard
+  * Double-Click on the Clipboard.
-  * Press RETURN or ENTER key
+  * Press the Return or Enter key.
-  * Click on the Paste button
+  * Click on the Paste button.
-  * Right-click on the Clipboard and select "Paste"
+  * Right-click on the Clipboard and select “Paste”.
-  * Drag Clipboard onto App document
+  * Drag a Clipboard entry onto App document.
-* Hold the Shift key while pressing return or double clicking to paste as plain text.
+Hold the Shift key while pressing return or double clicking to paste as plain text.
+Hold the Option key while pressing return or double clicking to just set the system clipboard.
+Command-Numbers will paste the corresponding entry. Command-Shift-Numbers will paste in plain text, and Command-Option-Numbers will just set the system clipboard.
 ==== Toolbar ====
-Most of these Toolbar buttons operate on the selected Clipboard.  There are currently no keyboard shortcuts for these tools.
+Most of these Toolbar buttons operate on the selected Clipboard.
-{{:manual:clipboard-history-switcher-km9.png?nolink|}}
+The buttons from left to right are:
-=== Toolbar Buttons ===
+* Toggle between the Clipboard History and the [[manual:Named_Clipboard_Switcher|Named Clipboards]].
+* Cut the current application selection to the Clipboard History.
-* Information BUTTON{{{i}}} button
+* Copy the current application selection to the Clipboard History.
-  * You can include information about the clipboard entry (index, time copied, size) by toggling this button.
+* Paste the current Clipboard History selection.
-* Close CHS BUTTON{{{x}}} button
+* Mark the current Clipboard History selection as a favorite (so it will never be deleted).
-  * Whether the switcher closes when you paste something is controlled by this button.
+* Quick Look at the current Clipboard History selection.
-* Mark as Favorite Button
+* Send the current Clipboard History selection to another Mac running Keyboard Maestro.
-  * You can mark entries as favorites, in which case they will never be removed from the clipboard history.
+* Delete the current Clipboard History selection.
-* Search Box
+* Toggle whether the Clipboard History Switcher will close after pasting.
-  * Enter text to filter for Clipboards that contain that text
+* Toggle showing additional information.
-  * Click the Search Icon to show Only Favorites
-* Send Button
-  * Send Selected Clipboard(s) via email?? FIXME
-* Delete Button
-  * Delete Selected Clipboard(s)
+You can search the Clipboard History with the search field, and limit the display to Images-only (v11.0+) or Favorites-only.
 ==== Gear & Context Menu ====
@@ Line 67: / Line 71: @@
 {{:manual:clipboard-history-switcher-context-menu.png?nolink|}}
+You can add entries to this menu using the [[trigger:Clipboard_Filter|Clipboard Filter]] trigger.
-=== Menu Items ===
-* Paste the Clipboard
-* Set the System Clipboard
-* Remove styles
-* Convert Text to an image
-* Processing by Your Custom Macros
-  * Any active macros that have the Clipboard Filter trigger will be displayed in this menu.
-  * These Macro operate on the selected clipboard(s)
-==== Navigate the CHS ====
-* Arrow Keys
-  * You can press arrow keys to scroll through the clipboard entries
-* Drag/Drop Clipboards
-  * You can also drag Clipboards to a new location in the History
-  * If it becomes the first Clipboard, then it will replace the current System Clipboard
-  * Drag text and images out from the clipboard switcher to other applications.
 ==== Operating on Multiple Clipboards ====
@@ Line 103: / Line 88: @@
   * You can send clipboards to another Mac running Keyboard Maestro.
   * The receiving Mac will show the received clipboard entries  in the clipboard history (assuming the Keyboard Maestro Web Server is enabled on the destination Mac).
-* Switch Between Normal Clipboard History and Named Clipboard Switchers
-  * You can toggle to the [[manual:Named_Clipboard_Switcher|Named Clipboard Switcher]] by clicking on the BUTTON{{{🕘}}} button.
@@ Line 118: / Line 100: @@
 The default Maximum Number of Items stored in the Clipboard History is 200.
-This along with several other features may be changed here:
+This along with several other features may be changed with the [[Preferences]].
-For more Clipboard History Preferences, see [Hidden Clipboard Preferences](https://wiki.keyboardmaestro.com/manual/Preferences?s%5B%5D=hidden&s%5B%5D=preferences#Clipboard)
 By default, Keyboard~~Maestro creates a Clipboard~~History~~Switcher macro in the “Switcher~~Group” Macro~~Group, triggered by Command-Control-Shift-V.  You can disable the Macros by selecting them in the [[Windows#Macros_Window|Macros window pane]] and clicking the BUTTON{{{✓}}} button.
 Keyboard~~Maestro also has many macros in the [[Macro Library]], such as macros for Paste Plain Text (Command-Shift-V) and Paste Previous Clipboard (Command-Control-V).