Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://hluk.github.io/CopyQ/
Clipboard manager with advanced features
https://hluk.github.io/CopyQ/
clipboard clipboard-manager copyq cross-platform scripting tray
Last synced: 3 months ago
JSON representation
Clipboard manager with advanced features
- Host: GitHub
- URL: https://hluk.github.io/CopyQ/
- Owner: hluk
- License: gpl-3.0
- Created: 2009-10-21T13:35:38.000Z (about 15 years ago)
- Default Branch: master
- Last Pushed: 2024-05-22T15:15:06.000Z (6 months ago)
- Last Synced: 2024-05-23T03:26:59.298Z (6 months ago)
- Topics: clipboard, clipboard-manager, copyq, cross-platform, scripting, tray
- Language: C++
- Homepage:
- Size: 37.8 MB
- Stars: 8,005
- Watchers: 134
- Forks: 422
- Open Issues: 394
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGES.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
- Security: docs/security.rst
- Authors: AUTHORS
Awesome Lists containing this project
- awesome-windows - CopyQ - Clipboard manager with advanced features. [![Open-Source Software][oss icon]](https://github.com/hluk/CopyQ) (Productivity / Virtualization)
- Mac-Menubar-Megalist - CopyQ
README
# CopyQ
[](https://copyq.readthedocs.io/en/latest/?badge=latest)
[](https://hosted.weblate.org/engage/copyq/?utm_source=widget)
[](https://github.com/hluk/CopyQ/actions?query=branch%3Amaster+event%3Apush+workflow%3A%22Linux+Build%22)
[](https://github.com/hluk/CopyQ/actions?query=branch%3Amaster+event%3Apush+workflow%3A%22macOS+Build%22)
[](https://ci.appveyor.com/project/hluk/copyq)
[](https://coveralls.io/r/hluk/CopyQ?branch=master)
CopyQ is an advanced clipboard manager with powerful editing and scripting features.
- [Downloads](https://github.com/hluk/CopyQ/releases)
- [Web Site](https://hluk.github.io/CopyQ/)
- [Documentation](https://copyq.readthedocs.io)
- [Mailing List](https://groups.google.com/group/copyq)
- [Bug Reports](https://github.com/hluk/CopyQ/issues)
- [Donate](https://liberapay.com/CopyQ/)
- [Scripting API](https://copyq.readthedocs.io/en/latest/scripting-api.html)
## Overview
* CopyQ monitors the system clipboard and saves its content in customized tabs.
* Saved clipboard entries can later be copied and pasted directly into any application.
## Features
* Support for Linux, Windows, and [OS X 10.15+](https://doc.qt.io/qt-5/macos.html#supported-versions)
* Store text, HTML, images, and 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 and tags to items
* System-wide keyboard shortcuts with customizable commands
* Paste items with keyboard shortcuts, from tray, or from main window
* Fully customizable appearance
* Advanced command-line interface and scripting
* Ignore clipboard copied from specified windows or containing specified text
* Support for simple Vim-like editor with keyboard shortcuts
* Many more features
## Install
To install CopyQ, use the binary package or the installer provided for your operating system.
For unlisted operating systems, please follow the instructions in
[Build from Source Code](https://copyq.readthedocs.io/en/latest/build-source-code.html).
### Windows
[](https://repology.org/metapackage/copyq)
On Windows you can use any of the following options to install CopyQ:
* [Installer (setup.exe)](https://github.com/hluk/CopyQ/releases)
* [Portable zip package](https://github.com/hluk/CopyQ/releases)
* [Scoop package](https://scoop.sh/) from the [extras bucket](https://github.com/lukesampson/scoop-extras).
* [Chocolatey package](https://chocolatey.org/packages/copyq)
Using Scoop:
```
scoop install copyq
```
Using Chocolatey:
```
choco install copyq
```
### OS X
[](https://repology.org/metapackage/copyq)
On OS X you can use [Homebrew](https://brew.sh/) to install CopyQ:
```bash
brew install --cask copyq
```
If you encounter an issue where the app crashes with a dialog saying "CopyQ is
damaged" or "CopyQ cannot be opened", you may need to run the following
commands (for details, see #2652):
```bash
xattr -d com.apple.quarantine /Applications/CopyQ.app
codesign --force --deep --sign - /Applications/CopyQ.app
```
### Debian 10+, Ubuntu 18.04+, and their derivatives
Install `copyq` and `copyq-plugins` packages.
#### Ubuntu PPA
Install and keep CopyQ always up to date by running the following commands from
the terminal (the package from PPA contains all plugins and documentation):
```bash
sudo add-apt-repository ppa:hluk/copyq
sudo apt update
sudo apt install copyq
```
### Fedora
Install `copyq` package.
### Arch Linux
Install `copyq` package.
### Other Linux Distributions
Install [Flatpak](https://www.flatpak.org/) and `com.github.hluk.copyq` from
[Flathub](https://flathub.org/).
```bash
flatpak install flathub com.github.hluk.copyq
```
Start CopyQ from the menu or with the following command:
```bash
flatpak run com.github.hluk.copyq
```
## Using the App
To start CopyQ, double-click the program icon or run `copyq`.
The list with the clipboard history is accessible by clicking on the system tray icon
or by running `copyq toggle`.
Copying text or image to the clipboard will create a new item in the list.
Selected items can be:
* edited (`F2`)
* removed (`Delete`)
* sorted (`Ctrl+Shift+S`, `Ctrl+Shift+R`)
* repositioned (with mouse or `Ctrl+Up/Down`)
* copied back to the clipboard (`Ctrl+C`)
* pasted to the previously active window (`Enter`)
All items will be restored when CopyQ is next started.
To exit CopyQ, select Exit from the tray menu or press `Ctrl-Q` in the
CopyQ window.
Read more:
- [Basic Usage](https://copyq.readthedocs.io/en/latest/basic-usage.html)
- [Keyboard](https://copyq.readthedocs.io/en/latest/keyboard.html)
### Adding Functionality
To create custom actions that can be executed
from the menu, with keyboard shortcuts, or when the clipboard changes:
- go to the Command dialog (`F6` shortcut)
- click the `Add` button, then select a predefined command, or create a new one
- optionally change the command details (shortcut, name)
- click `OK` to save the command
One of the very useful predefined commands is "Show/hide main window".
Read more:
- [Writing Commands](https://copyq.readthedocs.io/en/latest/writing-commands-and-adding-functionality.html)
- [CopyQ Commands Repository](https://github.com/hluk/copyq-commands)
### Command Line
CopyQ has a powerful command line and scripting interface.
Note: The main application must be running to be able to issue commands using the
command line.
Print help for some useful command line arguments:
copyq --help
copyq --help add
Insert some text in the history:
copyq add -- 'first item' 'second item' 'third item'
Omitting the double-dash (`--`) in the command above would mean that slashes
(`\`) in arguments will be treated as special characters. For example, `\n` will be treated as
the new line character, `\t` as tab, `\\` as slash, `\x` as `x`, etc.
Create a single item containing two lines:
copyq add 'first line\nsecond line'
Print the content of the first three items:
copyq read 0 1 2
copyq separator "," read 0 1 2
Show the 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 the 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
Read more:
- [Scripting](https://copyq.readthedocs.io/en/latest/scripting.html)
- [Scripting API](https://copyq.readthedocs.io/en/latest/scripting-api.html)
## Build from Source Code
To build CopyQ from source code, first install the required dependencies:
- [Git](https://git-scm.com/)
- [CMake](https://cmake.org/download/)
- [Qt](https://download.qt.io/archive/qt/)
- optional on Linux/X11: development files and libraries for [Xtst](https://t2-project.org/packages/libxtst.html) and [Xfixes](https://www.x.org/archive/X11R7.5/doc/man/man3/Xfixes.3.html)
### Install Dependencies
#### Ubuntu
```bash
sudo apt install \
cmake \
extra-cmake-modules \
git \
libqt5svg5 \
libqt5svg5-dev \
libqt5waylandclient5-dev \
libqt5x11extras5-dev \
libwayland-dev \
libxfixes-dev \
libxtst-dev \
qtbase5-private-dev \
qtdeclarative5-dev \
qttools5-dev \
qttools5-dev-tools \
qtwayland5 \
qtwayland5-dev-tools
```
#### RHEL / CentOS / Oracle Linux
```bash
sudo yum install \
cmake \
extra-cmake-modules \
gcc-c++ \
git \
libXfixes-devel \
libXtst-devel \
qt5-qtbase-devel \
qt5-qtdeclarative-devel \
qt5-qtsvg-devel \
qt5-qttools-devel \
qt5-qtwayland-devel \
qt5-qtx11extras-devel \
wayland-devel \
kf5-knotifications-devel
```
### Build CopyQ
Change install prefix if needed:
```bash
git clone https://github.com/hluk/CopyQ.git
cd CopyQ
cmake .
make
```
You can now run the built app.
```bash
./copyq
```
## Contributions
You can help translate CopyQ (click the banner below)
or help [fix issues and implement new features](https://github.com/hluk/CopyQ/issues).
[](https://hosted.weblate.org/engage/copyq/?utm_source=widget)
Read more:
- [Build from Source Code](https://copyq.readthedocs.io/en/latest/build-source-code.html)
- [Fixing Bugs and Adding Features](https://copyq.readthedocs.io/en/latest/fixing-bugs.html)
- [Translations](https://copyq.readthedocs.io/en/latest/translations.html)