命令行操作前必须先启动 CopyQ 主程序,否则无法执行命令;macOS 若提示「CopyQ is damaged」需手动执行 xattr 和 codesign 命令修复;Ubuntu 官方 PPA 已停止维护,需改用发行版自带包或 AppImage/Flatpak;add 命令中省略 -- 会让反斜杠被当作转义字符处理
scoop install copyq
choco install copyq
brew install --cask copyq
chmod +x CopyQ-*.AppImage && ./CopyQ-*.AppImageREADME 未说明硬件要求;支持 Linux、Windows 和 macOS 13+,macOS 版本主要取决于 Qt 版本
跨平台剪贴板管理器,把复制过的文本、图片和自定义格式都存进可搜索的标签页里
跨平台剪贴板管理器,能保存历史记录、搜索和编辑内容,还支持脚本自动化,解决复制粘贴内容容易丢失、难以复用的问题。
核心能力
- 监控系统剪贴板并按自定义标签页保存历史
- 支持文本、HTML、图片及任意自定义格式
- 用全局快捷键、托盘或主窗口快速筛选并回贴条目
- 通过命令对话框和脚本 API 自定义动作与快捷键
- 可忽略指定窗口或含指定文本的剪贴板内容
容易踩的坑
- v17.0.017.0.0最新正式版2026-10-06 · 2026-10-06 16:46 UTC
Added
- Adds support for GNOME 50 (#3677).
Changed
-
Tab data and state files are moved to XDG-compliant directories,
%LOCALAPPDATA%on Windows and~/Library/Application Supporton macOS (#3692, #3693). State path can be changed usingCOPYQ_STATE_PATHenvironment variable.Important: This is backwards incompatible. The data and state files are moved when the new app version starts. Older versions of the app will not see these files and basically lose all items.
-
FakeVim is updated from upstream repository.
Fixed
-
Fixes audio engine always using a small amount of CPU and indicating (on KDE) that it plays audio (#3684). The engine is initialized only when needed and released after it stops playing all audio.
-
Fixes initial script dialog size (#3700). Thanks to @wyf-777.
-
Fixes slow tab icon lookups when the app contains many item tabs (#3721). Thanks to @jkindrix (Justin Kindrix).
-
Fixes keeping old tabs in configuration (#3722). Thanks to @sakashimaa.
-
Windows: Prevents app from attempting (unsuccessfully) to paste to windows the user cannot switch back to (#2556). Thanks to @ntzb.
-
Wayland: Fixes global shortcuts failing when portal service starts later or restarts (#3616, #3680).
-
Wayland: Fixes global shortcuts in non-default sessions (#3713).
-
Wayland: Fixes rebinding global shortcuts on start (#3678). Thanks to @Memoraike (Meow).
-
Synchronize plugin: Fixes GUI freeze when removing items and on startup and retrying to remove absent files (#3629, #3697).
- v16.0.016.0.02026-05-30 · 2026-05-30 05:27 UTC
查看更新说明
Added
-
Per-MIME clipboard size limits and OOM protection via
clipboard_mime_size_limitconfig option andCOPYQ_CLIPBOARD_MIME_SIZE_LIMITenvironment variable. For exampletext/html.*:0;.*:100Mdisables storing HTML and sets 100MiB max size for all other formats (this size limit is the default:.*:100M). -
AppImage support (
WITH_APPIMAGECMake build option).
Fixed
-
Fixed thumbnails hidden for tagged image items if "Show simple items" option is enabled (#3602).
-
Fixed window invisible in remote desktop sessions (#3593, #3582, #3400).
-
Fixed null characters in concatenated selected items breaking paste in other applications.
-
Handle possible file operation errors and locks when synchronizing items to files on disk and shared storage (#3368, #3579).
-
Avoids potential crash on fetching very large data in clipboard.
-
Wayland: Fixed portal shortcuts handling in non-default app sessions.
-
Wayland: Fixed main window shown on startup with tray disabled on wlroots compositors (#3567).
-
- v15.0.015.0.02026-04-12 · 2026-04-12 07:23 UTC
查看更新说明
Added
-
CSS properties for pinned/notes indicator color and width. See Plugin Indicators.
ItemPinned { qproperty-pinnedIndicatorColor: rgba(0, 0, 255, 128); } ItemPinned[CopyQ_selected="true"] { qproperty-pinnedIndicatorColor: rgba(255, 204, 0, 255); } ItemNotes { qproperty-notesIndicatorColor: rgba(100, 200, 100, 180); } ItemNotes { qproperty-notesIndicatorWidth: 24; } -
One Dark theme. Thanks to @jetm (Javier Tia).
-
Diagnostic information in About dialog and version output for easier troubleshooting.
-
Script function
stats()now includes per-process memory information.
Changed
-
"Show under mouse cursor" shortcut now hides the window if it is already visible (#2272).
-
Updated icon font to Font Awesome 7.2.0.
-
Dropped private Qt header usage (replaced with public QNativeInterface API).
Note for packagers: The application no longer links against private Qt headers, so it does not need to be rebuilt on Qt minor version updates.
-
Dropped support for unmaintained Qt 5 version of the app.
-
Improved performance of scripts.
Fixed
-
Fixed blank items appearing in search results.
-
Fixed rounded item corners showing wrong background color.
-
Fixed item background rendering on some systems and themes (#3495).
-
Fixed item vertical misalignment (missing top margin).
-
Fixed tray icon not showing before encryption password prompt (#3502).
-
Fixed tray menu not showing on Wayland when triggered via shortcut (#3325).
-
Fixed version string (#3516).
-
Fixed crash when accessing invalid ItemSelection.
-
Fixed item scrollbar colors.
-
Fixed a memory leak in clipboard monitor process and other long running client processes.
-
Windows: Excludes unnecessary test executable and some libraries from installer and portable zip.
-
- v14.0.014.0.02026-03-24 · 2026-03-24 06:53 UTC
查看更新说明
Added
-
Tab encryption support. Allows encrypting all tab data on disk using a single custom password. Common keychain software to store the password can be also enabled with password expiration (locking tabs).
Note for packagers: This requires QCA and QtKeychain libraries, but it can be disabled at build time with CMake options
WITH_QCA_ENCRYPTIONandWITH_KEYCHAIN(#2617). -
Audio playback via
playSound()script function for playing WAV, MP3 and FLAC files.Note for packagers: This requires miniaudio library, but it can be disabled at build time with CMake option
WITH_AUDIO. -
New script function
stats()for gathering runtime statistics (memory usage, UI elements, tab state, loaded plugins, running actions). -
Nord themes. Thanks to @ArtyomBabiy.
-
Theme is applied to the About dialog (#3296).
-
Log directory can be changed using
COPYQ_LOG_DIRenvironment variable (ifCOPYQ_LOG_FILEis not used). -
GNOME: Clipboard monitoring support using a custom GNOME extension (#2342, #1243).
-
X11: Portal for global shortcuts can be enabled with
COPYQ_USE_PORTALenvironment variable.
Changed
-
Long texts in the editor are no longer syntax-highlighted to avoid slowdowns (#3340).
-
ItemSelection()andselectItems()preserve the original selection order (#3271). -
"Show the tray menu" command is excluded from the tray menu (#3353).
-
Content dialog now shows data for the first format when opened (#3404).
-
Option
close_on_unfocus_extra_delay_mscan now be changed viaconfig()(#3286). -
Use
COPYQ_LOG_FILEfor logging into single file without adding extra suffix for process PID. -
Tests are no longer part of the application (#3274).
-
X11: Reduced blocking calls when showing the main window, improving responsiveness after idle (#2877).
Fixed
-
Fixes pinned item duplication on clipboard re-read (#3131, #3042).
-
Fixes potential data loss on partial tab rename failure during drag-and-drop.
-
Fixes drag-and-drop expanding collapsed tab groups.
-
Fixes window becoming invisible when started minimized (#3440).
-
Fixes
showAt()when the main window is maximized; restores original geometry afterward (#3412, #3384). -
Fixes hiding the main window from the tray menu (#3352).
-
Fixes overriding selection data in automatic commands (#3324).
-
Fixes "Hide from screenshots" option state in Preferences.
-
Fixes reading environment variables in correct encoding.
-
Fixes copy/paste error handling (#3428).
-
Synchronize plugin: Fixes updating items after they are moved (#3424).
-
macOS: Fixes tray menu not appearing and crash on paste.
-
Windows: Fixes copy/paste with the Win modifier held (#3398).
-
Windows: Fixes default installation folder for single-user mode (#3358).
-
Windows: Fixes overriding custom
COPYQ_LOG_FILE.
-
- v13.0.013.0.02025-10-22 · 2025-10-22 09:53 UTC
查看更新说明
Added
- Windows: Preferences now include auto-start option, previously available only in the installer.
Changed
-
Tabs synchronized with a directory on the disk will now include files from sub-directories (#2638).
-
Filtering/searching items in large tabs no longer blocks UI (#3111, #3261).
Fixed
-
Fixes saving edited HTML and setting style in internal editor (#3227).
-
Fixes updating selected item colors (#3219).
-
Wayland: Fixes clipboard access in KDE Plasma 6.5 (#3228). This requires KGuiAddons library installed on the system.
用户点评
登录用户的真实使用记录,可按版本和硬件筛选还没有人点评。第一个说出真实体验的人最有价值。
CopyQ
CopyQ is an advanced clipboard manager with powerful editing and scripting features.
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 macOS 13+
- 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.
Windows
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).
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:
- 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:
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 (
F6shortcut) - click the
Addbutton, then select a predefined command, or create a new one - optionally change the command details (shortcut, name)
- click
OKto save the command
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.
Read more:
