1CopyQ(1) General Commands Manual CopyQ(1)
2
3
4
6 CopyQ - Clipboard Manager with Advanced Features
7
8
9
11 copyq [COMMAND]
12
13
14
16 CopyQ is advanced clipboard manager with editing and scripting fea‐
17 tures. It monitors system clipboard and saves its content in customized
18 tabs. Saved clipboard can be later copied and pasted directly into any
19 application.
20
21
22
24 Starts server if no command is specified.
25
26
27 show [NAME]
28 Show main window and optionally open tab with given name.
29
30 hide Hide main window.
31
32 toggle Show or hide main window.
33
34 menu Open context menu.
35
36 exit Exit server.
37
38 disable, enable
39 Disable or enable clipboard content storing.
40
41
42
43 clipboard [MIME]
44 Print clipboard content.
45
46 selection [MIME]
47 Print X11 selection content.
48
49 paste Paste clipboard to current window (may not work with some appli‐
50 cations).
51
52 copy TEXT
53 Set clipboard text.
54
55 copy MIME DATA [MIME DATA]...
56 Set clipboard content.
57
58
59
60 count Print amount of items in current tab.
61
62 select [ROW=0]
63 Copy item in the row to clipboard.
64
65 next Copy next item from current tab to clipboard.
66
67 previous
68 Copy previous item from current tab to clipboard.
69
70 add TEXT...
71 Add text into clipboard.
72
73 insert ROW TEXT
74 Insert text into given row.
75
76 remove [ROWS=0...]
77 Remove items in given rows.
78
79 edit [ROW=-1...]
80 Edit items or edit new one. Value -1 is for current text in
81 clipboard.
82
83
84
85 separator SEPARATOR
86 Set separator for items on output.
87
88 read [MIME|ROW]...
89 Print raw data of clipboard or item in row.
90
91 write [ROW=0] MIME DATA [MIME DATA]...
92 Write raw data to given row.
93
94
95
96 action [ROWS=0...]
97 Show action dialog.
98
99 action [ROWS=0...] [PROGRAM [SEPARATOR=\n]]
100 Run PROGRAM on item text in the rows. Use %1 in PROGRAM to pass
101 text as argument.
102
103 popup TITLE MESSAGE [TIME=8000]
104 Show tray popup message for TIME milliseconds.
105
106
107
108 tab List available tab names.
109
110 tab NAME [COMMAND]
111 Run command on tab with given name. Tab is created if it
112 doesn't exist. Default is the first tab.
113
114 removetab NAME
115 Remove tab.
116
117 renametab NAME NEW_NAME
118 Rename tab.
119
120
121
122 exporttab FILE_NAME
123 Export items to file.
124
125 importtab FILE_NAME
126 Import items from file.
127
128
129
130 config List all options.
131
132 config OPTION
133 Get option value.
134
135 config OPTION VALUE
136 Set option value.
137
138
139
140 eval, -e [SCRIPT] [ARGUMENTS]...
141 Evaluate ECMAScript program. Arguments are accessible using
142 with "arguments[0..N]".
143
144 session, -s, --session SESSION
145 Starts or connects to application instance with given session
146 name.
147
148 help, -h, --help [COMMAND]...
149 Print help for COMMAND or all commands.
150
151
152
154 Use dash argument (-) to read data from standard input.
155
156 Use double-dash argument (--) to read all following arguments without
157 expanding escape sequences (i.e. \n, \t and others).
158
159 Use ? for MIME to print available MIME types (default is "text/plain").
160
161
162
164 Insert some texts to the history:
165 copyq add "first item" "second item" "third item"
166
167
168 Print content of the first three items:
169 copyq read 0 1 2 copyq separator "," read 0 1 2
170
171
172 Show current clipboard content:
173 copyq clipboard copyq clipboard text/html copyq clipboard \? #
174 lists formats in clipboard
175
176
177 Copy text to the clipboard:
178 copyq copy "Some Text"
179
180
181 Load file content into clipboard:
182 copyq copy - < file.txt copyq copy text/html < index.html copyq
183 copy image/jpeg - < image.jpg
184
185
186 Create an image items:
187 copyq write image/gif - < image.gif copyq write image/svg - <
188 image.svg
189
190
191
193 https://copyq.readthedocs.io/
194
195
196
198 The maintainer of CopyQ is Lukas Holecek <hluk@email.cz>. A comprehen‐
199 sive list of authors and contributors is available in the AUTHORS file.
200
201 This manual page was written by GengYu Rao (zouyoo@outlook.com), for
202 the Debian project (and may be used by others).
203
204
205
206 CopyQ(1)