CopyQ

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

Features

• Support for Linux, Windows and OS X 10.9+
• Store text, HTML, images or any other custom formats
• Quickly browse and filter items in clipboard history
• Sort, create, edit, remove, copy/paste, drag’n’drop items in tabs
• Add notes or tags to items
• System-wide shortcuts with customizable commands
• Paste items with shortcut or from tray or main window
• Fully customizable appearance
• Advanced command-line interface and scripting
• Ignore clipboard copied from some windows or containing some text
• Support for simple Vim-like editor and shortcuts
• Many more features

Install

To install CopyQ, use the binary package or installer provided for your system. For unlisted systems, please follow the instructions in Build from Source Code.

Windows

On Windows you can use one of the following options to install the app:

• The Installer (setup.exe)
• Portable zip package
• Scoop package from the extras bucket.
• Chocolatey package

Using Scoop: Using Chocolatey:

OS X

On OS X you can use Homebrew to install the app.

Debian 10+, Ubuntu 18.04+, and their derivatives

Install copyq package. copyq-plugins is highly recommended. copyq-doc available.

Ubuntu PPA

Install and keep CopyQ always up to date by running the following three commands from the terminal:

Fedora

Install copyq package.

Arch Linux

Install copyq package.

Other Linux Distributions

Install Flatpak and com.github.hluk.copyq from Flathub. Start the application from menu or with following command:

Using the App

To start the application double-click the program icon or run copyq. The list with clipboard history is accessible by clicking on system tray icon or running copyq toggle. Copying text or image to clipboard will create new item in the list. Selected items can be:

• edited (F2)
• removed (Delete)
• sorted (Ctrl+Shift+S, Ctrl+Shift+R)
• moved around (with mouse or Ctrl+Up/Down)
• copied back to clipboard (Ctrl+C)
• pasted to previously active window (Enter)

All items will be restored when application is started next time. To exit the application select Exit from tray menu or press Ctrl-Q keys in the application window. Read more:

• Basic Usage
• Keyboard

Adding Functionality

To create custom action that can be executed from menu, with shortcut or when clipboard changes:

• go to Command dialog (F6 shortcut),
• click Add button and select predefined command or create new one,
• optionally change the command details (shortcut, name),
• click OK to save the command.

One of very useful predefined commands there is “Show/hide main window”. Read more:

• Writing Commands
• CopyQ Commands Repository

Command Line

CopyQ has powerful command line and scripting interface. Note: The main application must be running to be able to issue commands using command line. Print help for some useful command line arguments: Insert some texts to the history: Omitting double-dash (--) in the command above would mean that slash (\) in arguments will be treated as special character so that \n is new line character, \t is tab, \\ is slash, \x is x etc. Create single item containing two lines: Print content of the first three items: Show current clipboard content: Copy text to the clipboard: Load file content into clipboard: Create image items: Read more:

• Scripting
• Scripting API

Build from Source Code

To build the application from source code, first install the required dependencies:

• Git
• CMake
• Qt
• optional on Linux/X11: development files and libraries for Xtst and Xfixes

Install Dependencies

Ubuntu

RHEL / CentOS

Build the App

Change install prefix if needed: You can now run the built app.