CopyQ README

The project's README from github.com/hluk/CopyQ. As one markdown file: README.md.

CopyQ

Documentation Status Translation Status Linux Build Status macOS Build Status Windows Build Status Coverage Status

CopyQ is an advanced clipboard manager with powerful editing and scripting features.

Overview

Features

Install

Packaging status

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.

Windows

Chocolatey package

On Windows you can use any of the following options to install CopyQ:

Using Scoop:

scoop install copyq

Using Chocolatey:

choco install copyq

macOS

macOS 13 and above are supported (this mainly depends on the Qt version).

Homebrew package

On macOS you can use Homebrew to install CopyQ:

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

xattr -d com.apple.quarantine /Applications/CopyQ.app
codesign --force --deep --sign - /Applications/CopyQ.app

Debian 11+, Ubuntu 22.04+, and their derivatives

Install copyq and copyq-plugins packages.

Ubuntu PPA

The official PPA (ppa:hluk/copyq) is no longer maintained. Install the packages provided for your distribution.

See the announcement.

Fedora

Install copyq package.

Arch Linux

Install copyq package.

Other Linux Distributions

Download the latest AppImage from GitHub Releases:

chmod +x CopyQ-*.AppImage
./CopyQ-*.AppImage

Alternatively, install Flatpak and com.github.hluk.copyq from Flathub. See Flathub Setup for initial Flatpak/Flathub configuration.

Start CopyQ from the menu or with the following command:

flatpak run com.github.hluk.copyq

Using the App

To start CopyQ, double-click the program icon or run copyq (on Windows, run CopyQ.exe, or launch it from the Start menu; no desktop icon is created by default).

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:

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:

Adding Functionality

To create custom actions that can be executed from the menu, with keyboard shortcuts, or when the clipboard changes:

One of the very useful predefined commands is "Show/hide main window".

Read more:

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:

Build from Source Code

See the documentation section Build from Source Code.

Contributions

You can help translate CopyQ (click the banner below) or help fix issues and implement new features.

Translations

Read more:

CopyQ (hluk/CopyQ)

Searching Database…

12.5K ·GitHub
CopyQ
Что это такое?CopyQ — продвинутый менеджер буфера обмена: он следит за системным буфером обмена и сохраняет его содержимое во вкладки, которые можно настраивать, чтобы просматривать, искать и повторно использовать прошлые записи.
Это фоновое приложение в трее или что-то другое?Это настольное приложение, которое работает в системном трее, хранит постоянное окно истории, а также предоставляет интерфейс командной строки и скриптов для автоматизации.
Как установить и начать пользоваться?Установите через установщик для Windows, портативный zip, Scoop или Chocolatey; через Homebrew на macOS; через пакет вашего дистрибутива Linux, PPA/Flatpak или AppImage. После установки запустите 'copyq' (или CopyQ.exe в Windows) и щёлкните значок в трее или выполните 'copyq toggle', чтобы открыть историю буфера обмена.
Нужно ли сначала что-то установить, например Homebrew?На macOS его устанавливают через Homebrew, а в Linux вместо нативных пакетов дистрибутива можно использовать Flatpak/Flathub; для самого приложения никакая другая среда выполнения не нужна.
Есть ли при установке подводные камни, о которых стоит знать?На macOS после установки Gatekeeper может показать ошибку 'CopyQ is damaged' или 'CopyQ cannot be opened', и тогда потребуется вручную исправить её через терминал; кроме того, PPA для Ubuntu больше не поддерживается.
Какие операционные системы поддерживаются на самом деле?Поддерживаются Linux, Windows и macOS 13 и новее.
Какие типы содержимого, кроме простого текста, можно сохранять?Можно сохранять текст, HTML, изображения и другие пользовательские форматы буфера обмена, а также добавлять к сохранённым элементам заметки и теги.
Можно ли автоматизировать действия при изменении буфера обмена?Да, можно создавать собственные команды через диалог команд (F6), которые запускаются по горячим клавишам, из меню трея или автоматически при каждом изменении буфера обмена.
Что можно делать с интерфейсом командной строки?CLI 'copyq' позволяет добавлять, читать, копировать и записывать элементы буфера обмена любого формата (текст, HTML, изображения) прямо из скриптов, например 'copyq add first item' или 'copyq copy image/jpeg - < image.jpg'.
Можно ли исключить из записи определённые приложения или текст?Да, CopyQ может игнорировать содержимое буфера обмена, скопированное из указанных окон, или содержимое, в котором есть указанный текст.
What are similar projects?AutoHotkey, gyotaku, deskflow, Gource, TranslucentTB, msime-windows, lanmessenger, snow-apps
Which topics is it in?clipboard-manager, clipboard, tray, scripting, cpp, c++, utility, command-line, desktop, gplv3, productivity, gui
Creator
hluk
Size
44.4 MB
Stars
12.5K
Updated
CommitOct 17Releasev17.0.0Oct 06
Age
16y
Commits · 90 Days