1clipman(1)                  General Commands Manual                 clipman(1)
2
3
4

NAME

6       clipman
7

SYNOPSIS

9       clipman [<flags>] <command> [<args> ...]
10
11

DESCRIPTION

13       A clipboard manager for Wayland
14

OPTIONS

16       -h, --help
17              Show  context-sensitive  help  (also try --help-long and --help-
18              man).
19
20       --histpath="~/.local/share/clipman.json"
21              Path of history file
22
23       --notify
24              Send desktop notifications on errors
25
26       -v, --version
27              Show application version.
28

COMMANDS

30   help [<command>...]
31       Show help.
32
33   store [<flags>]
34       Record clipboard events (run as argument to `wl-paste --watch`)
35
36       --max-items=15
37              history size
38
39       -P, --no-persist
40              Don't persist a copy buffer after a program exits
41
42   pick --tool=TOOL [<flags>]
43       Pick an item from clipboard history
44
45       --max-items=15
46              scrollview length
47
48       -t, --tool=TOOL
49              Which selector to use: wofi/bemenu/CUSTOM/dmenu/rofi/STDOUT
50
51       -T, --tool-args=""
52              Extra arguments to pass to the --tool
53
54       --print0
55              Separate items using NULL; recommended  if  your  tool  supports
56              --read0 or similar
57
58   clear [<flags>]
59       Remove item/s from history
60
61       --max-items=15
62              scrollview length
63
64       -t, --tool=TOOL
65              Which selector to use: wofi/bemenu/CUSTOM/dmenu/rofi/STDOUT
66
67       -T, --tool-args=""
68              Extra arguments to pass to the --tool
69
70       -a, --all
71              Remove all items
72
73       --print0
74              Separate  items  using  NULL;  recommended if your tool supports
75              --read0 or similar
76
77   restore
78       Serve the last recorded item from history
79

USAGE

81       Run the binary in your Sway session by adding `exec  wl-paste  -t  text
82       --watch clipman store` (or `exec wl-paste -t text --watch clipman store
83       1>> PATH/TO/LOGFILE 2>&1 &` to log errors) at  the  beginning  of  your
84       config.   For  primary clipboard support, also add `exec wl-paste -p -t
85       text  --watch  clipman  store   --histpath="~/.local/share/clipman-pri‐
86       mary.json`.
87
88       To  query the history and select items, run the binary as `clipman pick
89       -t wofi`. You can assign it to a keybinding: `bindsym $mod+h exec clip‐
90       man  pick  -t  wofi`.   For primary clipboard support, `clipman pick -t
91       wofi --histpath="~/.local/share/clipman-primary.json`.   You  can  pass
92       additional  arguments  to  the selector like this: `clipman pick --tool
93       wofi -T'--prompt=my-prompt -i'` (both `--prompt` and `-i` are flags  of
94       wofi).  You can use a custom selector like this: `clipman pick --print0
95       --tool=CUSTOM --tool-args="fzf  --prompt  'pick  >  '  --bind  'tab:up'
96       --cycle --read0"`.
97
98       To  remove  items  from  history,  `clipman clear -t wofi` and `clipman
99       clear --all`.
100
101       To serve the last history item at startup, add `exec  clipman  restore`
102       to your Sway config.
103

KNOWN ISSUES

105       All items stored in history are treated as plain text.
106
107       By  default,  we  continue  serving the last copied item even after its
108       owner has exited. This means that, unless you run with  the  `--no-per‐
109       sist` option, you'll always immediately lose rich content: for example,
110       if you copy formatted text inside Libre Office you'll lose all  format‐
111       ting on paste; or, if you copy a bookmark in Firefox, you won't be able
112       to paste it in another bookmark folder.
113
114
115
116                                     1.5.2                          clipman(1)
Impressum