Skip to main content
otter-clip keeps a bounded history of text and images from the Wayland data-control protocol. Press Super+V for the launcher popup. The same package ships otter-copy and otter-paste, which talk to data-control directly. In packaged installs they shadow wl-copy and wl-paste, so existing apps and scripts keep working.

​
Starting the daemon

Run the daemon once per session.
Add otter-clip daemon to your compositor’s autostart list so history is ready at login. Without the daemon, otter-clip list, search, and the Super+V popup have nothing to show.

​
CLI commands

The popup command opens otter-launcher --query "clip ...". Selecting a row calls otter-clip select INDEX to copy that item back to the clipboard. Pressing Enter in the popup is the same as running otter-clip select on the highlighted entry.

​
Copying and pasting

otter-copy and otter-paste replace wl-copy and wl-paste. They communicate with Wayland data-control directly.
Point otter-clip, otter-copy, and otter-paste at a custom history file with --file /path/to/store when you want an isolated clipboard store for scripting.
The daemon caches accepted representations and reoffers them byte-for-byte in the source-advertised order. Ownership is taken only after reads complete, so GTK image and rich-text formats still paste after a short-lived source exits.

​
Configuration

otter-clip reads ~/.config/otter-shell/otter-clip.conf at daemon startup.
  • history_path: absolute path for history storage. Empty uses $XDG_CACHE_HOME/otter-shell/otter-clip-history. A legacy /tmp/otter-clip-history is still read when configured.

​
Privacy and password managers

otter-clip skips clipboard entries that carry password manager or secret MIME hints before reading their data. Credentials copied from password managers do not end up in plain text history. Wayland data-control does not expose the source application ID for copied data, so app-ID filtering only applies when a source ID is available to the caller.

​
Image support

otter-clip accepts text offers and common image MIME types from the clipboard. Images are stored as bounded blob files with MIME type and path metadata, not decoded and re-encoded. The otter-launcher popup can show image thumbnails inline when you open clipboard history with Super+V.