clipman

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.