CopyQ

hlukGPL-3.0活跃维护

跨平台剪贴板管理器,能保存历史记录、搜索和编辑内容,还支持脚本自动化,解决复制粘贴内容容易丢失、难以复用的问题。

Clipboard manager with advanced features

v17.0.0发布于 2026-10-06 16:46 UTC12,627star +18 / 7 天630fork同步于 2026-11-10 11:28 UTC

怎么上手

由 README 提炼,执行前请确认
scoop install copyq
choco install copyq
brew install --cask copyq
chmod +x CopyQ-*.AppImage && ./CopyQ-*.AppImage
硬件要求按 README 说明

README 未说明硬件要求;支持 Linux、Windows 和 macOS 13+,macOS 版本主要取决于 Qt 版本

下载:源码 zip·GitHub Releases(安装包)本站不镜像安装包

项目说明

由 README 自动翻译提炼

跨平台剪贴板管理器,把复制过的文本、图片和自定义格式都存进可搜索的标签页里

跨平台剪贴板管理器,能保存历史记录、搜索和编辑内容,还支持脚本自动化,解决复制粘贴内容容易丢失、难以复用的问题。

核心能力

  • 监控系统剪贴板并按自定义标签页保存历史
  • 支持文本、HTML、图片及任意自定义格式
  • 用全局快捷键、托盘或主窗口快速筛选并回贴条目
  • 通过命令对话框和脚本 API 自定义动作与快捷键
  • 可忽略指定窗口或含指定文本的剪贴板内容

容易踩的坑

命令行操作前必须先启动 CopyQ 主程序,否则无法执行命令;macOS 若提示「CopyQ is damaged」需手动执行 xattr 和 codesign 命令修复;Ubuntu 官方 PPA 已停止维护,需改用发行版自带包或 AppImage/Flatpak;add 命令中省略 -- 会让反斜杠被当作转义字符处理

内容由模型根据 README 生成,可能不完整或不准确,以官方文档为准。看原文 README

最近发版

5 个版本v17.0.0
  1. 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 Support on macOS (#3692, #3693). State path can be changed using COPYQ_STATE_PATH environment 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).

  2. 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_limit config option and COPYQ_CLIPBOARD_MIME_SIZE_LIMIT environment variable. For example text/html.*:0;.*:100M disables storing HTML and sets 100MiB max size for all other formats (this size limit is the default: .*:100M).

    • AppImage support (WITH_APPIMAGE CMake 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).

  3. 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.

  4. 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_ENCRYPTION and WITH_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_DIR environment variable (if COPYQ_LOG_FILE is not used).

    • GNOME: Clipboard monitoring support using a custom GNOME extension (#2342, #1243).

    • X11: Portal for global shortcuts can be enabled with COPYQ_USE_PORTAL environment variable.

    Changed

    • Long texts in the editor are no longer syntax-highlighted to avoid slowdowns (#3340).

    • ItemSelection() and selectItems() 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_ms can now be changed via config() (#3286).

    • Use COPYQ_LOG_FILE for 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.

  5. 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.

用户点评

登录用户的真实使用记录,可按版本和硬件筛选
共 0 条

    还没有人点评。第一个说出真实体验的人最有价值。

    README 原文

    未翻译

    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

    • 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

    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:

    • 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 (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:

    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: