base on Clipboard manager with advanced features # 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 <a href="https://repology.org/metapackage/copyq"> <img src="https://repology.org/badge/vertical-allrepos/copyq.svg" alt="Packaging status" align="right"> </a> 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) ", Assign "at most 3 tags" to the expected json: {"id":"8631","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"