1clipman(1) General Commands Manual clipman(1)
2
3
4
6 clipman
7
9 clipman [<flags>] <command> [<args> ...]
10
11
13 A clipboard manager for Wayland
14
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 --primary
24 Serve item to the primary clipboard. Default: --no-primary
25
26 --notify
27 Send desktop notifications on errors
28
29 -v, --version
30 Show application version.
31
33 help [<command>...]
34 Show help.
35
36 store [<flags>]
37 Record clipboard events (run as argument to `wl-paste --watch`)
38
39 --max-items=15
40 history size
41
42 -P, --no-persist
43 Don't persist a copy buffer after a program exits
44
45 --unix Normalize line endings to LF
46
47 pick --tool=TOOL [<flags>]
48 Pick an item from clipboard history
49
50 --max-items=15
51 scrollview length
52
53 -t, --tool=TOOL
54 Which selector to use: wofi/bemenu/CUSTOM/dmenu/rofi/STDOUT
55
56 -T, --tool-args=""
57 Extra arguments to pass to the --tool
58
59 --print0
60 Separate items using NULL; recommended if your tool supports
61 --read0 or similar
62
63 clear [<flags>]
64 Remove item/s from history
65
66 --max-items=15
67 scrollview length
68
69 -t, --tool=TOOL
70 Which selector to use: wofi/bemenu/CUSTOM/dmenu/rofi/STDOUT
71
72 -T, --tool-args=""
73 Extra arguments to pass to the --tool
74
75 -a, --all
76 Remove all items
77
78 --print0
79 Separate items using NULL; recommended if your tool supports
80 --read0 or similar
81
82 restore
83 Serve the last recorded item from history show-history
84
85 Show all items from history
86
88 Run the binary in your Sway session by adding `exec wl-paste -t text
89 --watch clipman store` (or `exec wl-paste -t text --watch clipman store
90 1>> PATH/TO/LOGFILE 2>&1 &` to log errors) at the beginning of your
91 config.
92
93 For primary clipboard support, also add `exec wl-paste -p -t text
94 --watch clipman store -P --histpath="~/.local/share/clipman-pri‐
95 mary.json` (note that both the `-p` in wl-paste and the `-P` in clipman
96 are mandatory in this case).
97
98 To query the history and select items, run the binary as `clipman pick
99 -t wofi`. You can assign it to a keybinding: `bindsym $mod+h exec clip‐
100 man pick -t wofi`. You can pass additional arguments to the selector
101 like this: `clipman pick --tool wofi -T'--prompt=my-prompt -i'` (both
102 `--prompt` and `-i` are flags of wofi). You can use a custom selector
103 like this: `clipman pick --print0 --tool=CUSTOM --tool-args="fzf
104 --prompt 'pick > ' --bind 'tab:up' --cycle --read0"`.
105
106 To remove items from history, `clipman clear -t wofi` and `clipman
107 clear --all`.
108
109 To serve the last history item at startup, add `exec clipman restore`
110 to your Sway config.
111
113 All items stored in history are treated as plain text.
114
115 By default, we continue serving the last copied item even after its
116 owner has exited. This means that, unless you run with the `--no-per‐
117 sist` option, you'll always immediately lose rich content: for example,
118 if you copy formatted text inside Libre Office you'll lose all format‐
119 ting on paste; or, if you copy a bookmark in Firefox, you won't be able
120 to paste it in another bookmark folder.
121
122 Vim's Visual Block mode and other things (copying images in Firefox,
123 etc) break if persistence is enabled
124
125 Run `clipman store` with the `--no-persist` option if you are affected.
126 Unfortunately, it seems that there is no way to make them play well to‐
127 gether.
128
129
130
131 1.6.0 clipman(1)