Como rodar o CopyQ no Wayland sem erros (Forçando o XCB)

Se você acabou de migrar para o Wayland (seja no Ubuntu, Fedora, Arch ou qualquer outra distro) e percebeu que o seu gerenciador de área de transferência favorito, o CopyQ, parou de funcionar ou sumiu da barra de tarefas, você não está sozinho.

O Wayland isola os aplicativos por questões de segurança, o que às vezes quebra ferramentas que precisam “espiar” o que você copia. Felizmente, existe uma linha de comando simples que resolve isso, forçando o CopyQ a rodar através do XWayland (a camada de compatibilidade com o X11).

Abaixo, veja como resolver isso temporariamente e como fixar a solução para sempre.

A Solução Rápida (Via Terminal)

Para testar se o problema é realmente a compatibilidade de plataforma, feche o CopyQ completamente e abra-o pelo terminal usando a variável de ambiente QT_QPA_PLATFORM=xcb:

Bash

env QT_QPA_PLATFORM=xcb copyq

O que esse comando faz?

• env: Define uma variável de ambiente temporária para o programa que vai iniciar.
• QT_QPA_PLATFORM=xcb: Diz ao framework Qt (usado pelo CopyQ) para ignorar o Wayland nativo e usar o backend do X11 (XCB).
• copyq: Inicia o aplicativo.

Como Fixar a Solução (Definitivo)

Você não vai querer abrir o terminal toda vez que ligar o computador, certo? Para fazer o CopyQ iniciar automaticamente do jeito certo, precisamos editar o atalho dele.

Passo 1: Copiar o arquivo .desktop para sua pasta de usuário

Evite editar os arquivos do sistema diretamente. Copie o atalho para a sua pasta local:

Bash

cp /usr/share/applications/copyq.desktop ~/.local/share/applications/

Passo 2: Editar o arquivo

Abra o arquivo com o seu editor de texto preferido (como o Nano ou Gedit):

Bash

nano ~/.local/share/applications/copyq.desktop

Passo 3: Modificar a linha Exec

Procure pela linha que começa com Exec= e mude o comando padrão para:

Plaintext

Exec=env QT_QPA_PLATFORM=xcb copyq

Dica Extra: Se houver uma linha de Exec dentro da seção de Autostart (geralmente em ~/.config/autostart/copyq.desktop), faça a mesma alteração nela para garantir que ele inicie junto com o sistema corretamente.

Salve o arquivo (no Nano, morda Ctrl + O para salvar e Ctrl + X para sair) e pronto!

Por que isso acontece? (Para os Curiosos)

O CopyQ é construído em Qt. Por padrão, as versões mais recentes do Qt tentam rodar nativamente no Wayland. No entanto, o protocolo nativo do Wayland bloqueia aplicativos de monitorarem o teclado global ou a área de transferência de outros apps (por privacidade).

Ao forçarmos o xcb, o CopyQ roda sob o XWayland, ganhando de volta as permissões necessárias para salvar seu histórico de Ctrl+C e Ctrl+V sem problemas.