Scroll to navigation

CopyQ(1) General Commands Manual CopyQ(1)


CopyQ - Clipboard Manager with Advanced Features


copyq [COMMAND]


CopyQ is advanced clipboard manager with editing and scripting features. It monitors system clipboard and saves its content in customized tabs. Saved clipboard can be later copied and pasted directly into any application.


Starts server if no command is specified.

Show main window and optionally open tab with given name.
Hide main window.
Show or hide main window.
Open context menu.
Exit server.
Disable or enable clipboard content storing.

Print clipboard content.
Print X11 selection content.
Paste clipboard to current window (may not work with some applications).
Set clipboard text.
Set clipboard content.

Print amount of items in current tab.
Copy item in the row to clipboard.
Copy next item from current tab to clipboard.
Copy previous item from current tab to clipboard.
Add text into clipboard.
Insert text into given row.
Remove items in given rows.
Edit items or edit new one. Value -1 is for current text in clipboard.

Set separator for items on output.
Print raw data of clipboard or item in row.
Write raw data to given row.

Show action dialog.
Run PROGRAM on item text in the rows. Use %1 in PROGRAM to pass text as argument.
Show tray popup message for TIME milliseconds.

List available tab names.
Run command on tab with given name. Tab is created if it doesn't exist. Default is the first tab.
Remove tab.
Rename tab.

Export items to file.
Import items from file.

List all options.
Get option value.
Set option value.

Evaluate ECMAScript program. Arguments are accessible using with "arguments[0..N]".
Starts or connects to application instance with given session name.
Print help for COMMAND or all commands.


Use dash argument (-) to read data from standard input.

Use double-dash argument (--) to read all following arguments without expanding escape sequences (i.e. \n, \t and others).

Use ? for MIME to print available MIME types (default is "text/plain").


copyq add "first item" "second item" "third item"

copyq read 0 1 2 copyq separator "," read 0 1 2

copyq clipboard copyq clipboard text/html copyq clipboard \? # lists formats in clipboard

copyq copy "Some Text"

copyq copy - < file.txt copyq copy text/html < index.html copyq copy image/jpeg - < image.jpg

copyq write image/gif - < image.gif copyq write image/svg - < image.svg



The maintainer of CopyQ is Lukas Holecek <>. A comprehensive list of authors and contributors is available in the AUTHORS file.

This manual page was written by GengYu Rao (, for the Debian project (and may be used by others).