---
name: "clipman"
section: "1"
platform: "linux"
package: "clipman"
version: "1.2.0+git20200218.39fd4fe-2+b18"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/clipman"
---

# clipman(1)

## NAME

clipman

## SYNOPSIS

- **clipman \[\<flags\>\] \<command\> \[\<args\> ...\]**

  ## DESCRIPTION

A clipboard manager for Wayland

## OPTIONS

- **-h, --help**

  Show context-sensitive help (also try --help-long and --help-man).

- **--histpath="~/.local/share/clipman.json"**

  Path of history file

- **-v, --version**

  Show application version.

## COMMANDS

### **help \[\<command\>...\]**

Show help.

### **store \[\<flags\>\]**

Record clipboard events (run as argument to \`wl-paste --watch\`)

- **--max-items=15**

  history size

- **-P, --no-persist**

  Don't persist a copy buffer after a program exits

### **pick \[\<flags\>\]**

Pick an item from clipboard history

- **--max-items=15**

  scrollview length

- **-t, --tool="dmenu"**

  Which selector to use: dmenu/bemenu/rofi/wofi/STDOUT

- **-T, --tool-args=""**

  Extra arguments to pass to the --tool

### **clear \[\<flags\>\]**

Remove item/s from history

- **--max-items=15**

  scrollview length

- **-t, --tool="dmenu"**

  Which selector to use: dmenu/bemenu/rofi/wofi/STDOUT

- **-T, --tool-args=""**

  Extra arguments to pass to the --tool

- **-a, --all**

  Remove all items

### **restore**

Serve the last recorded item from history

## USAGE

Run the binary in your Sway session by adding \`exec wl-paste -t text --watch clipman store\` (or \`exec wl-paste -t text --watch clipman store 1\>\> PATH/TO/LOGFILE 2\>&1 &\` to log errors) at the beginning of your config. For primary clipboard support, also add \`exec wl-paste -p -t text --watch clipman store --histpath="~/.local/share/clipman-primary.json\`.

To query the history and select items, run the binary as \`clipman pick\`. You can assign it to a keybinding: \`bindsym $mod+h exec clipman pick\`. For primary clipboard support, \`clipman pick --histpath="~/.local/share/clipman-primary.json\`.

To remove items from history, \`clipman clear\` and \`clipman clear --all\`.

To serve the last history item at startup, add \`exec clipman restore\` to your Sway config.

## KNOWN ISSUES

All items stored in history are treated as plain text. This means that, unless you run with the \`--no-persist\` option, you'll always immediately lose rich content: for example, if you copy formatted text inside Libre Office you'll lose all formatting on paste.