Usage

Learn how to use YankLog to manage your clipboard history efficiently.

Main Window

  1. Launch: Run yanklog to open the clipboard manager
  2. Copy: The app automatically monitors your clipboard and stores copied text
  3. Search: Type in the search bar to filter your clipboard history
  4. Paste: Click on any entry to copy it back to your clipboard
  5. Delete: Click the × button on any entry to remove it
  6. Clear All: Click "Clear All" to remove all history
  7. Settings: Click "Settings" to open preferences
  8. Close: Press Escape or close the window normally

The application features a modern dark theme with a search bar at the top for filtering history, a scrollable list of clipboard entries, timestamps showing when each item was copied, and one-click to copy any item back to clipboard.

Quick Pick Mode

Quick Pick is a fast, keyboard-driven popup for selecting clipboard items: 

yanklog --pick
# or
yanklog -p

Keyboard Shortcuts in Quick Pick

  • ↑ / ↓ or k / j - Navigate through items
  • Enter - Select and copy the highlighted item
  • 1-9 - Quick select item by number
  • Escape - Cancel and close

Setting up Global Shortcuts

Option 1: XDG Portal (Recommended for GNOME 45+, KDE 5.27+)

Modern desktop environments support the XDG Global Shortcuts Portal, allowing YankLog to register shortcuts directly:

  1. Open YankLog Settings
  2. In the "Keybindings" section, set your desired shortcut (e.g., Ctrl + Shift + V)
  3. Click "Bind Global Shortcut"
  4. The system will show a dialog to confirm the shortcut binding

Requirements:

  • Desktop file must be installed (see Installation section)
  • Desktop environment must support org.freedesktop.portal.GlobalShortcuts

Option 2: Manual Configuration (Fallback)

If your desktop doesn't support the Portal, set up a keyboard shortcut manually:

  • GNOME: Settings → Keyboard → Custom Shortcuts → Add yanklog --pick
  • KDE: System Settings → Shortcuts → Custom Shortcuts → Add yanklog --pick
  • XFCE: Settings → Keyboard → Application Shortcuts → Add yanklog --pick
  • i3/Sway: Add to config: bindsym $mod+v exec yanklog --pick