Solucao de problemas

“Local Transcriber nao pode ser aberto”

Isso e o Gatekeeper do macOS. O app e assinado e autenticado pela Apple, mas o Gatekeeper pode ainda exibir essa mensagem na primeira execucao.

Solucao: Clique com o botao direito no app em Aplicativos → selecione Abrir → clique em Abrir na caixa de dialogo. Voce so precisa fazer isso uma vez.

Nenhum audio e capturado

Se o app comeca a gravar mas nenhum texto aparece:

1. Verifique a permissao do microfone. Va em Ajustes do Sistema → Privacidade e Seguranca → Microfone e certifique-se de que o Local Transcriber esteja ativado.
2. Verifique a permissao de reconhecimento de fala. Va em Ajustes do Sistema → Privacidade e Seguranca → Reconhecimento de Fala e certifique-se de que o Local Transcriber esteja ativado.
3. Reinicie o app apos conceder as permissoes — o macOS as vezes nao detecta as alteracoes de permissao ate que o app seja reiniciado.
4. Verifique a saida de audio. O app captura o audio do sistema pela saida de audio do seu Mac. Se voce esta roteando o audio por um dispositivo externo que o macOS nao reconhece como saida padrao, a captura do audio do sistema pode nao funcionar.

Apenas um lado da chamada e capturado

Se voce ve sua voz mas nao a da outra pessoa (ou vice-versa):

• Audio do sistema (a outra pessoa) vem da saida de audio do seu Mac. Certifique-se de que o audio da chamada esteja sendo reproduzido pelos alto-falantes do Mac ou por fones de ouvido conectados ao Mac.
• Audio do microfone (sua voz) vem do microfone que seu Mac esta usando. Verifique em Ajustes do Sistema → Som → Entrada se o microfone correto esta selecionado.

A transcricao esta imprecisa

O reconhecimento de fala on-device tem bom desempenho, mas nao e perfeito. Veja o que pode ajudar:

• Fale claramente e evite resmungar.
• Reduza o ruido de fundo — feche as janelas, desative as notificacoes.
• Use fones de ouvido com microfone — isso fornece o sinal de audio mais limpo.
• Aguarde o pos-processamento — a transcricao ao vivo e um rascunho. O pos-processamento (que e executado automaticamente ao parar) melhora significativamente a precisao.

O pos-processamento parece travado

O pos-processamento geralmente leva de 10 a 30 segundos para uma reuniao de 30 minutos. Se parecer travado:

1. Verifique o status. Olhe a barra lateral — ela mostra “Processando” com um indicador giratoria durante o trabalho.
2. Verifique o log. Abra o Terminal e execute:

   tail -f ~/.transcriber/engine.log

   Isso mostra o que o app esta fazendo em tempo real.
3. A primeira execucao e mais lenta. Na primeira vez que voce grava, o app baixa os modelos de voz (~50 MB). Isso acontece apenas uma vez.

Os modelos nao carregam

Na primeira execucao, o app baixa os modelos de reconhecimento de fala e de diarizacao on-device. Isso requer uma conexao com a internet. Se os modelos nao carregarem:

1. Verifique a conexao com a internet — os modelos sao baixados dos servidores da Apple.
2. Verifique o espaco disponivel em disco — os modelos precisam de aproximadamente 200 MB de espaco livre.
3. Reinicie o app — o download sera retomado na proxima execucao.

Uma vez baixados, os modelos ficam em cache e o app funciona completamente offline.

O app nao aparece na barra de menus

O Local Transcriber mostra um icone de microfone na barra de menus do macOS. Se voce nao o ve:

• Verifique o overflow da barra de menus. Se voce tem muitos itens na barra de menus, o macOS pode ocultar alguns. Procure um chevron > na barra de menus.
• Certifique-se de que o app esta em execucao. Verifique no Monitor de Atividade se “Local Transcriber” ou “Transcriber” esta presente.

O CLI nao funciona

Se o comando transcriber nao e encontrado apos a instalacao:

1. Abra uma nova janela do terminal — a atualizacao do PATH requer uma nova sessao do shell.
2. Reinstale — va em Transcriber → Instalar CLI e skill do agente… no menu do app.
3. Verifique o link simbolico — execute ls -la /usr/local/bin/transcriber para verificar se existe e aponta para o bundle do app.

Precisa de mais ajuda?

Consulte o log do motor para diagnostico detalhado:

tail -100 ~/.transcriber/engine.log

Se ainda estiver com problemas, abra uma issue no GitHub com a saida de log relevante.