Support

Product: Clipboard History for Windows (Stream Deck plugin for Windows) · Provider: GRAMSHIFT (Tokyo, Japan)

Ideas and bug reports

Email contact@gramshift.com in English or Japanese. Ideas and anything else are welcome, and every message is read; we do not guarantee a reply time. For a bug, please include your Windows version (Settings > System > About), your Stream Deck app version and model, the app you copied from or pasted into, and a screenshot of the key's settings page (its Status line says what the last press did). Please do not send copied content you want to keep private.

Get started

In the Stream Deck app, find Clipboard History for Windows in the action list.
Drag History Slot onto a few keys side by side and set their Copy to 1, 2, 3… Copy something: key 1 shows it, and older copies move along.
Press a key to paste its item into the app you are working in.
Optional: a Pause History key and a Clear History key.

History Slot

The key shows copy number 1 (the newest), 2, 3… up to 20: the first lines of a text with its length, or a thumbnail of a picture with its size.
On press: Paste puts the item back on the clipboard, with its formatting when it had some, and sends Ctrl+V to the app in front; Paste as plain text puts only its text back (fonts, colors and links dropped), then Ctrl+V; Copy to the clipboard only puts it there for you to paste.
Pasting from a key keeps the order of the history, so the same key pastes the same item again. The same text or picture copied again moves to the top instead of being added twice.
Pin: hold the key for 1 second (it says PIN?) and release it: the key keeps the item it showed, new copies do not move it, and the history does not drop it. Hold again to unpin. You can also choose the item to pin in the key's settings (Pinned item).
On the key: Show, with passwords and keys as dots (text that looks like a password, an API key or a private key shows as •••••• with its length), Show everything, or Hide the content. A text that looks like a password goes back to the clipboard with the flags that ask Windows not to keep it in its clipboard history or sync it.

Private copies

Apps can flag a copy as private with the clipboard formats Windows defines for this, a flag password managers can set when they copy a password. The plugin does not read or keep such copies: ExcludeClipboardContentFromMonitorProcessing, CanIncludeInClipboardHistory = 0, CanUploadToCloudClipboard = 0 and Clipboard Viewer Ignore. The settings page then says that the last copy was not added and why. Some apps put one of these flags on other copies too (a screenshot tool may, for example); those copies are left out the same way. A copy from an app that sets none of these flags goes into the history like any other copy.

Pause History and Clear History

Pause History: press to stop recording (the key says PAUSED), press again to resume (REC). What you copy while paused is not added, also not when you resume. The pause stays after a restart.
Clear History: shows how many items a clear deletes. Hold it for 2 seconds (it says CLEAR?) and release it to delete them. Delete: The history keeps pinned items; Everything deletes them too. A shorter press does nothing.

Options for every key

History size: 10, 25, 50 (default), 100 or 200 items. Pinned items come on top of that number.
Pictures: keep (default) or do not keep.
After a restart: Keep (default) saves the history encrypted with your Windows account in %LOCALAPPDATA%\GRAMSHIFT\Clipboard History; Delete keeps it in memory only and deletes the files at once.

Looks

Each key has a Look: Classic (dark gray), Neon (bright lines on black), Solid (a bright color: blue for text, violet for pictures, teal for pinned) and Paper (dark words on light paper).

Limits

Text and pictures are kept. Files copied in Explorer stay out of the history.
An app that runs as administrator does not accept keystrokes from other programs: the key puts the item on the clipboard; press Ctrl+V in that app yourself.
Very large copies are left out: text over 2 million characters, pictures over 64 MB (about 4000 x 4000 pixels).
When another app keeps the clipboard open, a press says BUSY: press again a moment later.

Privacy

The history stays on your PC, encrypted with your Windows account, and nothing is sent anywhere. Full details and how to delete everything: Privacy Policy.

Troubleshooting

The key shows	What it means
`EMPTY` / `copy something`	There is no copy with this number yet.
`PASTE` / `Ctrl+V sent`	The item is on the clipboard and Ctrl+V was sent to the app in front.
`COPIED` / `on clipboard`	The item is on the clipboard (the key is set to copy only).
`BUSY` / `clipboard in use`	Another app kept the clipboard open. Press again.
`--` / `pinned item` `deleted`	The item pinned to this key was deleted (Clear History set to Everything). Hold the key for 1 second to unpin it.
`••••••` / `hidden`	The text looks like a password or a key, so its content is hidden on the key. A press still pastes it.
`PAUSED`	Recording is paused: press the Pause History key to resume.
`--` / `restart Stream Deck`	The plugin's clipboard watcher stopped several times. Quit the Stream Deck app and start it again.

Compatibility

Windows 10 or later (tested on Windows 11), Stream Deck 6.9 or later. Works on keys.