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 --notify
24 Send desktop notifications on errors
25
26 -v, --version
27 Show application version.
28
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
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
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)