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.
- 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
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.
choco install copyq
On OS X you can use Homebrew to install the app.
brew cask install copyq
Debian 10+, Ubuntu 18.04+, and their derivatives
copyq-plugins is highly recommended.
Install and keep CopyQ always up to date by running the following three commands from the terminal:
sudo add-apt-repository ppa:hluk/copyq sudo apt update sudo apt install copyq
Install copyqAUR package.
Other Linux Distributions
flatpak install --user --from https://flathub.org/repo/appstream/com.github.hluk.copyq.flatpakref
Start the application from menu or with following command.
flatpak run com.github.hluk.copyq
Using the App
To start the application double-click the program icon or run
The list with clipboard history is accessible by clicking on system tray icon
Copying text or image to clipboard will create new item in the list.
Selected items can be:
- edited (
- removed (
- sorted (
- moved around (with mouse or
- copied back to clipboard (
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.
To create custom action that can be executed from menu, with shortcut or when clipboard changes:
- go to Command dialog (
- 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”.
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:
copyq --help copyq --help add
Insert some texts to the history:
copyq add "first item" "second item" "third item"
Print content of the first three items:
copyq read 0 1 2 copyq separator "," read 0 1 2
Show current clipboard content:
copyq clipboard copyq clipboard text/html copyq clipboard \? # lists formats in clipboard
Copy text to the clipboard:
copyq copy "Some Text"
Load file content into clipboard:
copyq copy - < file.txt copyq copy text/html < index.html copyq copy image/jpeg - < image.jpg
Create image items:
copyq write image/gif - < image.gif copyq write image/svg - < image.svg
Build from Source Code
To build the application from source code, first install the required dependencies:
- Optionally on Linux/X11: development files and libraries for Xtst and Xfixes
- Optionally QtWebKit (more advanced HTML rendering)
sudo apt install \ git cmake \ qtbase5-private-dev \ qtscript5-dev \ qttools5-dev \ qttools5-dev-tools \ libqt5svg5-dev \ libxfixes-dev \ libxtst-dev \ libqt5svg5
RHEL / CentOS
sudo yum install \ gcc-c++ git cmake \ libXtst-devel libXfixes-devel \ qt5-qtbase-devel \ qt5-qtsvg-devel \ qt5-qttools-devel \ qt5-qtscript-devel
Build the App
Change install prefix if needed:
git clone https://github.com/hluk/CopyQ.git cd CopyQ cmake -DCMAKE_INSTALL_PREFIX=/usr/local . make
Install the App
sudo make install
You can help translate the application (click the banner below) or help fix issues and implement new features.