cliphist icon indicating copy to clipboard operation
cliphist copied to clipboard

wayland clipboard manager with support for multimedia

looking for cliphist-sh?

cliphist

clipboard history “manager” for wayland

  • write clipboard changes to a history file
  • recall history with dmenu (for example)
  • both text and images are supported
  • clipboard is preserved byte-for-byte
    • leading / trailing whitespace / no whitespace or newlines are preserved
    • won’t break fancy editor selections like vim wordwise, linewise, block mode
  • no concept of a picker, only pipes

requires: go, wl-clipboard, xdg-utils (for image mime inferance)

install

$ go install go.senan.xyz/cliphist@latest
alternatively, static binaries can be found on the releases page

usage

listen for clipboard changes

$ wl-paste --watch cliphist store
this will listen for changes on your primary keyboard and write it to the history.
call it once per session - for example in your sway config

select old item

$ cliphist list | dmenu | cliphist decode | wl-copy
bind it to something nice on your keyboard

delete old item

$ cliphist list | dmenu | cliphist delete
or else query manually
$ cliphist delete-query "secret item"

clear database

$ rm "$XDG_CACHE_HOME/cliphist/db"

packaging