1clipman(1) General Commands Manual clipman(1)
2
6 clipman
7
9 clipman [<flags>] <command> [<args> ...]
10
13 A clipboard manager for Wayland
14
16 -h, --help
17 Show context-sensitive help (also try --help-long and --help-
18 man).
19 --histpath="~/.local/share/clipman.json"
21 Path of history file
22 --primary
24 Serve item to the primary clipboard. Default: --no-primary
25 --notify
27 Send desktop notifications on errors
28 -v, --version
30 Show application version.
31
33 help [<command>...]
34 Show help.
35 store [<flags>]
37 Record clipboard events (run as argument to `wl-paste --watch`)
38 --max-items=15
40 history size
41 -P, --no-persist
43 Don't persist a copy buffer after a program exits
44 --unix Normalize line endings to LF
46 pick --tool=TOOL [<flags>]
48 Pick an item from clipboard history
49 --max-items=15
51 scrollview length
52 -t, --tool=TOOL
54 Which selector to use: wofi/bemenu/CUSTOM/STDOUT
55 -T, --tool-args=""
57 Extra arguments to pass to the --tool
58 --print0
60 Separate items using NULL; recommended if your tool supports
61 --read0 or similar
62 clear [<flags>]
64 Remove item/s from history
65 --max-items=15
67 scrollview length
68 -t, --tool=TOOL
70 Which selector to use: wofi/bemenu/CUSTOM/STDOUT
71 -T, --tool-args=""
73 Extra arguments to pass to the --tool
74 -a, --all
76 Remove all items
77 --print0
79 Separate items using NULL; recommended if your tool supports
80 --read0 or similar
81 restore
83 Serve the last recorded item from history show-history
84 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. It is highly recommended that you run clipman with the `--no-
92 persist` option, see Known Issues.
93 For primary clipboard support, also add `exec wl-paste -p -t text
95 --watch clipman store -P --histpath="~/.local/share/clipman-pri‐
96 mary.json` (note that both the `-p` in wl-paste and the `-P` in clipman
97 are mandatory in this case).
98 To query the history and select items, run the binary as `clipman pick
100 -t wofi`. You can assign it to a keybinding: `bindsym $mod+h exec clip‐
101 man pick -t wofi`. You can pass additional arguments to the selector
102 like this: `clipman pick --tool wofi -T'--prompt=my-prompt -i'` (both
103 `--prompt` and `-i` are flags of wofi). You can use a custom selector
104 like this: `clipman pick --print0 --tool=CUSTOM --tool-args="fzf
105 --prompt 'pick > ' --bind 'tab:up' --cycle --read0"`.
106 To remove items from history, `clipman clear -t wofi` and `clipman
108 clear --all`.
109 To serve the last history item at startup, add `exec clipman restore`
111 to your Sway config.
112
114 When you experience a clipboard-related bug, try to see if it still
115 happens without clipman running, as it's more likely to be caused by
116 one of our own known issues rather than wl-clipboard.
117
119 We only support plain text.
120 By default, we continue serving the last copied item even after its
122 owner has exited. This means that, unless you run with the `--no-per‐
123 sist` option, you'll always immediately lose rich content; for example:
124 vim's visual block mode breaks; copying images in Firefox breaks; if
125 you copy a bookmark in Firefox, you won't be able to paste it in an‐
126 other bookmark folder; if you copy formatted text inside Libre Office
127 you'll lose all formatting on paste.
128 Run `clipman store` with the `--no-persist` option if you are affected.
130 Unfortunately, it seems that there is no way to make them play well to‐
131 gether.
132 1.6.2 clipman(1)