Como mostrar pressionamentos de teclado na tela do Mac com Keycastr

TL;DR

Keycastr é um app gratuito e de código aberto que mostra as teclas pressionadas na tela do macOS. Baixe do GitHub, dê permissão em Preferências do Sistema › Segurança e Privacidade › Privacidade › “Accessibility”, e personalize a aparência dentro do app.

Por que usar um visualizador de teclas

Mostrar pressionamentos de teclado na tela ajuda em duas situações comuns: ensinar/tutoriais e gravação de screencasts. Também é útil para treinar digitação sem olhar para o teclado. Keycastr exibe as teclas pressionadas em um pequeno overlay que você pode configurar por cor, tamanho e filtro de teclas modificadoras.

Definição rápida: overlay — uma pequena janela flutuante que mostra informações visuais sobre a ação atual.

Requisitos e permissões

• macOS com suporte a apps de terceiros.
• Acesso de acessibilidade (Accessibility) para que Keycastr leia eventos de teclado.
• Conexão à internet para baixar do GitHub.

Importante: o app precisa da permissão de acessibilidade apenas para detectar quais teclas são pressionadas localmente. Ele não envia pressionamentos para servidores externos.

Como instalar e ativar o Keycastr

1. Baixe e descompacte o Keycastr a partir do repositório oficial no GitHub. É gratuito e de código aberto. (Use o link “Download” na página, não o botão “Clone/Download” que pode confundir.)

2. Abra Preferências do Sistema no Mac.

3. Vá para Segurança e Privacidade.

4. Na aba “Privacidade”, selecione “Accessibility” (Acessibilidade). Clique no ícone de “+” na parte inferior da lista para adicionar um app.

Nota: se o botão estiver esmaecido, clique no cadeado e autentique com sua senha para liberar alterações.

5. Selecione o aplicativo Keycastr e marque-o na lista para permitir que ele capture eventos do teclado.

Após ativar, o Keycastr começará a mostrar os pressionamentos na tela, normalmente no canto inferior esquerdo por padrão.

Personalizando a visualização no Keycastr

1. Abra o app Keycastr (o arquivo que você baixou).
2. Na seção Display, ajuste: cor do bezel (borda do overlay), cor do texto, tamanho da fonte, atraso da tecla (keystroke delay) e outras opções.

• Marque “Display only Command Keys” para mostrar apenas teclas combinadas com Ctrl, Command, Option e Shift.
• Escolha o visualizador “Svelte” para que o overlay apareça somente quando uma tecla modificadora estiver pressionada.
• Para mostrar todas as teclas, selecione “Display all Keystrokes”.

Por padrão, o overlay aparece no canto inferior esquerdo.

Se usar o visualizador Svelte, o overlay surge apenas enquanto você segura Command, Option, Control ou Alt.

Checklist rápido por função (Quem faz o quê)

• Apresentador / Professor: verifique contraste e tamanho da fonte antes da apresentação; prefira mostrar apenas modificadores para evitar poluição visual.
• Streamer / YouTuber: teste o overlay com sua ferramenta de gravação para garantir que não fica sobre elementos importantes da interface.
• Aluno / Treinando digitação: use a posição padrão e uma fonte maior para facilitar a leitura à distância.

Casos em que pode falhar e como contornar

• Permissão negada: libere a permissão em Preferências do Sistema › Segurança e Privacidade › Privacidade › “Accessibility”.
• Overlay não aparece nas gravações: algumas ferramentas de gravação podem ignorar janelas overlay. Teste com seu software de screencast e, se necessário, mova o overlay para outra área da tela.
• Conflito com outros utilitários de segurança ou privacidade: temporariamente desative extensões que bloqueiam eventos de acessibilidade e reative após o teste.

Counterexample rápido: se você precisa que o aplicativo registre teclas em segundo plano para controlar outro software remotor—isso foge ao propósito do Keycastr; ele só exibe, não reencaminha eventos.

Alternativas e estratégias combinadas

• Ferramenta integrada limitada: o macOS tem “Keyboard Viewer” para ver o layout do teclado, mas não mostra pressionamentos em tempo real como Keycastr.
• Softwares de screencast comerciais (por exemplo, editores de vídeo com overlay de teclado) podem oferecer integração direta com gravação e pós-produção.
• Procurar outros apps de terceiros procurando por “key visualizer” na web; compare permissões e código aberto quando possível.

Testes e critérios de aceitação (como verificar que está funcionando)

• Ao pressionar letras, números e teclas modificadoras, o overlay deve aparecer instantaneamente e refletir o caractere/tecla correta.
• Ativar a opção de exibir somente teclas modificadoras deve ocultar letras simples.
• O overlay não deve bloquear interações com janelas ativas nem causar atraso perceptível ao digitar.

Notas de privacidade e segurança

Keycastr solicita permissão de acessibilidade para detectar eventos de teclado localmente. Isso é necessário para a funcionalidade. Se baixar de terceiros, prefira repositórios oficiais e código aberto para facilitar auditoria. Não compartilhe cópias não verificadas do app.

Perguntas frequentes

O Keycastr envia meus pressionamentos para a internet?

Não. O Keycastr exibe pressionamentos localmente e não exige um servidor externo para a função de overlay.

Posso gravar o overlay ao fazer um screencast?

Sim, mas teste antes: alguns gravadores podem recortar janelas overlay. Se for o caso, mova o overlay para uma área visível ou escolha um gravador que capture janelas flutuantes.

Preciso pagar para usar o Keycastr?

Não. Keycastr é gratuito e de código aberto quando baixado do repositório oficial.

Resumo final

Keycastr é a solução simples e gratuita para mostrar pressionamentos de teclado no macOS. Instale a partir do GitHub, conceda a permissão de acessibilidade em Preferências do Sistema, e ajuste a aparência conforme seu caso de uso. Teste o overlay com seu software de gravação antes de apresentações ao vivo.

Importante: sempre verifique a origem do download e as permissões solicitadas.