User Tools

Site Tools


manual:Clipboard_History_Switcher

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:Clipboard_History_Switcher [2017/08/25 00:09]
peternlewis
manual:Clipboard_History_Switcher [2019/09/09 19:39]
JMichaelTX Minor cleanup after Major rewrite
Line 1: Line 1:
 ====== Clipboard History Switcher ====== ====== Clipboard History Switcher ======
  
-Clipboard~~History~~Switcher ​saves copy of each clipboard every time you copy something.  You can then paste any previous system clipboard by triggering ​the Clipboard~~History~~Switcher macro. ​ Clipboard~~History~~Switcher will present you with window allowing you to select any of the past clipboard and paste them.+Clipboard~~History~~Switcher ​is actually more like Clipboard Manager. ​ Whenever ​you copy something ​from any app, the Keyboard Maestro Engine saves copy of the System Clipboard at that time to the _Clipboard History_ file 
  
-{{ clipboardhistoryswitcher.png?​672 |Clipboard History Switcher Window }} 
  
-You can press arrow keys to scroll through the clipboard entries, and return/​enter to paste in an entry. ​ Hold the Shift key while pressing return or double clicking to paste as plain text.  You can also drag items around - if a new item becomes the first item, then it will replace the current System Clipboard.+**The _Clipboard History Switcher_ (CHS) allows you to:**
  
-You can include information about the clipboard entry (index, ​time copied, size) by toggling the BUTTON{{{i}}} button ​Whether ​the switcher closes when you paste something is controlled by the BUTTON{{{x}}} button. ​ You can mark entries as favoritesin which case they will never be removed from the clipboard history.+* Save a copy of the System Clipboard every time you make a copy from anywhere. 
 +* Paste any previous saved clipboard in your History 
 +* View all of the Clipboards in your History 
 +* Perform special operations before ​you paste, ​like convert to plain text 
 +* Merge multiple Clipboards into one new Clipboard 
 +* Paste multiple Clipboards with a user-selected delimiter 
 +* Trigger Your Custom Macros to operate on the selected Clipboard.
  
-You can use the search field to filter the clipboards. 
  
-In the BUTTON{{{⚙}}} menu in each clipboard entry, you can Paste the item or use it Set the System Clipboard, optionally removing styles or forcing it as an image. ​ You can also Favorite, Send or Delete the item.+A typical display of the _Clipboard History Switcher_ looks like this: 
  
-Any active macros that have the Clipboard Filter trigger will be displayed in the BUTTON{{{⚙}}} menu.  They can use the Trigger Clipboard facility to operate on the selected clipboard, allowing you to make macros that apply to any selected clipboard (for example, save the clipboard to disk, or uppercase it).+{{ clipboardhistoryswitcher.png?​nolink&​673x706 | Clipboard History Switcher Window ​}}
  
-Clipboard entries that resemble passwords are obscured, deleted after they reach position ten in the clipboard history, and not saved to disk.  You can option click on an obscured password to reveal it.+===== How To Use ===== 
 +==== Display ​the CHS ====
  
-You can send clipboards to another Mac running Keyboard Maestro. The received clipboard entries will appear ​in the clipboard history ​(assuming the Keyboard Maestro ​Web Server is enabled on the destination Mac).+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).
  
-You can toggle to the Named Clipboards ​by clicking on the BUTTON{{{🕘}}} button.+==== Pasting from the CHS ==== 
 + 
 +* To Paste the Selected Clipboard as is, do any of these: 
 +  * Double-Click on the Clipboard 
 +  * Press RETURN or ENTER key 
 +  * Click on the Paste button 
 +  * Right-click on the Clipboard and select "​Paste"​ 
 +  * Drag Clipboard onto App document 
 +* Hold the Shift key while pressing return or double clicking to paste as plain text. 
 + 
 +==== Toolbar ==== 
 + 
 +Most of these Toolbar buttons operate on the selected Clipboard. ​ There are currently no keyboard shortcuts for these tools. 
 + 
 +{{:​manual:​clipboard-history-switcher-km9.png?​nolink|}} 
 + 
 +=== Toolbar Buttons === 
 + 
 +* Information BUTTON{{{i}}} button 
 +  * You can include information about the clipboard entry (index, time copied, size) by toggling this button. 
 +* Close CHS BUTTON{{{x}}} button 
 +  * Whether the switcher closes when you paste something is controlled by this button. 
 +* Mark as Favorite Button 
 +  * You can mark entries as favorites, in which case they will never be removed from the clipboard history. 
 +* Search Box 
 +  * Enter text to filter for Clipboards that contain that text 
 +  * Click the Search Icon to show Only Favorites 
 +* Send Button 
 +  * Send Selected Clipboard(s) via email?? FIXME 
 +* Delete Button 
 +  * Delete Selected Clipboard(s) 
 + 
 + 
 +==== Gear & Context Menu ==== 
 + 
 +This menu is available by either clicking on the Gear BUTTON{{{⚙}}} Button on a Clipboard, or by right-clicking anywhere on a Clipboard. 
 + 
 +Most of the these menu items are designed to operate on one or more Clipboards, and produce a **new** Clipboard, which can later be pasted if desired. 
 + 
 +{{:​manual:​clipboard-history-switcher-context-menu.png?​nolink|}} 
 + 
 + 
 +=== 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 ==== 
 + 
 +Select two or more Clipboards (using standard macOS multiselection),​ and then you can: 
 + 
 +* Paste them as a single unit, or  
 +* Press ⌘C to merge them to the System Clipboard. ​  
 + 
 +The Gear BUTTON{{{⚙}}} menu includes a selection for the separator to include between each item when pasting multiple entires. ​ If multiple images are selected, merging them creates a single larger image (horizontally or vertically, depending on the separator). 
 + 
 +==== Other Operations ==== 
 + 
 +* Passwords -- Clipboard entries that resemble passwords are obscured, deleted after they reach position ten in the clipboard history, and not saved to disk.  You can option click on an obscured password to reveal it. 
 +* Send to another Mac 
 +  * 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. 
 + 
 + 
 + 
 +===== Preferences ===== 
 + 
 +==== Excluding Clipboards from Selected Apps ==== 
 + 
 +Keyboard Maestro keeps a copy of everything you copy automatically each time you copy something. ​ You can exclude certain applications (for example, badly behaved applications or applications that often have very large clipboards) using the [[manual:​Preferences#​Excluded_Preferences|Preferences > Excluded Preferences Panel]] in the Keyboard Maestro Editor app. 
 + 
 +==== Hidden 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. 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). 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).
manual/Clipboard_History_Switcher.txt · Last modified: 2023/10/03 04:19 by peternlewis