Custom Commands do VoiceInk: envie o seu ditado a um script em vez de colá-lo
Por Ryleigh Newman · Publicado em
Custom Command é um dos modos de saída do VoiceInk. Em vez de colar, o VoiceInk entrega o texto pronto de um ditado a um comando de shell que você escreve, e esse comando decide o que acontece: anexar o texto a uma nota, abrir uma busca, chamar o seu próprio script ou enviá-lo a um serviço que você mantém. É a coisa mais flexível que o VoiceInk faz com o texto, e tem alguns limites rígidos que vale conhecer antes de montar algo em cima dele.
Eu criei o YapToText, um app de ditado diferente para o Mac, por isso leia o que digo sobre o VoiceInk com isso em mente. Todo fato sobre o VoiceInk aqui vem da documentação dele, lida em 10 de outubro de 2026.
Download 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
O que o comando recebe
O VoiceInk envia o mesmo texto final de duas formas: pela entrada padrão e na variável $VOICEINK_TRANSCRIPT. O texto é UTF-8, e a documentação pede que você coloque a variável entre aspas para que espaços, pontuação e quebras de linha sobrevivam.
- AI Enhancement desativado. A transcrição depois da formatação e das substituições de palavras do VoiceInk.
- AI Enhancement ativado e funcionando. O texto aprimorado.
- AI Enhancement ignorado ou com falha. A transcrição final simples.
O comando nunca recebe diretamente o áudio, o prompt nem o texto selecionado, da área de transferência ou da tela. Se você quer que o contexto molde o resultado, a documentação manda usar um prompt e o Context Awareness, para que ele já esteja no texto final.
Como ele roda
Da documentação do VoiceInk, Custom Commands, lida em 10 de outubro de 2026.
| Detalhe | Comportamento |
|---|---|
| Shell | /bin/zsh -lc |
| Tempo limite | 10 segundos, depois o VoiceInk interrompe o comando |
| Permissões | As mesmas permissões de usuário do macOS que o VoiceInk tem |
| Gravador | Fechado antes de o comando começar |
| Sucesso | Código de saída 0. Qualquer outro conta como falha |
| Saída | A saída padrão e os erros ficam guardados para diagnóstico e nunca são colados no app |
| Comandos não encontrados | O VoiceInk tenta o PATH do seu shell. Use um caminho completo como /opt/homebrew/bin/tool se falhar |
Os limites que pegam as pessoas
- Nada é colado por você. Se você ainda quer o texto no app, o seu comando precisa copiá-lo ou colá-lo por conta própria.
- Dez segundos, sem perguntas. O comando não pode esperar por uma resposta. Para um trabalho mais longo, inicie o seu próprio processo em segundo plano e saia rápido.
- Ele não muda a transcrição salva. O que o comando imprimir não é gravado de volta.
- Sem Auto Send. O Auto Send só funciona com a saída Paste output, e não com o Custom Command.
- Só ditado ao vivo. Os arquivos da fila de Transcribe file são salvos sem rodar comandos de saída.
- Nada de comando vazio. Um Mode com o comando vazio não pode ser salvo.
Os modelos prontos
Da documentação do VoiceInk, Custom Commands, lida em 10 de outubro de 2026.
| Modelo | O que faz |
|---|---|
| Paste and Press Tab | Copia o texto, cola e depois pressiona Tab |
| Lowercase and Paste | Converte o texto em minúsculas, copia e depois cola |
| Remove Trailing Period and Paste | Tira um ponto final antes de colar |
| Append to Journal | Acrescenta o texto a ~/Documents/VoiceInk/journal.md |
| Search Web | Abre uma busca na web pelo texto |
A documentação sugere começar de um modelo e editá-lo. Dois dos exemplos mais simples dela, copiar o texto e acrescentá-lo a uma nota:
printf "%s" "$VOICEINK_TRANSCRIPT" | pbcopymkdir -p "$HOME/Documents/VoiceInk"
printf -- "- %s\n" "$VOICEINK_TRANSCRIPT" >> "$HOME/Documents/VoiceInk/notes.md"Como saber se funcionou
O VoiceInk não mostra mensagem de sucesso nem de falha depois de um Custom Command. A documentação traz um comando do Terminal que mostra os últimos 10 minutos de registros de entrega, incluindo se o comando teve sucesso, falhou ou passou de 10 segundos:
/usr/bin/log show --last 10m --style compact \
--predicate 'subsystem == "com.prakashjoshipax.voiceink" AND category == "TranscriptionDelivery"'A documentação avisa que esses registros podem conter o texto ditado. E se o seu comando envia texto a um serviço na web, esse serviço o recebe: o VoiceInk só roda o que você configurou.
Onde o YapToText se encaixa
VoiceInk, da documentação dele, lida em 10 de outubro de 2026. YapToText, dos próprios ajustes.
| VoiceInk | YapToText | |
|---|---|---|
| Rodar um comando de shell com o texto | Sim, a saída Custom Command | Não |
| Colar no cursor | Paste output | Paste, o padrão |
| Digitar em vez de colar | Não descrito nesta página | Type character by character |
| Só a área de transferência | Com um comando como pbcopy | Copy to clipboard only |
| Pressionar uma tecla depois | Modelo Paste and Press Tab | Return ou Command Return, por app |
| Revisar antes de o texto entrar | Não descrito nesta página | Review before inserting, desativado por padrão |
Se você quer que o ditado acione os seus próprios scripts, o Custom Command do VoiceInk faz algo que o YapToText não faz. Se você quer o texto no cursor, moldado às palavras ao redor, o YapToText faz isso por padrão e não precisa de script. A página dos Modes do VoiceInk mostra onde os modos de saída são definidos, e VoiceInk contra superwhisper o compara com outro app construído em torno de modos.
Download gratuito. Sem conta e sem nada bloqueado, para macOS 14 ou posterior em um Mac com chip da Apple. Código-fonte no GitHub.
Resumindo
- O que é. Um modo de saída que roda o seu comando de shell com o texto final.
- O texto. Na entrada padrão e em $VOICEINK_TRANSCRIPT.
- Limites. 10 segundos, sem entrada, sem colagem automática, só ditado ao vivo.
- Depuração. Nenhuma mensagem no app. Leia o registro com o comando do Terminal acima.
- Por onde começar. Edite um dos cinco modelos.
Se o VoiceInk mudar o funcionamento dos Custom Commands, abra uma issue no GitHub (em inglês) e eu atualizo esta página. Eu leio todas.
Download gratuito. Sem conta e sem nada bloqueado, para macOS 14 ou posterior em um Mac com chip da Apple. Código-fonte no GitHub.
Guias
Mais guias, em inglês
Fontes
- https://tryvoiceink.com/docs/custom-commands (consultado em 10 de outubro de 2026)
- https://tryvoiceink.com/docs/mode-settings (consultado em 10 de outubro de 2026)
- https://github.com/ryleighnewman/YapToText (consultado em 10 de outubro de 2026)
- https://apps.apple.com/us/app/yaptotext/id6786382289 (consultado em 10 de outubro de 2026)
Perguntas
O que é um Custom Command no VoiceInk?
Um modo de saída. Em vez de colar, o VoiceInk roda um comando de shell que você escreve e passa a ele o texto final do ditado.
Como um Custom Command do VoiceInk recebe o texto?
Pela entrada padrão e na variável $VOICEINK_TRANSCRIPT, em UTF-8. Coloque a variável entre aspas para manter espaços e quebras de linha.
Por que o meu Custom Command do VoiceInk não colou nada?
A saída Custom Command não cola sozinha. O seu comando precisa copiar ou colar o texto por conta própria, como faz o modelo Paste and Press Tab.
Por quanto tempo um Custom Command do VoiceInk pode rodar?
10 segundos. Depois disso o VoiceInk o interrompe. Inicie um processo em segundo plano para um trabalho mais longo.
O YapToText tem comandos personalizados como o VoiceInk?
Ele não roda comandos de shell depois de um ditado. Ele cola ou digita no cursor, pode só copiar para a área de transferência e pode pressionar Return depois que o texto entra.