VoiceInk não funciona: as soluções da própria documentação dele, em ordem

Por · Publicado em

Quando o VoiceInk para de funcionar, a documentação dele diz que a causa quase sempre é uma de cinco coisas: uma permissão do macOS que falta, o microfone errado, um Mode com ajustes que você não esperava, um modelo local lento demais para o Mac ou o tempo da colagem no app em que você está digitando. Confira nessa ordem. A maioria das soluções leva um minuto.

Eu faço o YapToText, um app de ditado diferente, e não usei o VoiceInk. Todos os passos abaixo vêm da documentação do VoiceInk, lida em 9 de outubro de 2026.

Baixar o YapToText na Mac App StoreDownload gratuito. Sem conta e sem nada bloqueado, para macOS 14 ou posterior em um Mac com chip da Apple. Código-fonte no GitHub.

Este guia em outros idiomas: English, العربية, Čeština, Dansk, Deutsch, Ελληνικά, Español, Suomi, Français, עברית, हिन्दी, Magyar, Bahasa Indonesia, Italiano, 日本語, 한국어, Norsk, Nederlands, Polski, Română, Русский, Slovenčina, Svenska, ไทย, Türkçe, Українська, Tiếng Việt, 简体中文, 繁體中文

Nesta página: 11 seções
  1. Passos
  2. Ele grava, mas nenhum texto aparece
  3. Ele transcreve, mas cola a coisa errada ou nada
  4. Ele está lento
  5. Palavras repetidas, texto inventado ou idioma errado
  6. Se você quer algo que simplesmente funcione hoje
  7. A versão curta
  8. Guias
  9. Mais guias, em inglês
  10. Fontes
  11. Perguntas

Passos

  1. Confira as permissões de Microfone e Acessibilidade em Ajustes do Sistema e reinicie o VoiceInk.
  2. Escolha o microfone certo na tela <span lang="en">Audio</span> do VoiceInk.
  3. Confira se o <span lang="en">Mode</span> ativo tem um modelo, o idioma certo e a saída <span lang="en">Paste</span>.
  4. Se colar texto antigo, aumente o <span lang="en">Restore Delay</span> em <span lang="en">Settings</span>, <span lang="en">Pasting</span>.

Ele grava, mas nenhum texto aparece

  • Permissões. Em Ajustes do Sistema, Privacidade e Segurança, o VoiceInk precisa de Microfone para gravar e de Acessibilidade para colar. A Screen Recording só importa se um Mode usar o contexto da tela. Reinicie o VoiceInk depois de qualquer mudança.
  • Microfone. Abra Audio na barra lateral do VoiceInk, escolha o dispositivo certo ou defina uma ordem de prioridade e clique em Refresh Microphones depois de conectar um. Em Ajustes do Sistema, Som, Entrada, o nível deve se mexer quando você fala.
  • O Mode ativo. Em Modes, confira se o Mode está ativado, tem um modelo de transcrição funcionando, o idioma certo e Paste como saída. O Respond e o Custom Command entregam o texto em outro lugar de propósito.
  • O modelo. Em AI Models, um modelo local precisa estar baixado, e um provedor na nuvem precisa de uma chave de API que funcione.

Se você vê o texto em History, mas não no seu app, o problema é a colagem, não a escuta.

Ele transcreve, mas cola a coisa errada ou nada

O VoiceInk cola colocando o texto na área de transferência e pressionando Command V por você. A documentação dá estas soluções, em ordem:

  • Clique antes no campo de texto. A colagem vai para o que estiver com o foco.
  • Aparece texto antigo da área de transferência. Em Settings, Pasting, mantenha Keep Clipboard Content ativado e aumente o Restore Delay. O padrão é 2 segundos, e vai até 5.
  • A sua área de transferência some sempre. O Keep Clipboard Content está desativado. Ative-o.
  • Ainda nada. Mude o Paste Method de Default para AppleScript, que a documentação também sugere para layouts de teclado personalizados.

Ele está lento

  • Use um modelo local mais rápido. A documentação sugere o Parakeet V3 ou V2 para um ditado local rápido, ou um modelo Whisper menor se um grande estiver pesando.
  • Mac com Intel. Os modelos locais costumam rodar melhor em chip da Apple. No Intel, a documentação sugere um provedor de transcrição na nuvem.
  • Transcrição rápida, resultado lento. Esse é o passo de aprimoramento por IA. Desative-o nos Modes de ditado simples ou ative Skip short transcriptions.
  • Ache a etapa lenta. Dashboard, View Insights, Model Performance compara os modelos, e History, Analyze mede o tempo de cada gravação.

Palavras repetidas, texto inventado ou idioma errado

  • Voice Activity Detection. Ative em AI Models, no botão de engrenagem, Transcription. Ela ajuda os modelos locais a ignorar o silêncio.
  • Outro modelo. Tente o Parakeet, ou o Whisper Base ou Tiny, se um modelo Whisper maior gerar texto demais.
  • Repetir. Depois de mudar os ajustes, Retry Last Transcription em Settings, Shortcuts processa de novo o mesmo áudio.
  • O idioma muda sozinho. O idioma é definido por Mode, e um Mode pode ser ativado por app, site ou padrão. Confira qual Mode está ativo.

Se você quer algo que simplesmente funcione hoje

O YapToText é um app de ditado grátis para Macs com chip da Apple e macOS 14 ou posterior, e tem bem menos ajustes que podem dar errado. Não há modos que mudam por app, nem chaves de nuvem, nem atraso de área de transferência para ajustar.

  • Uma tecla. Toque na Command direita (Right Command), fale e toque de novo. O texto aparece no cursor.
  • Os dois modelos já dentro. A versão da App Store traz os modelos de fala e de limpeza do texto, então não há nada para baixar antes.
  • Menos opções. Ele tem uma só família de modelos de fala, o Whisper, e nenhum dos recursos Assistant Mode, comandos personalizados ou provedores na nuvem do VoiceInk.

Baixar o YapToText na Mac App StoreDownload gratuito. Sem conta e sem nada bloqueado, para macOS 14 ou posterior em um Mac com chip da Apple. Código-fonte no GitHub.

A página de alternativa ao VoiceInk compara os dois, e o guia de solução de problemas do ditado do Mac trata do ditado da própria Apple.

A versão curta

  • Sem texto. Confira as permissões de Microfone e Acessibilidade, o microfone selecionado e o Mode ativo.
  • Colagem errada. Aumente o Restore Delay ou mude o Paste Method para AppleScript.
  • Lento. Use o Parakeet, use a nuvem no Intel ou desative o aprimoramento por IA.
  • Ainda travado. O que o suporte do VoiceInk pede é Settings, Diagnostics, Export Logs.

Se a documentação do VoiceInk mudar e um passo daqui deixar de bater, abra uma issue no GitHub (em inglês). Eu leio todas.

Baixar o YapToText na Mac App StoreDownload gratuito. Sem conta e sem nada bloqueado, para macOS 14 ou posterior em um Mac com chip da Apple. Código-fonte no GitHub.

Quem escreve. Ryleigh Newman desenvolve software, tem dificuldade para digitar e dita todos os dias com o YapToText, o app que este site descreve. Esta página foi traduzida do inglês. A interface do app e o resto do site estão em inglês. Mais sobre o projeto, em inglês.

Guias

Mais guias, em inglês

Fontes

Perguntas

Por que o VoiceInk não digita nada?

Em geral por falta da permissão de Acessibilidade, por um Mode cuja saída não é Paste ou por o foco não estar em um campo de texto. A documentação dele manda conferir isso e depois o microfone e o modelo.

Por que o VoiceInk cola o que estava na minha área de transferência?

A área de transferência é restaurada antes de o app terminar de colar. Em Settings, Pasting, mantenha Keep Clipboard Content ativado e aumente o Restore Delay a partir do padrão de 2 segundos.

Por que o VoiceInk é tão lento?

Em geral por um modelo local grande, por um Mac com Intel ou pelo passo de aprimoramento por IA. A documentação sugere o Parakeet V3 ou V2 localmente, transcrição na nuvem no Intel e desativar o aprimoramento no ditado simples.

Por que o VoiceInk fica mudando o idioma?

O idioma é definido por Mode, e os Modes podem ser ativados por app, site ou padrão. Confira o Mode ativo e qual Mode está marcado como padrão.

Existe uma alternativa mais simples e grátis ao VoiceInk?

O YapToText é grátis em Macs com chip da Apple e macOS 14 ou posterior, com uma tecla de ditado e os modelos já dentro da versão da App Store.