PluelyPluelyDocumentação

Primeiros passos

Permissões do Pluely no Linux: microfone e captura de tela

O Linux não tem um sistema de permissões único como o macOS e o Windows: o que você precisa verificar depende do seu servidor de áudio (PipeWire ou PulseAudio) e do seu servidor gráfico (X11 ou Wayland), que por sua vez dependem da sua distribuição e do ambiente de área de trabalho. Esta página trata das duas coisas de que o Pluely v1 precisa, entrada de microfone e captura de tela, e de como verificar cada uma numa instalação Linux moderna típica.

Dentro do Pluely, Painel → Permissões e áudio mostra essas permissões como Gerenciado pelo sistema, com um botão Abrir configurações do Linux, e verifica o áudio do sistema ao vivo.

Microfone pelo PipeWire ou PulseAudio

A maioria das distribuições Linux atuais encaminha o áudio pelo PipeWire (muitas vezes com compatibilidade com o PulseAudio) ou pelo PulseAudio puro. O Pluely v1 precisa de um dispositivo de entrada funcionando e selecionado nessa camada para ouvir você no modo Ouvir e no Pressionar para falar.

Verifique se o seu dispositivo de entrada está presente e selecionado:

  • Abra as configurações de Som da sua área de trabalho (o caminho exato varia; por exemplo, Configurações → Som no GNOME ou Configurações do sistema → Áudio no KDE) e confirme que o microfone certo está escolhido como dispositivo de entrada e que o nível de entrada se mexe quando você fala.

  • Pelo terminal, você pode listar as fontes de áudio diretamente. Num sistema com PipeWire ou PulseAudio:

    pactl list short sources

    Procure o seu microfone na lista e confira se ele não está mudo.

O modelo de permissões varia conforme a distribuição e a área de trabalho: algumas distribuições usam as permissões de sessão/portal do PipeWire para controlar o acesso ao microfone por aplicativo (numa lógica parecida com a do macOS), com um aviso na primeira vez que um app pede áudio. Outras dependem totalmente das permissões de dispositivo do ALSA/PulseAudio, sem nenhum aviso por app: se o dispositivo não estiver mudo e estiver selecionado, qualquer app, incluindo o Pluely, pode usá-lo. Se não tiver certeza de qual modelo o seu sistema usa, o primeiro passo mais seguro é sempre o painel de configurações de Som acima.

Sintoma quando falta ou está mal configurado: o modo Ouvir não mostra a forma de onda se mexendo com a sua voz e nunca transcreve o seu lado da conversa; o Pressionar para falar não faz nada quando você mantém a tecla pressionada.

Captura de tela e permissões do portal (principalmente no Wayland)

As capturas de tela no modo Perguntar dependem do seu servidor gráfico:

  • As sessões X11 deixam o Pluely ler a tela diretamente. A seleção de área mostra a sobreposição de seleção do próprio Pluely em todos os monitores.
  • As sessões Wayland nunca deixam um app ler a tela, então o Pluely pede ao xdg-desktop-portal (com o backend da sua área de trabalho, como o portal do GNOME ou do KDE). Uma captura da tela inteira mostra uma caixa de diálogo de permissão na primeira vez, e a sua área de trabalho lembra a resposta. A seleção de área abre o seletor de captura de tela da própria área de trabalho (área, janela ou tela) em vez da sobreposição do Pluely, e o resultado chega ao chat do mesmo jeito. Fechar o seletor simplesmente cancela.

O áudio do sistema, que traz o outro lado da chamada, não passa pelo portal. O Pluely grava a fonte de monitoramento do seu dispositivo de saída pelo PulseAudio ou PipeWire, e o seu microfone pelo mesmo servidor de som, então ele compartilha o microfone com o app de reuniões em vez de disputar o dispositivo com ele.

No Linux, não é possível ocultar o Pluely nos compartilhamentos de tela. Nem o X11 nem o Wayland oferecem um jeito de uma janela se excluir das capturas, então no Linux a sobreposição aparece nas telas compartilhadas e nas gravações. Tire a sobreposição da tela compartilhada ou compartilhe uma única janela em vez da tela inteira.

Como verificar/redefinir as permissões do portal: os detalhes variam conforme o ambiente de área de trabalho, mas o caminho geral é:

  1. Confirme que o xdg-desktop-portal (e o backend específico da sua área de trabalho, por exemplo xdg-desktop-portal-gnome ou xdg-desktop-portal-kde) está instalado; ele vem por padrão na maioria das distribuições modernas, mas pode faltar em instalações mínimas.
  2. Procure uma configuração de permissão de compartilhamento de tela ou de área de trabalho remota nas configurações de privacidade da sua área de trabalho, onde às vezes é possível redefinir permissões negadas antes a um app.
  3. Se um aviso do portal foi fechado em vez de respondido, tente a captura de novo no Pluely para que ele apareça outra vez.

Sintoma quando falta: a captura de tela falha, gera uma imagem em branco ou nada acontece quando você tenta anexar uma captura de tela; no modo Ouvir, só o seu microfone é transcrito e o outro lado da chamada nunca aparece.

Atalhos de teclado no Wayland

No Wayland, os atalhos globais passam pelo portal GlobalShortcuts da área de trabalho, que exige o KDE Plasma 5.27 ou posterior, o GNOME 48 ou posterior ou uma área de trabalho wlroots (Hyprland, Sway) com o portal instalado. A sua área de trabalho pode pedir uma vez para confirmar os atalhos do Pluely, e você também pode mudar as teclas por lá. A página Cursor e atalhos do Painel mostra se o vínculo funcionou. Nas sessões X11, os atalhos funcionam sem nenhum portal.

Mais dois limites do Wayland, impostos pelo compositor e não pelo Pluely: os atalhos de mover a sobreposição e a posição salva da sobreposição não fazem nada, já que os apps no Wayland não podem posicionar as próprias janelas, e o GNOME ignora o modo sempre na frente. Em vez disso, arraste a sobreposição para onde quiser.

Na dúvida, verifique primeiro o dispositivo de entrada

Como as configurações do Linux variam muito, o diagnóstico mais rápido quase sempre é confirmar, no nível do servidor de áudio, que há um microfone selecionado, sem mudo e mostrando entrada; isso separa um problema de configuração de áudio de um problema de permissão de captura de tela/portal, que pedem soluções diferentes.

Relacionados

Última atualização: 10 de julho de 2026 · pluely.com