Modos de ditado: as mesmas palavras, moldadas para onde elas vão

Os modos de ditado decidem o que o YapToText faz com as suas palavras depois que o Whisper as ouve no seu Mac: o Raw Transcription as digita exatamente como foram ditas, e o Clean Up, o Note, o Email, o Message e o Code Comment as reescrevem para esse tipo de texto, mantendo as suas palavras. O modo Auto, ativado por padrão, escolhe um para você a cada vez.

Os modos ficam na página Modes. Todos são editáveis, inclusive os que já vêm no app. Você pode escrever os seus em frases simples, e qualquer app pode ter um modo próprio. Tudo roda no seu Mac, então um modo nunca envia as suas palavras para lugar nenhum.

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: 11 seções
  1. O que cada modo faz
  2. Escolher um modo, ou trocar no meio
  3. Editar um modo, ou criar o seu
    1. Passo 1: comece por um modo parecido
    2. Passo 2: escreva as instruções
    3. Passo 3: teste
  4. Dar a um app o seu próprio modo
  5. Rodar um modo em um texto que você já tem
  6. Limites
  7. Se um modo faz algo estranho
  8. Resumindo
  9. Guias
  10. Mais guias, em inglês
  11. Perguntas

O que cada modo faz

Seis modos vêm com o app, além do Auto:

  • Auto. Lê cada ditado e escolhe o tratamento sozinho. Ele tem um guia próprio: modo Auto.
  • Raw Transcription. Voz para texto rápido e literal, com pontuação básica e sem IA. É o modo selecionado sempre que o Auto está desligado, até você escolher outro.
  • Clean Up. Remove vícios de fala e começos falsos, corrige gramática, maiúsculas e pontuação, e conserta palavras que o microfone claramente ouviu errado. Ele mantém as suas palavras, o seu tom e o seu registro, inclusive linguagem direta ou com palavrões, nunca apaga, encurta nem resume uma frase, escreve endereços de sites e de e-mail falados na forma correta e transforma números falados em dígitos sem acrescentar unidades. O app o chama de padrão recomendado.
  • Note. Títulos curtos e tópicos, com as tarefas a fazer reunidas em uma lista, e nada acrescentado que você não tenha dito.
  • Email. O corpo de um e-mail, nunca uma linha de assunto. Ele só acrescenta uma saudação se você citou alguém, e assina com o nome que está em Settings, Advanced, Your name, nunca com um texto provisório como [Your Name].
  • Message. Limpeza leve para chat: vícios de fala removidos, gramática óbvia corrigida e o tom informal mantido.
  • Code Comment. Frases concisas e técnicas para comentários de código e mensagens de commit, com identificadores e maiúsculas e minúsculas mantidos exatamente como falados e sem aspas nem blocos de código.

Todo modo, exceto o Raw Transcription, entrega a transcrição ao modelo de limpeza, o Phi-3.5 Mini Instruct por padrão, com instruções próprias. Se o resultado soa como a resposta de um assistente, cresce bem além do que você disse ou repete o texto de referência, o app o descarta e digita a transcrição bruta. O Raw Transcription nunca toca em um modelo de IA. Todos os outros modos mantêm as suas palavras e corrigem o resto.

A lista Switch Mode do YapToText: Auto, Raw Transcription, Clean Up, Note, Email, Message e Code Comment, numerados de 1 a 7.
Figura 1. Na lista Switch Mode, o Raw Transcription é o único modo marcado como Verbatim. Todos os outros, o Auto inclusive, são marcados como AI cleanup.

Escolher um modo, ou trocar no meio

Há quatro formas de escolher um modo:

  • Pela barra de menus. Clique na capivara e use o seletor Mode. Escolher um modo ali desliga o Auto, e o Auto sai do seletor até você ligá-lo de novo, na página Home ou na linha Auto da página Modes.
  • Enquanto você fala. Pressione de 1 a 9, ou clique em uma etiqueta de modo no painel expandido. Com o Auto ligado, a escolha vale para este ditado. Com o Auto desligado, ela vira o seu modo selecionado.
  • Pela página Modes. Clique com o botão direito em um modo e escolha Use This Mode. O modo atual leva uma etiqueta Current.
  • Com um atalho. O Cycle mode em Settings, General, Shortcuts percorre a lista, e qualquer modo pode ter o seu próprio Activation shortcut, que inicia um ditado nesse modo.
O painel flutuante de ditado do YapToText em um Mac: uma forma de onda ao vivo, a frase sendo digitada e os botões de cancelar, pausar e parar.
Figura 2. Enquanto você fala, as etiquetas de modo do painel expandido têm os mesmos números das teclas: clique em uma ou pressione o número dela.

Os números seguem a ordem da lista Modes, então, se você arrastar um modo para cima ou para baixo, o número dele muda junto. Um modo com Show in the quick switcher desligado fica sem número. O número de um modo é a tecla que o escolhe. Todas as teclas estão em as teclas do YapToText.

Editar um modo, ou criar o seu

Clique em qualquer modo na página Modes para abrir o editor dele. Os cartões são Basics (nome, ícone, descrição, Show in the quick switcher, Activation shortcut), Apps that use this mode, Speech model com uma escolha On battery, Recording & language, AI cleanup, Dictionaries, Where the text goes e Try it out.

A página Modes do YapToText: Auto no topo, depois Raw Transcription, Clean Up, Note, Email, Message e Code Comment, numerados de 2 a 7.
Figura 3. Clique em qualquer modo na página Modes para abrir o editor dele. O botão de mais no canto superior direito cria um novo, e a etiqueta Current marca o modo em uso.

Passo 1: comece por um modo parecido

  • Você: Clique com o botão direito em um modo e escolha Duplicate, ou pressione o botão de mais e escolha New Mode.
  • YapToText: Abre o editor do novo modo.
  • Confira: O novo modo aparece na lista da página Modes.

Passo 2: escreva as instruções

  • Você: No cartão AI cleanup, deixe Rewrite the transcript with AI ativado e escreva o que você quer na caixa Instructions, ou pressione um botão Start from para partir das instruções de um modo que já vem no app.
  • YapToText: Salva enquanto você digita. O modelo de limpeza segue essas instruções em todos os ditados desse modo.
  • Confira: As instruções dizem o que manter e também o que mudar.

Instruções do modo: Um exemplo para respostas curtas em um app de chat.

Transforme o meu ditado em uma resposta curta e simpática. Mantenha as minhas palavras e o meu sentido. Não acrescente nada que eu não tenha dito.

O que acontece: O modelo de limpeza reescreve cada ditado desse modo nessa direção, no seu Mac.

Passo 3: teste

  • Você: No cartão Try it out, digite um exemplo e pressione Preview with AI.
  • YapToText: Roda o modo no exemplo, sem ditar.
  • Confira: O Result soa como você quer. Se não, edite as instruções e veja de novo.

Em AI cleanup você também escolhe o Cleanup model, e três chaves definem que contexto o modelo pode ver. Os modos que já vêm no app têm Reset to Default no menu do botão direito, o Restore Built-in Modes fica sob o botão de mais, e o botão Undo desfaz a última mudança de modo. Export Mode e Import Mode levam um modo como arquivo. Um modo são só instruções que você pode ler e reescrever.

Dar a um app o seu próprio modo

Qualquer app pode ter um modo próprio, e o ditado nele passa a usá-lo sem que você o escolha. Coloque o Mail no Email, o Mensagens no Message e o seu editor no Code Comment.

  • Você: No editor do modo, em Apps that use this mode, pressione Add app e escolha um app aberto, ou Choose App para qualquer outro. Settings, Advanced, Per-app modes edita a mesma lista.
  • YapToText: Muda para esse modo sempre que o app está na frente quando um ditado começa. Isso não precisa da permissão de Acessibilidade.
  • Confira: Com o modo Auto desligado, um ditado nesse app sai moldado pelo modo dele.

Enquanto o modo Auto está ligado, o Auto decide como cada ditado é escrito, então os modos por app só moldam o texto quando o Auto está desligado. Se você dita em muitos apps, o guia para ditar em qualquer app do Mac passa app por app.

Rodar um modo em um texto que você já tem

Três lugares rodam um modo em um texto que já está escrito:

  • Regenerate na barra de menus. Clique na capivara e depois em Regenerate: Redo it as passa o seu último ditado por qualquer modo, Rewrite it as reescreve o texto que você selecionou em qualquer modo, e uma edição de uma vez aplica uma AI Action.
  • History. Cada entrada guarda a transcrição bruta, então Regenerate with AI roda um ditado antigo de novo como outro modo. O guia do History tem os detalhes.
  • Utility. O cartão Transform text recebe um texto colado e o reformata por qualquer modo, como transformar anotações em um e-mail. O guia do Utility trata do resto dessa página.
O painel da barra de menus do YapToText: Start Dictation, seletores de modo e de microfone, Transcribe file, Regenerate e Insert last.
Figura 4. O Regenerate no painel da capivara roda de novo o seu último ditado, ou o texto que você selecionou, por qualquer modo com AI cleanup.

Reescrever um texto selecionado precisa da Acessibilidade, a mesma permissão que deixa o app digitar. Um modo funciona em qualquer texto, inclusive em palavras que você ditou na semana passada.

Limites

  • Um modelo de limpeza. Todo modo, exceto o Raw Transcription, precisa de um. A versão do Homebrew vem sem modelos, então baixe o Phi-3.5 Mini Instruct, de 2,3 GB, na página AI Models antes de contar com um modo de IA.
  • Análise pós-transcrição. Quando essa chave geral da página Home está desligada, nenhum modo roda: todo ditado é digitado exatamente como foi falado, e a página Modes avisa isso.
  • Um modelo pequeno. O modelo de limpeza roda no seu Mac, então veja um modo novo em Try it out antes de contar com ele.
  • Trocas no meio do ditado. A limpeza de um modo novo vale para o ditado em andamento, mas o modelo de fala e o idioma dele valem a partir do próximo.
  • Nove números. As teclas de número chegam aos nove primeiros modos do seletor.

Se um modo faz algo estranho

  1. Veja qual modo rodou. No History, clique em Show pipeline details nesse ditado. A linha Mode o nomeia, e Auto detected diz o que o Auto escolheu.
  2. Confira a chave geral. Na página Home, no cartão After transcription, o Post-transcription analysis precisa estar ativado.
  3. Veja as mesmas palavras. Cole o que você disse em Try it out no editor do modo e compare.
  4. Corrija as instruções. Diga o que manter e também o que mudar, ou use Reset to Default em um modo que já vem no app.
  5. Teste outro modelo. Escolha outro Cleanup model no editor do modo, ou use o Raw Transcription para esse tipo de texto.
  6. Avise-me. Abra uma issue no GitHub com o modo, o que você disse e o que saiu.

Resumindo

  • Raw Transcription. Digita exatamente o que você disse, sem IA.
  • Clean Up e companhia. Arrumam as suas palavras para um e-mail, uma nota, um chat ou um comentário de código.
  • Auto. Vem ativado por padrão e escolhe por você.

Escolha o modo pelo destino das palavras, ou deixe o Auto escolher. Se você vem do superwhisper, a página de alternativa ao superwhisper compara os dois. Se um modo surpreender você, abra uma issue no GitHub. 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

Perguntas

Qual modo do YapToText devo usar?

O Auto, que vem ativado por padrão, escolhe por você. Se você escolher um, o Clean Up tira os "hum" e corrige a gramática sem mudar o sentido, e o Raw Transcription digita exatamente o que você disse.

O Raw Transcription usa IA?

Não. É voz para texto rápido e literal, com pontuação básica: o Whisper ouve você e nada reescreve as palavras.

Posso criar o meu próprio modo de ditado?

Sim. Duplique um modo parecido, ou escolha New Mode sob o botão de mais na página Modes, depois escreva as instruções em frases simples e teste em Try it out.

Por que o modo Email não escreve uma linha de assunto?

As instruções dele escrevem só o corpo do e-mail. Todo modo que já vem no app é editável, então você pode mudar isso.

Cada app pode usar um modo diferente?

Sim. Adicione o app em Apps that use this mode no editor do modo, ou em Settings, Advanced, Per-app modes. Enquanto o modo Auto está ligado, quem decide o texto é o Auto.

Os modos enviam o meu texto para algum lugar?

Não. O modelo de fala e o modelo de limpeza rodam no seu Mac, e as suas palavras e instruções ficam nele.