Skip to main content
otter-clip is Otter Shell’s clipboard manager. A long-lived daemon watches the Wayland data-control protocol and keeps a bounded history of text and image entries. Press Super+V to open the launcher popup. The package also ships otter-copy and otter-paste, native utilities that talk to data-control directly. In packaged installs they shadow wl-copy and wl-paste, so existing apps and scripts route through Otter’s implementation without changes.

​
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-copy and otter-paste at a custom history file with --file /path/to/store when you want an isolated clipboard store for scripting.

​
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

​
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.