{"id":15037443,"url":"https://github.com/hluk/copyq","last_synced_at":"2026-04-12T09:22:43.406Z","repository":{"id":37458211,"uuid":"344809","full_name":"hluk/CopyQ","owner":"hluk","description":"Clipboard manager with advanced features","archived":false,"fork":false,"pushed_at":"2025-05-04T06:23:29.000Z","size":40550,"stargazers_count":9704,"open_issues_count":417,"forks_count":473,"subscribers_count":139,"default_branch":"master","last_synced_at":"2025-05-09T06:57:01.551Z","etag":null,"topics":["clipboard","clipboard-manager","copyq","cross-platform","scripting","tray"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hluk.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGES.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"docs/security.rst","support":null,"governance":null,"roadmap":null,"authors":"AUTHORS","dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2009-10-21T13:35:38.000Z","updated_at":"2025-05-09T06:29:28.000Z","dependencies_parsed_at":"2023-10-17T10:15:23.727Z","dependency_job_id":"9e8b17a0-bfbc-4fd7-868e-47d0e2f0857f","html_url":"https://github.com/hluk/CopyQ","commit_stats":{"total_commits":5630,"total_committers":283,"mean_commits":19.89399293286219,"dds":"0.18987566607460038","last_synced_commit":"646f25911b1898d3b61ab7ba731a5e51cef85fe0"},"previous_names":[],"tags_count":115,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hluk%2FCopyQ","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hluk%2FCopyQ/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hluk%2FCopyQ/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hluk%2FCopyQ/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hluk","download_url":"https://codeload.github.com/hluk/CopyQ/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253514153,"owners_count":21920327,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["clipboard","clipboard-manager","copyq","cross-platform","scripting","tray"],"created_at":"2024-09-24T20:34:38.577Z","updated_at":"2026-04-02T11:55:48.313Z","avatar_url":"https://github.com/hluk.png","language":"C++","funding_links":["https://liberapay.com/CopyQ/"],"categories":[],"sub_categories":[],"readme":"# CopyQ\n\n[![Documentation Status](https://readthedocs.org/projects/copyq/badge/?version=latest)](https://copyq.readthedocs.io/en/latest/?badge=latest)\n[![Translation Status](https://hosted.weblate.org/widgets/copyq/-/svg-badge.svg)](https://hosted.weblate.org/engage/copyq/?utm_source=widget)\n[![Linux Build Status](https://github.com/hluk/CopyQ/actions/workflows/build-linux.yml/badge.svg?branch=master\u0026event=push)](https://github.com/hluk/CopyQ/actions?query=branch%3Amaster+event%3Apush+workflow%3ALinux)\n[![macOS Build Status](https://github.com/hluk/CopyQ/actions/workflows/build-macos.yml/badge.svg?branch=master\u0026event=push)](https://github.com/hluk/CopyQ/actions?query=branch%3Amaster+event%3Apush+workflow%3AmacOS)\n[![Windows Build Status](https://github.com/hluk/CopyQ/actions/workflows/build-windows.yml/badge.svg?branch=master\u0026event=push)](https://github.com/hluk/CopyQ/actions?query=branch%3Amaster+event%3Apush+workflow%3AWindows)\n[![Coverage Status](https://codecov.io/gh/hluk/CopyQ/branch/master/graph/badge.svg)](https://codecov.io/gh/hluk/CopyQ)\n\nCopyQ is an advanced clipboard manager with powerful editing and scripting features.\n\n- [Downloads](https://github.com/hluk/CopyQ/releases)\n- [Web Site](https://hluk.github.io/CopyQ/)\n- [Documentation](https://copyq.readthedocs.io)\n- [Mailing List](https://groups.google.com/group/copyq)\n- [Bug Reports](https://github.com/hluk/CopyQ/issues)\n- [Donate](https://liberapay.com/CopyQ/)\n- [Scripting API](https://copyq.readthedocs.io/en/latest/scripting-api.html)\n\n## Overview\n\n* CopyQ monitors the system clipboard and saves its content in customized tabs.\n* Saved clipboard entries can later be copied and pasted directly into any application.\n\n## Features\n\n* Support for Linux, Windows, and [macOS 13+](https://doc.qt.io/qt-6/macos.html)\n* Store text, HTML, images, and any other custom formats\n* Quickly browse and filter items in clipboard history\n* Sort, create, edit, remove, copy/paste, drag'n'drop items in tabs\n* Add notes and tags to items\n* System-wide keyboard shortcuts with customizable commands\n* Paste items with keyboard shortcuts, from tray, or from main window\n* Fully customizable appearance\n* Advanced command-line interface and scripting\n* Ignore clipboard copied from specified windows or containing specified text\n* Support for simple Vim-like editor with keyboard shortcuts\n* Many more features\n\n## Install\n\n\u003ca href=\"https://repology.org/metapackage/copyq\"\u003e\n    \u003cimg src=\"https://repology.org/badge/vertical-allrepos/copyq.svg\" alt=\"Packaging status\" align=\"right\"\u003e\n\u003c/a\u003e\n\nTo install CopyQ, use the binary package or the installer provided for your operating system.\n\nFor unlisted operating systems, please follow the instructions in\n[Build from Source Code](https://copyq.readthedocs.io/en/latest/build-source-code.html).\n\n### Windows\n\n[![Chocolatey package](https://repology.org/badge/version-for-repo/chocolatey/copyq.svg)](https://repology.org/metapackage/copyq)\n\nOn Windows you can use any of the following options to install CopyQ:\n\n* [Installer (setup.exe)](https://github.com/hluk/CopyQ/releases)\n* [Portable zip package](https://github.com/hluk/CopyQ/releases)\n* [Scoop package](https://scoop.sh/) from the [extras bucket](https://github.com/lukesampson/scoop-extras).\n* [Chocolatey package](https://chocolatey.org/packages/copyq)\n\nUsing Scoop:\n\n```\nscoop install copyq\n```\n\nUsing Chocolatey:\n\n```\nchoco install copyq\n```\n\n### macOS\n\nmacOS 13 and above are supported (this mainly depends on the [Qt version](https://doc.qt.io/qt-6/macos.html)).\n\n[![Homebrew package](https://repology.org/badge/version-for-repo/homebrew_casks/copyq.svg)](https://repology.org/metapackage/copyq)\n\nOn macOS you can use [Homebrew](https://brew.sh/) to install CopyQ:\n\n```bash\nbrew install --cask copyq\n```\n\nIf you encounter an issue where the app crashes with a dialog saying \"CopyQ is\ndamaged\" or \"CopyQ cannot be opened\", you may need to run the following\ncommands (for details, see #2652):\n\n```bash\nxattr -d com.apple.quarantine /Applications/CopyQ.app\ncodesign --force --deep --sign - /Applications/CopyQ.app\n```\n\n### Debian 11+, Ubuntu 22.04+, and their derivatives\n\nInstall `copyq` and `copyq-plugins` packages.\n\n#### Ubuntu PPA\n\nInstall and keep CopyQ always up to date by running the following commands from\nthe terminal (the package from PPA contains all plugins and documentation):\n\n```bash\nsudo apt install software-properties-common python-software-properties\nsudo add-apt-repository ppa:hluk/copyq\nsudo apt update\nsudo apt install copyq\n# this package contains all plugins and documentation\n```\n\n### Fedora\n\nInstall `copyq` package.\n\n### Arch Linux\n\nInstall `copyq` package.\n\n### Other Linux Distributions\n\nInstall [Flatpak](https://flatpak.org/) and `com.github.hluk.copyq` from\n[Flathub](https://flathub.org/).\n\n```bash\nflatpak install flathub com.github.hluk.copyq\n```\n\nStart CopyQ from the menu or with the following command:\n\n```bash\nflatpak run com.github.hluk.copyq\n```\n\n## Using the App\n\nTo start CopyQ, double-click the program icon or run `copyq`.\n\nThe list with the clipboard history is accessible by clicking on the system tray icon\nor by running `copyq toggle`.\n\nCopying text or image to the clipboard will create a new item in the list.\n\nSelected items can be:\n\n* edited (`F2`)\n* removed (`Delete`)\n* sorted (`Ctrl+Shift+S`, `Ctrl+Shift+R`)\n* repositioned (with mouse or `Ctrl+Up/Down`)\n* copied back to the clipboard (`Ctrl+C`)\n* pasted to the previously active window (`Enter`)\n\nAll items will be restored when CopyQ is next started.\n\nTo exit CopyQ, select Exit from the tray menu or press `Ctrl-Q` in the\nCopyQ window.\n\nRead more:\n\n- [Basic Usage](https://copyq.readthedocs.io/en/latest/basic-usage.html)\n- [Keyboard](https://copyq.readthedocs.io/en/latest/keyboard.html)\n\n### Adding Functionality\n\nTo create custom actions that can be executed\nfrom the menu, with keyboard shortcuts, or when the clipboard changes:\n- go to the Command dialog (`F6` shortcut)\n- click the `Add` button, then select a predefined command, or create a new one\n- optionally change the command details (shortcut, name)\n- click `OK` to save the command\n\nOne of the very useful predefined commands is \"Show/hide main window\".\n\nRead more:\n\n- [Writing Commands](https://copyq.readthedocs.io/en/latest/writing-commands-and-adding-functionality.html)\n- [CopyQ Commands Repository](https://github.com/hluk/copyq-commands)\n\n### Command Line\n\nCopyQ has a powerful command line and scripting interface.\n\nNote: The main application must be running to be able to issue commands using the\ncommand line.\n\nPrint help for some useful command line arguments:\n\n    copyq --help\n    copyq --help add\n\nInsert some text in the history:\n\n    copyq add -- 'first item' 'second item' 'third item'\n\nOmitting the double-dash (`--`) in the command above would mean that slashes\n(`\\`) in arguments will be treated as special characters.  For example, `\\n` will be treated as\nthe new line character, `\\t` as tab, `\\\\` as slash, `\\x` as `x`, etc.\n\nCreate a single item containing two lines:\n\n    copyq add 'first line\\nsecond line'\n\nPrint the content of the first three items:\n\n    copyq read 0 1 2\n    copyq separator \",\" read 0 1 2\n\nShow the current clipboard content:\n\n    copyq clipboard\n    copyq clipboard text/html\n    copyq clipboard \\?    # lists formats in clipboard\n\nCopy text to the clipboard:\n\n    copyq copy \"Some Text\"\n\nLoad file content into the clipboard:\n\n    copyq copy - \u003c file.txt\n    copyq copy text/html \u003c index.html\n    copyq copy image/jpeg - \u003c image.jpg\n\nCreate image items:\n\n    copyq write image/gif - \u003c image.gif\n    copyq write image/svg - \u003c image.svg\n\nRead more:\n\n- [Scripting](https://copyq.readthedocs.io/en/latest/scripting.html)\n- [Scripting API](https://copyq.readthedocs.io/en/latest/scripting-api.html)\n\n## Build from Source Code\n\nSee the documentation section [Build from Source\nCode](https://copyq.readthedocs.io/en/latest/build-source-code.html).\n\n## Contributions\n\nYou can help translate CopyQ (click the banner below)\nor help [fix issues and implement new features](https://github.com/hluk/CopyQ/issues).\n\n[![Translations](https://hosted.weblate.org/widgets/copyq/-/287x66-white.png)](https://hosted.weblate.org/engage/copyq/?utm_source=widget)\n\nRead more:\n\n- [Build from Source Code](https://copyq.readthedocs.io/en/latest/build-source-code.html)\n- [Fixing Bugs and Adding Features](https://copyq.readthedocs.io/en/latest/fixing-bugs.html)\n- [Translations](https://copyq.readthedocs.io/en/latest/translations.html)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhluk%2Fcopyq","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhluk%2Fcopyq","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhluk%2Fcopyq/lists"}