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/dmenu/rofi/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/dmenu/rofi/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.
92 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 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 To remove items from history, `clipman clear -t wofi` and `clipman
107 clear --all`.
108 To serve the last history item at startup, add `exec clipman restore`
110 to your Sway config.
111
113 We only support plain text.
114 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 vim's visual block mode breaks; copying images in Firefox breaks; if
119 you copy a bookmark in Firefox, you won't be able to paste it in an‐
120 other bookmark folder; if you copy formatted text inside Libre Office
121 you'll lose all formatting on paste.
122 Run `clipman store` with the `--no-persist` option if you are affected.
124 Unfortunately, it seems that there is no way to make them play well to‐
125 gether.
126 1.6.1 clipman(1)