Skip to content

Commit

Permalink
Docs: Updated Wayland known issues
Browse files Browse the repository at this point in the history
  • Loading branch information
hluk committed May 7, 2022
1 parent 1d3bf9f commit 4d05297
Showing 1 changed file with 17 additions and 8 deletions.
25 changes: 17 additions & 8 deletions docs/known-issues.rst
Original file line number Diff line number Diff line change
Expand Up @@ -63,22 +63,25 @@ installed or updated.

.. _known-issue-wayland:

On Linux, global shortcuts and pasting doesn't work
---------------------------------------------------
On Linux, global shortcuts, pasting or clipboard monitoring does not work
-------------------------------------------------------------------------

This can be caused by running Wayland instead of the old X11.
This can be caused by running CopyQ under a **Wayland** window manager instead
of the X11 server.

Wayland doesn't support:
Depending on the desktop environment, these features may not be supported:

- global shortcuts
- clipboard access from window that is not active
- mouse selection copy/pasting
- pasting from CopyQ (i.e. passing shortcuts to application)
- clipboard monitoring
- pasting from CopyQ and issuing copy command to other apps (that is passing
shortcuts to application)
- screenshot functionality
- querying keyboard modifiers and mouse position

**Workaround** for most problems is to set ``QT_QPA_PLATFORM`` environment variable
and use Xwayland (e.g. ``xorg-x11-server-Xwayland`` Fedora package).

E.g. launch CopyQ with::
For example, launch CopyQ with::

env QT_QPA_PLATFORM=xcb copyq

Expand All @@ -94,4 +97,10 @@ If CopyQ autostarts, you can change ``Exec=...`` line in

.. seealso::

`Wayland Support
<https://github.com/hluk/copyq-commands/tree/master/Scripts#wayland-support>`__
command reimplements some features on Wayland through external tools (see
`README <https://github.com/hluk/copyq-commands/blob/master/README.md>`__
for details on how to add the command.

`Issue #27 <https://github.com/hluk/CopyQ/issues/27>`__

0 comments on commit 4d05297

Please sign in to comment.