clipman
Contents
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
Description
A clipboard manager for Wayland
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.
1.2.0 clipman(1)
Name
clipman
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.
Synopsis
clipman[<flags>]<command>[<args>...]
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.
