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.

                                              1.2.0                                    clipman(1)