A basic clipboard manager for Wayland, with support for persisting copy buffers after an application exits.
Requirements:
- a windows manager that uses
wlr-data-control
, like Sway and other wlroots-based WMs. - wl-clipboard >= 2.0
- dmenu, bemenu, rofi or wofi
Install go, add $GOPATH/bin
to your path, then run go get github.com/yory8/clipman
OR run go install
inside this folder.
Archlinux users can find a PKGBUILD here.
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.
For more options: clipman -h
.
-
All items stored in history are treated as plain text.
-
By default, we continue serving the last copied item even after its owner has exited. The trade-off is that we always immediately lose rich content: for example, if you copy some bold text in LibreOffice, when you paste it right after it will be unformatted text; or, if you copy a bookmark in Firefox, you won't be able to paste it in another bookmark folder. To disable this behaviour, you must give up persistency-after-exit by passing the
-P
option toclipman store
. (Items manually picked from history will still be just plain text.)
This projects follows SemVer conventions.