clipman1
Usage
- clipman [<flags>] <command> [<args> ...]
Overview
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.
Releases
Unchanged in 3 releases since Debian 11 (Bullseye).