Known Issues
This document lists known commonly occurring issues and possible solutions.
On Windows, CopyQ does not print anything on console
On Windows, you may not see any output when executing CopyQ in a console/terminal application (PowerShell or cmd).
Workarounds:
Use different console application: Git Bash, Cygwin or similar.
Use Action dialog in CopyQ (
F5shortcut) and set „Store standard output“ to „text/plain“ to save the output as new item in current tab.Append
| Write-Outputto commands in PowerShell:& 'C:\Program Files\CopyQ\copyq.exe' help | Write-Output
Viz také
On macOS, CopyQ won’t paste after installation/update
CopyQ is not signed app, you need to grant Accessibility again when it’s installed or updated.
To fix this, try following steps:
Go to System Preferences -> Security & Privacy -> Privacy -> Accessibility (or just search for „Allow apps to use Accessibility“).
Click the unlock button.
Select CopyQ from the list and remove it (with the „-“ button).
Viz také
On GNOME, new clipboard is not stored
The app requires the CopyQ Clipboard Monitor GNOME Shell extension to be enabled so it can watch clipboard changes and store them. The extension is shipped with CopyQ 14.0.0 and later.
Poznámka
The GNOME extension is only available when CopyQ is installed on the system (e.g. from a package manager). It will not work when running CopyQ as a Flatpak or AppImage because the extension cannot be registered with the GNOME Shell from a sandboxed environment.
On Linux, some features do not work under Wayland
When running CopyQ under a Wayland compositor, some features may not work depending on the desktop environment and the protocols it supports.
Global shortcuts work natively if the desktop environment provides
Portal support (xdg-desktop-portal).
Clipboard monitoring works natively if the compositor supports the required Wayland protocol. This works on KDE Plasma, Sway, Hyprland and other wlroots-based compositors. On GNOME, this protocol is not supported, but CopyQ ships a GNOME Shell extension that provides clipboard monitoring instead (see On GNOME, new clipboard is not stored). If clipboard monitoring does not work with either method, see Workaround: running under XWayland below.
Querying state of keyboard modifiers (for example pressed Shift, Ctrl etc. which can be useful for some custom commands) and mouse position (useful for positioning menus) does not work on Wayland.
See the subsections below for other fixes.
Workaround: Wayland Support command
This can fix (depending on the desktop environment and installed tools):
pasting from CopyQ and issuing copy commands to other apps
screenshot functionality
retrieving and matching window titles
Install the Wayland Support command to fix the features. It also requires some external tools to be installed on the system.
Workaround: running under XWayland
This can fix:
clipboard monitoring
setting and restoring window position (only window size is supported by most Wayland compositors natively)
Setting QT_QPA_PLATFORM=xcb environment variable forces CopyQ to run under
XWayland mode. Unfortunately, it can cause clipboard monitoring to fail when
the main window is closed, X11 connection errors, and other issues depending on
the XWayland implementation.
To start CopyQ under XWayland, use:
env QT_QPA_PLATFORM=xcb copyq
If CopyQ autostarts, you can change the Exec=... line in
~/.config/autostart/copyq.desktop:
Exec=env QT_QPA_PLATFORM=xcb copyq
For the Flatpak application, see this workaround.
Poznámka
Mouse selection will still work only if the source application itself supports it.
Scripting command „copy()“ fails
The command copy() sends the Ctrl+C shortcut to the current window.
This can fail depending on the active application.
If CopyQ won’t detect a clipboard change, it throws an exception.
The execution then fails with the message Failed to copy to clipboard!.
An alternative under Windows is to use a Powershell script to override the copy operation
(see How to load shared commands and share them?):
[Command]
Command="
copy = function() {
execute('powershell', '-Command', `
Add-Type -AssemblyName System.Windows.Forms;
Start-Sleep -Milliseconds 300;
[System.Windows.Forms.SendKeys]::SendWait(\"^c\");
Start-Sleep -Milliseconds 300;
`);
}"
IsScript=true
Name=Override copy()
The delays are added to make sure no focus issues occur and the text is copied to the clipboard.