Baixe o YapToText para o seu Mac

Instale o YapToText pela Mac App Store. Ele é gratuito e os dois modelos já vêm dentro do app, então ele dita com o Wi-Fi desligado desde a primeira abertura. Se você prefere o Terminal, um único comando do Homebrew instala o mesmo app sem os modelos, e você baixa um modelo de voz antes do primeiro ditado.

De qualquer forma, você precisa de um Mac com chip da Apple e macOS 14 ou posterior, e de duas permissões: Microfone, para o app ouvir você, e Acessibilidade, para ele digitar em outros apps.

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.

Nesta página: 13 seções
  1. Passos
  2. Confira se o seu Mac consegue rodá-lo
  3. Instale pela Mac App Store
  4. Ou instale com o Homebrew
  5. Conceda as duas permissões
    1. Passo 1: deixe o app ouvir você
    2. Passo 2: deixe o app digitar por você
  6. Faça o seu primeiro ditado
  7. Se ele não digitar nada
  8. Atualize, remova ou compile você mesmo
    1. Compile a partir do código-fonte
  9. Resumindo
  10. Guias
  11. Mais guias, em inglês
  12. Fontes
  13. Perguntas

Passos

  1. Instale o YapToText pela <span lang="en">Mac App Store</span> ou rode brew install --cask ryleighnewman/yaptotext/yaptotext no Terminal.
  2. Se você usou o Homebrew, abra a página <span lang="en">AI Models</span> e baixe o Whisper Large v3 Turbo (Q5), além do Phi-3.5 Mini Instruct se quiser os modos que arrumam o seu texto.
  3. Abra o YapToText e permita o acesso ao Microfone quando o macOS perguntar.
  4. Pressione <span lang="en">Grant</span> ao lado de Acessibilidade na página <span lang="en">Home</span> e ligue o YapToText em Ajustes do Sistema, Privacidade e Segurança, Acessibilidade.
  5. Clique onde o texto deve aparecer, toque em <span lang="en">Right Command</span>, fale e toque em <span lang="en">Right Command</span> de novo.

Confira se o seu Mac consegue rodá-lo

O YapToText tem três requisitos. Você precisa de um Mac com chip da Apple, macOS 14 ou posterior e cerca de 2,9 GB de espaço para a versão da App Store.

  • Um Mac com chip da Apple. Nada foi testado em um Mac com processador Intel, então não ofereço suporte a ele.
  • macOS 14 (Sonoma) ou posterior. O cask do Homebrew recusa qualquer versão mais antiga. No macOS 26, a interface ganha o visual Liquid Glass.
  • Um microfone. O microfone do próprio Mac funciona e capta a sua voz melhor que um fone Bluetooth, que envia o som com qualidade de telefone.

A versão da App Store precisa de cerca de 2,9 GB de espaço, a maior parte ocupada pelos dois modelos. A versão do Homebrew tem cerca de 12 MB para baixar e cerca de 18 MB descompactada, além dos modelos que você baixar. Não há versão para iPhone, iPad, Windows ou Linux.

Instale pela Mac App Store

A versão da Mac App Store é a que eu recomendo, porque não há mais nada para configurar. Ela não custa nada, sem plano pago e sem conta para criar. A página de preços explica o que significa gratuito aqui. A única coisa no app que aceita dinheiro é um pote de gorjetas que você pode ignorar, e nenhum recurso fica bloqueado por trás dele. Os dois modelos vêm dentro da versão da App Store, então não há mais nada para baixar.

  • Você: Abra o YapToText na Mac App Store e baixe o app.
  • macOS: Baixa cerca de 2,9 GB, a maior parte nos dois modelos: Whisper Large v3 Turbo (Q5) para a voz, com 574 MB, e Phi-3.5 Mini Instruct para a limpeza, exibido como 2,3 GB.
  • Confira: O YapToText está na sua pasta Applications e, quando você o abre, a capivara aparece na barra de menus.

As atualizações chegam pela App Store como as de qualquer outro app. O YapToText nunca consulta um servidor para buscar atualizações por conta própria.

Pôster da App Store com o título Yap it. Bam. It's typed. sobre a janela Home do YapToText e os três formatos do painel flutuante.
Figura 1. Um dos pôsteres da App Store, para você reconhecer a página do app quando a vir: a janela Home, com o painel flutuante nos três formatos.

Ou instale com o Homebrew

O Homebrew instala o mesmo app a partir da mesma fonte, com três diferenças. Ele é assinado com um Developer ID e notarizado, em vez de assinado pela App Store, vem sem os modelos e pode ficar uma versão atrás da versão da App Store. A página Novidades lista as duas. Instale e depois baixe um modelo de voz antes do primeiro ditado.

Terminal: Instale o YapToText a partir do meu tap do Homebrew.

brew install --cask ryleighnewman/yaptotext/yaptotext

O que acontece: O YapToText chega à sua pasta Applications depois de um download de cerca de 12 MB, e o Homebrew exibe um aviso para abrir AI Models e baixar um modelo de voz. O app não consegue ditar até que um esteja instalado.

A página AI Models do YapToText: Whisper Large v3 Turbo (Q5) e Phi-3.5 Mini Instruct marcados como Included, com a biblioteca de modelos abaixo.
Figura 2. A página AI Models. Na versão da App Store, os dois padrões aparecem como Included, como aqui. Na versão do Homebrew, baixe primeiro um modelo de voz nesta página.
  • Você: Abra o YapToText, vá até a página AI Models e baixe o Whisper Large v3 Turbo (Q5), com 574 MB. Adicione o Phi-3.5 Mini Instruct, com 2,3 GB, se quiser o Auto mode, o Quick Edit ou qualquer outro modo que arrume o seu texto.
  • YapToText: Busca os arquivos por HTTPS no Hugging Face e os guarda no próprio container, onde eles sobrevivem às atualizações. Esse download é o único tráfego de rede que o app inicia, e só quando você clica nele.
  • Confira: O modelo aparece como instalado e um ditado de teste digita o texto. Até lá, o ditado informa que nenhum modelo de voz está instalado.

O Raw Transcription precisa apenas do modelo de voz. Todos os outros modos incluídos, a formatação do Auto mode e o Quick Edit também usam o modelo de limpeza. A página de ajuda de AI Models explica cada modelo da biblioteca.

Mais duas coisas para saber. O cask instala o YapToText em /Applications, então ele substitui uma cópia da App Store, se houver uma: escolha só um método de instalação. E os modelos ficam de fora desta versão por um motivo simples: com eles, o app passa do limite de 2 GB do GitHub para um arquivo de release, e sem eles ocupa cerca de 18 MB descompactado.

Conceda as duas permissões

A primeira abertura guia você pelas duas permissões, e o cartão Get set up da página Home as mostra de novo quando você quiser. Microfone é obrigatória. Acessibilidade é o que permite ao YapToText digitar em outros apps. Sem ela, cada ditado ainda é transcrito e copiado para a área de transferência.

Passo 1: deixe o app ouvir você

  • Você: Pressione Continue ao lado de Microfone no cartão Get set up ou comece o seu primeiro ditado.
  • macOS: Pergunta uma vez se o YapToText pode usar o microfone. Permita.
  • Confira: A linha Microfone mostra uma marca de verificação verde. Se você recusou sem querer, ative o YapToText em Ajustes do Sistema, Privacidade e Segurança, Microfone.

Passo 2: deixe o app digitar por você

  • Você: Pressione Grant ao lado de Acessibilidade no mesmo cartão.
  • macOS: Abre Ajustes do Sistema, Privacidade e Segurança, Acessibilidade. Um app não consegue ativar isso por conta própria, então você liga a chave ao lado do YapToText.
  • Confira: Em alguns segundos, o cartão Get set up sai da página Home, porque as duas permissões agora estão ativas. Se a chave não ficar ligada, pressione Show in Finder, arraste o app para a lista e pressione Recheck.
A página Home do YapToText: o botão Start Dictation, o cartão Keys com Right Command e Right Option, e o Intelligent Insert.
Figura 3. A página Home com as duas permissões ativas: o cartão Get set up sumiu, e o Start Dictation fica logo abaixo das boas-vindas.

A Acessibilidade também faz funcionar a tecla Right Command e a leitura do texto que você selecionou. O atalho de reserva, Control Option Space, funciona sem ela.

Faça o seu primeiro ditado

O seu primeiro ditado é uma tecla, tocada duas vezes. Clique onde as palavras vão, toque em Right Command, fale e toque de novo. As palavras aparecem onde o cursor estava. Enquanto você fala, Space pausa, Esc cancela e uma tecla numérica escolhe um modo.

O guia do primeiro ditado traz a versão passo a passo, com o que você vê em cada etapa, e a página de teclas e atalhos mostra como manter a tecla pressionada para falar ou escolher outra.

O painel flutuante de ditado do YapToText em um Mac: uma onda sonora ao vivo, a frase sendo digitada e os botões de cancelar, pausar e parar.
Figura 4. O painel flutuante que aparece quando você toca em Right Command: a sua voz como uma onda, as suas palavras à medida que se formam e as opções de modo embaixo.

Se ele não digitar nada

  1. Clique primeiro no app. O YapToText nunca digita na própria janela, então um ditado iniciado com ele na frente vai para a área de transferência. Pressione Command V para colar.
  2. Ative a Acessibilidade. Em Ajustes do Sistema, Privacidade e Segurança, Acessibilidade, ligue o YapToText. Sem isso, cada ditado é copiado para a área de transferência em vez de digitado, e a tecla Right Command não faz nada.
  3. Baixe um modelo de voz. Na versão do Homebrew, nada pode ser transcrito até que o Whisper Large v3 Turbo (Q5) ou outro modelo de voz esteja instalado na página AI Models.
  4. Confira o microfone. Se o painel disser que não captou, o app ouviu silêncio. Escolha o seu microfone em Settings, General, Microphone e acompanhe o medidor ao vivo enquanto você fala.

A página de solução de problemas vai mais fundo, e o índice da ajuda lista todos os guias. Se o problema for o ditado da própria Apple, comece pelo guia O ditado não funciona no Mac.

Atualize, remova ou compile você mesmo

A versão da App Store é atualizada pela Mac App Store. A versão do Homebrew é atualizada com um comando.

Terminal: Atualize a versão do Homebrew para a mais recente do meu tap.

brew upgrade --cask yaptotext

O que acontece: O Homebrew substitui o app pela versão mais recente do cask. Os seus ajustes, o histórico e os modelos baixados ficam, porque moram no container do próprio app.

A primeira versão do Homebrew, a 1.3.1, não conseguia usar o microfone. A 1.4 corrigiu isso, então, se você instalou essa versão antiga, atualize.

Para remover a versão do Homebrew junto com o que ela guardou, use a opção zap.

Terminal: Desinstale o YapToText e os seus dados.

brew uninstall --zap --cask yaptotext

O que acontece: O Homebrew remove o app e move o container e as pastas de suporte para a Lixeira, levando junto os seus ajustes, o histórico, os áudios salvos e os modelos baixados.

Na versão da App Store, Erase All Data em Settings, Advanced apaga os seus ajustes, modos, dicionários, comandos, ações de IA, histórico e áudios salvos, e reabre o app na tela de boas-vindas. Depois disso, mova o app para a Lixeira.

Compile a partir do código-fonte

O app inteiro está no GitHub sob a GPL-3.0. Você precisa do Xcode 26 ou posterior. Clone o projeto, abra o YapToText.xcodeproj, escolha o esquema YapToText e pressione Command R. Ele roda em sandbox e é compilado como é distribuído. O código no GitHub pode ficar uma versão atrás da versão da App Store. A página Novidades lista as duas.

Resumindo

  • A maioria das pessoas. Instale pela Mac App Store. Os dois modelos estão dentro, então ele funciona offline desde a primeira abertura.
  • Quem usa o Homebrew. Rode o comando e depois baixe o Whisper Large v3 Turbo (Q5) na página AI Models antes de ditar.
  • Todo mundo. Conceda Microfone e Acessibilidade, clique onde as palavras vão e toque duas vezes em Right Command.
  • O preço. É gratuito. A página de preços explica o que significa gratuito.
  • Ainda escolhendo. A comparação coloca o app ao lado dos outros apps de ditado para Mac.

Instale, conceda duas permissões, toque em Right Command e fale. Se algo aqui não bater com o que você vê, conte para mim no GitHub. Eu leio todas as issues.

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

A versão do YapToText para Homebrew é igual à da App Store?

Quase. Ela é compilada a partir da mesma fonte, mas é assinada com um Developer ID e notarizada, vem sem os modelos de voz e de limpeza e pode ficar uma versão atrás da versão da App Store.

Qual modelo devo baixar depois de instalar o YapToText com o Homebrew?

O Whisper Large v3 Turbo (Q5), o modelo de voz recomendado, com 574 MB. O Raw Transcription precisa só dele. Adicione o Phi-3.5 Mini Instruct, de cerca de 2,3 GB, para o Auto mode, o Quick Edit e os outros modos que arrumam o seu texto.

O YapToText precisa de conexão com a internet?

Não, a versão da App Store não precisa. Os dois modelos estão dentro do app, então ele funciona offline desde a primeira abertura. A versão do Homebrew precisa de conexão uma vez, para o download do modelo que você mesmo inicia.

Posso ter as versões da App Store e do Homebrew instaladas ao mesmo tempo?

Não. O cask do Homebrew instala o YapToText em /Applications e substitui uma cópia da App Store que já esteja lá. Escolha um método de instalação.

Como atualizo o YapToText?

A versão da App Store é atualizada pela Mac App Store. A versão do Homebrew é atualizada com brew upgrade --cask yaptotext. O app nunca verifica atualizações por conta própria.