Installation
============

Packages and installation files are available at `Releases page <https://github.com/hluk/CopyQ/releases>`__.

Alternatively, you can install the app with one of the following methods:

On **Windows**, you can install `Chocolatey package <https://chocolatey.org/packages/copyq>`__.

On **macOS** (13 and above), you can use `Homebrew <https://brew.sh/>`__ to install the app
(also see the problem in the next section):

.. code-block:: bash

    brew install --cask copyq

On **macOS**, 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 `issue #2652
<https://github.com/hluk/CopyQ/issues/2652>`__):

.. code-block:: bash

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

On **macOS**, after Homebrew installation, the ``copyq`` CLI command is not
available by default. To enable CLI access, create a symlink manually:

.. code-block:: bash

    sudo ln -sf /Applications/CopyQ.app/Contents/MacOS/CopyQ /usr/local/bin/copyq

After this, you can use the CLI:

.. code-block:: bash

    copyq --version
    copyq clipboard
    copyq size

On **Debian** and **Ubuntu+** install a stable version from official
repositories:

.. code-block:: bash

    sudo apt install copyq
    # copyq-plugins and copyq-doc is split out and can be installed independently

On **Fedora**, install "copyq" package:

.. code-block:: bash

    sudo dnf install copyq

On other Linux distributions, you can download the **AppImage** from the
`Releases page <https://github.com/hluk/CopyQ/releases>`__:

.. code-block:: bash

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

Alternatively, you can use `Flatpak <https://flatpak.org/>`__ to install
`CopyQ from Flathub <https://flathub.org/apps/com.github.hluk.copyq>`__.
See `Flathub Setup <https://flathub.org/setup>`__ for initial Flatpak/Flathub
configuration.

To start CopyQ from the command line:

.. code-block:: bash

    flatpak run com.github.hluk.copyq
