Permissões do macOS

Em resumo

Para que o Whisperer ouça a chamada, responda aos atalhos de teclado e leia capturas de tela, ele precisa de três permissões de sistema do macOS: Microfone, Gravação de Tela e Acessibilidade. Cada uma cuida da sua parte do trabalho, e sem qualquer uma delas alguns recursos simplesmente não serão ativados.

A regra mais importante: sem a permissão de "Gravação de Tela" você não ouvirá a outra pessoa. O macOS entrega o áudio do sistema (a voz da outra pessoa na chamada) a um aplicativo apenas pelo mecanismo de gravação de tela. O Microfone, por sua vez, cuida somente da sua própria voz.

Quando usar isto

  • Na primeira execução do cliente, quando o assistente de permissões abrir.
  • Quando apenas a linha [Me] aparece na transcrição enquanto [Other] permanece vazia.
  • Quando os atalhos de teclado globais não funcionam (por exemplo, o push-to-talk).
  • Após uma atualização do macOS, reinstalar o aplicativo ou mudar para um novo Mac.

As três permissões e por que cada uma importa

Permissão Nome no sistema Por que é necessária
Microfone Microphone Captura a sua voz. Marcada como [Me] na transcrição.
Gravação de Tela Screen Recording Captura o áudio do sistema — a voz da outra pessoa — e as capturas de tela. É o [Other] na transcrição. Sem ela, a outra pessoa não é ouvida.
Acessibilidade Accessibility Atalhos de teclado globais: push-to-talk, mostrar/ocultar o overlay, busca na base de conhecimento, captura de tela, entrada de texto.

Passo a passo

  1. Abra o assistente de permissões. Na primeira inicialização, o Whisperer abre automaticamente o assistente (PermissionWizard) se alguma permissão estiver faltando. Ele mostra o status de cada uma das três permissões e um botão para ir direto às Configurações do Sistema. Siga suas instruções — esse é o caminho mais fácil.
  2. Abra as configurações de privacidade. Se for fazer manualmente: menu Apple → Configurações do Sistema → Privacidade e Segurança.
  3. Conceda o Microfone. Abra a seção Microfone e ative a chave ao lado de Whisperer. Isso habilita a captura da sua voz.
  4. Conceda a Gravação de Tela. Abra a seção Gravação de Tela e ative a chave ao lado de Whisperer. Esta é a permissão mais importante: ela fornece tanto o áudio do sistema (a voz da outra pessoa) quanto as capturas de tela. O macOS pode pedir que você reinicie o aplicativo para que a permissão tenha efeito — reinicie-o.
  5. Conceda a Acessibilidade. Abra a seção Acessibilidade e ative a chave ao lado de Whisperer. Isso habilita os atalhos de teclado globais.
  6. Reinicie o Whisperer. Após conceder as permissões (especialmente a "Gravação de Tela"), saia e reabra o aplicativo para que as alterações sejam aplicadas.
  7. Verifique. Inicie uma sessão de teste e confirme que ambos os papéis aparecem na transcrição — [Me] e [Other] — e que os atalhos de teclado funcionam.

Capturas de tela

📸 [Captura de tela: o assistente de permissões (PermissionWizard) na primeira inicialização — status das três permissões]

📸 [Captura de tela: Configurações do Sistema → Privacidade e Segurança → Gravação de Tela com a chave do Whisperer ativada]

📸 [Captura de tela: a seção Microfone e a seção Acessibilidade com as chaves do Whisperer]

Erros comuns

  • Apenas o microfone foi concedido. A situação mais comum: [Me] aparece na transcrição, mas [Other] não. A causa é que a permissão de "Gravação de Tela" não foi concedida. O áudio do sistema não fica disponível sem ela.
  • Permissão concedida, mas não funciona. O macOS armazena em cache o status da permissão; depois de ativar a chave, você precisa reiniciar o aplicativo. Se isso não ajudar, veja Problemas de permissão do macOS.
  • Os atalhos de teclado não funcionam. A Acessibilidade não foi concedida. As teclas globais não são interceptadas sem ela.
  • Sem capturas de tela / a visão não funciona. As capturas de tela também passam pela "Gravação de Tela" — verifique exatamente essa permissão.
  • O Whisperer não está na lista. Às vezes o aplicativo não aparece na seção automaticamente — isso é abordado no artigo de solução de problemas.

Boas práticas

  • Percorra o assistente de permissões do início ao fim na primeira execução — ele cobre os três itens de uma vez.
  • Após conceder a "Gravação de Tela", sempre reinicie o aplicativo — esse é o comportamento padrão do macOS.
  • Se algo "quebrou" depois de uma atualização do macOS, refaça as três chaves; atualizações do sistema operacional às vezes redefinem a confiança nos aplicativos.
  • Lembre-se da lógica de rotulagem: [Me] = microfone, [Other] = gravação de tela. Isso ajuda você a identificar rapidamente qual permissão corrigir.

Artigos relacionados