Usage

Daily workflow in three surfaces.

Main window for browsing history, Quick Picker for fast keyboard recall, and tray or menu bar controls for background operation.

Main window

  1. Launch: run yanklog.
  2. Copy: yanklog watches clipboard updates automatically.
  3. Search: filter history instantly from the top search field.
  4. Reuse: click any entry to copy it back to clipboard.
  5. Inspect: use See more for the detail view, full content, copy, pin, and delete actions.
  6. Clean up: delete individual rows or clear all entries with confirmation.
  7. Tune: open Settings for history limits, privacy filters, Quick Picker opacity, storage paths, and theme.

Quick Picker mode

Quick Picker is the fastest retrieval path when you are already typing.

yanklog --pick
# or
yanklog -p
  • Up/Down or j/k: move selection.
  • Enter: copy selected item.
  • 1-9: quick-select by index.
  • Esc: close picker without copying.

Quick Picker shortcut setup

macOS registers its global shortcut inside yanklog. Linux desktop environments handle global shortcuts differently, so bind the Quick Picker command in your system keyboard settings.

macOS

  1. Open Settings in yanklog.
  2. Set the Quick Picker shortcut. The default is Cmd+Shift+V.
  3. Use the menu bar item or the shortcut to open Quick Picker.

Linux

  • GNOME/KDE/XFCE custom shortcut command: yanklog --pick
  • i3/Sway example: bindsym $mod+v exec yanklog --pick

Tray and menu bar

  • Show yanklog: open the main window while the app keeps running in the background.
  • Quick Pick: open the compact picker without opening the main window.
  • Pause monitoring: stop clipboard capture temporarily for sensitive work.
  • Check for update: open the update dialog and install newer direct-download releases.
  • Quit: fully exit the background app.