1CopyQ(1)                    General Commands Manual                   CopyQ(1)
2
3
4

NAME

6       CopyQ - Clipboard Manager with Advanced Features
7
8
9

SYNOPSIS

11       copyq [COMMAND]
12
13
14

DESCRIPTION

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

COMMANDS

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

NOTES

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

EXAMPLES

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

SEE ALSO

193       https://copyq.readthedocs.io/
194
195
196

AUTHOR

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)
Impressum