Clipboard History
CleverKeys maintains a history of everything you’ve copied — text, images, videos, PDFs, and more — making it easy to paste items from earlier.
Quick Summary
| What | Description |
|---|---|
| Purpose | Access previous clipboard items (text + media) |
| Access | Swipe SW from Ctrl key, or add Clipboard to Extra Keys |
| Capacity | Configurable (default 50 items) |
Accessing Clipboard History
Method 1: Ctrl Key Swipe
- Find the Ctrl key on the bottom row
- Swipe SW (down-left) to activate
switch_clipboard - Clipboard history panel opens
- Tap any item to paste
Method 2: Extra Keys
If you’ve added a clipboard key to Extra Keys:
- Tap the clipboard icon in your extra keys row
- History panel opens
- Tap item to paste
Method 3: Per-Key Customization
You can assign clipboard access to any key’s short swipe:
- Go to Settings > Activities > Per-Key Customization
- Select any key
- Assign
switch_clipboardto a swipe direction
Using Clipboard History
Paste from History
- Open clipboard history
- Tap any item
- Item is pasted at cursor position
Delete Item
- Open clipboard history
- Tap the 🗑 delete button on the item
Long-Press to Copy
Copy an item to the system clipboard without pasting it into the current field:
- Open clipboard history
- Long-press any item’s text
- A “Copied to clipboard” toast confirms the action
- The text is now on the system clipboard — paste it in any app
This is useful when you want to store text for use in another app without inserting it into the current text field.
Pin Items
Keep important items from being removed:
Pin an Item
- Open clipboard history (History tab)
- Tap the 📌 pin button on the item
- Item is added to the Pinned tab
Unpin Item
- Switch to the Pinned tab (📌)
- Tap the 📌 pin button on the item to unpin
- Item is removed from Pinned tab
Pinned items:
- Appear in the dedicated Pinned tab
- Don’t auto-expire
- Don’t count toward history limit
Pinned Entry Shortcuts
You can bind pinned clipboard entries to swipe gestures using the paste_pinned_1 through paste_pinned_5 commands. This lets you insert frequently used pinned text with a single swipe, without opening the clipboard panel.
Entries are numbered by position (most-recently-pinned first):
paste_pinned_1inserts your most recently pinned entrypaste_pinned_2inserts the second, and so on up topaste_pinned_5
To set this up, go to Settings > Activities > Per-Key Customization, choose a key and direction, select Command, and search for “paste_pinned”. See Per-Key Actions for full details.
Todo Items
Mark clipboard items as to-do reminders:
Add to Todos
- Open clipboard (History or Pinned tab)
- Tap the ✓ todo button on the item
- Item is added to the Todos tab
Mark as Done
- Switch to the Todos tab (✓)
- Tap the ✓ todo button to remove from todos
- Item is removed from Todos tab (still in history)
Todo items:
- Appear in the dedicated Todos tab
- Can also be pinned (both flags independent)
- Useful for quick reference or follow-up
Media Clipboard
CleverKeys automatically captures images, videos, PDFs, and other files you copy to the clipboard.
Supported Media Types
| Type | Examples | Thumbnail |
|---|---|---|
| Images | JPEG, PNG, WebP, GIF | Photo preview |
| Animated | Animated GIF, animated WebP | First frame + play badge |
| Videos | MP4, QuickTime | Video frame preview |
| PDFs | PDF documents | First page preview |
| Other files | ZIP, documents | MIME-type icon |
How Media Clipboard Works
- Copy an image/video/file in any app (Gallery, Chrome, Files, etc.)
- CleverKeys captures it automatically in the background
- A thumbnail appears in clipboard history
- Tap the media entry to paste it into the current app (via
commitContent)
Media Paste
- Media is pasted via Android’s
commitContentAPI — the receiving app must support it - Most messaging apps (Signal, Telegram, WhatsApp) and text editors support image paste
- If the app doesn’t support media paste, a “Cannot paste media here” message appears
- Long-press a media entry to copy the media URI to the system clipboard
Media Settings
| Setting | Description | Default |
|---|---|---|
| Media Clipboard | Enable/disable media capture | On |
| Text-Only Mode | Hide all media, show only text entries | Off |
| Max Media Size | Maximum file size for media entries (1-50 MB) | 10 MB |
To access: Settings > Clipboard section (expand it) or Settings > Activities > Clipboard Settings.
[!TIP] If you only want text in your clipboard and find media entries distracting, enable Text-Only Mode. Media will still be captured (unless you also disable Media Clipboard) but won’t appear in the panel.
Tab System
The clipboard pane organizes items into three tabs:
| Tab | Icon | Description |
|---|---|---|
| History | 📋 | Recent clipboard history (default) |
| Pinned | 📌 | Items you’ve pinned for quick access |
| Todos | ✓ | Items marked as to-do reminders |
Switching Tabs
- Open clipboard pane
- Tap the tab icon (📋, 📌, or ✓) in the header row
- Active tab is fully visible (alpha 1.0), inactive tabs are dimmed (alpha 0.5)
Item Actions by Tab
| Action | History Tab | Pinned Tab | Todos Tab |
|---|---|---|---|
| Pin button | Pins item | Unpins item | Pins item |
| Todo button | Adds to todos | Adds to todos | Removes from todos |
| Delete | Deletes item | Deletes item | Deletes item |
| Paste | Pastes to editor | Pastes to editor | Pastes to editor |
| Long-press | Copies to system clipboard | Copies to system clipboard | Copies to system clipboard |
Pagination
For large clipboard histories (>100 items), pagination improves performance:
- Items are displayed 100 per page
- Pagination bar appears at the bottom when needed
- Shows current page / total pages (e.g., “1 / 6”)
- ◀ and ▶ buttons navigate between pages
- Search still searches ALL items across all pages
┌─────────────────────────────────────┐
│ [◀] 3 / 6 [▶] │
└─────────────────────────────────────┘
History Panel Layout
┌─────────────────────────────────────┐
│ 📋 📌 ✓ [Search...] 🔽 [▼] │ ← Tabs + Search + Filter + Close
├─────────────────────────────────────┤
│ Recently copied text here... [📌✓🗑]│ ← Text entry
│ [thumb] photo.jpg · 2h ago [📌✓🗑]│ ← Image entry with thumbnail
│ [▶vid] clip.mp4 · Yesterday [📌✓🗑]│ ← Video entry with play badge
│ Another clipboard item... [📌✓🗑]│ ← Text entry
├─────────────────────────────────────┤
│ [◀] 1 / 3 [▶] │ ← Pagination (if >100 items)
└─────────────────────────────────────┘
Privacy Features
Password Manager Exclusion
CleverKeys can exclude clipboard entries from password managers:
| Setting | Behavior |
|---|---|
| Enabled | Clips from 1Password, Bitwarden, etc. not saved |
| Disabled | All clips saved normally |
Supported apps include: 1Password, Bitwarden, LastPass, Dashlane, KeePass variants, and more.
Password Field Detection
CleverKeys automatically detects password fields:
| Behavior | Description |
|---|---|
| Don’t save | Password field text not saved to history |
| Mask display | Sensitive items may show masked |
Tips and Tricks
- Pin frequently used: Pin items you paste often
- Clear sensitive data: Regularly clear history with sensitive info
- Quick access: Add clipboard to Extra Keys for one-tap access
- Customize access: Assign clipboard to any key via Per-Key Customization
[!TIP] The Ctrl key’s SW subkey is
switch_clipboardby default on most layouts.
Settings
| Setting | Location | Description |
|---|---|---|
| Enable History | Clipboard section | Turn history on/off |
| History Size | Clipboard section | Maximum items to keep |
| History Duration | Clipboard section | Auto-expiry (default: never) |
| Max Item Size | Clipboard section | Per-item text size limit (64-1024 KB) |
| Media Clipboard | Clipboard section | Enable/disable media capture |
| Text-Only Mode | Clipboard section | Hide media, show only text |
| Max Media Size | Clipboard section | Maximum media file size (1-50 MB) |
| Pinned Tab | Clipboard section | Show/hide the Pinned tab |
| Todo Tab | Clipboard section | Show/hide the Todos tab |
| Exclude Password Managers | Clipboard section | Don’t save from password apps |
| Respect Sensitive Flag | Clipboard section | Honor Android 13+ IS_SENSITIVE |
Clear History
To clear clipboard history, use the export/import features in Settings > Backup & Restore, or delete items individually using the delete button on each item.
Common Questions
Q: Why don’t I see clipboard history?
A: Check that it’s enabled in Settings > Clipboard section (expand it).
Q: How do I access clipboard quickly?
A: Swipe SW (southwest/down-left) on the Ctrl key, or add a clipboard key to your Extra Keys.
Q: Why wasn’t my copied text saved?
A: It may have been from a password field or a password manager app (if exclusion is enabled).
Q: Can I recover deleted items?
A: No, deleted items cannot be recovered. Pin important items.
Q: Why don’t I see images in my clipboard?
A: Check that Media Clipboard is enabled and Text-Only Mode is off in Settings > Clipboard section. The source app must also provide a content URI when copying (most apps do).
Q: Can I paste an image from clipboard into a messaging app?
A: Yes — tap the image entry in clipboard history. It uses Android’s commitContent API. The receiving app must support media input (most modern messaging apps do).
Related Features
- Text Selection - Select text efficiently
- Shortcuts - Keyboard shortcuts for clipboard
- Privacy - Privacy settings