A CLI do MacWhisper: instalar o mw, transcrever pelo Terminal e todas as flags
Por Ryleigh Newman · Publicado em
O MacWhisper vem com uma ferramenta de linha de comando chamada mw. Ela controla o app pelo Terminal: transcreve arquivos e pastas inteiras, detecta falantes, gera legendas ou JSON e lista ou troca os modelos. Ela conversa com o app MacWhisper em execução por um socket local, então usa os motores, os modelos e os ajustes que você já configurou, e abre o app se ele não estiver aberto.
Eu criei o YapToText, outro app para o Mac de ditado e transcrição de arquivos, então leia o que digo sobre o MacWhisper com isso em mente. Todo fato sobre o MacWhisper aqui vem do artigo de ajuda dele, MacWhisper Command-Line Tool, consultado 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: 13 seções
Instalar o mw
- Abra o MacWhisper, depois Settings (os ajustes) e Advanced (avançado).
- Em Command-Line Tool (ferramenta de linha de comando), clique em Install (instalar).
- Digite a senha do seu Mac se o macOS pedir. Ela é necessária para gravar em /usr/local/bin.
- Abra uma nova janela do Terminal e execute mw version.
A ferramenta fica em /usr/local/bin/mw, e o painel de ajustes mostra uma marca de verificação verde quando termina. Se mw version mostrar um número de versão, está funcionando. Para remover, volte ao mesmo painel e clique em Uninstall (desinstalar).
Transcrever um arquivo
mw transcribe ~/Desktop/meeting.m4a
mw transcribe meeting.m4a > transcript.txt
mw transcribe meeting.m4a -o transcript.txt
mw transcribe meeting.m4a | pbcopyO que acontece: A transcrição é impressa na saída padrão. Uma linha de progresso vai para o erro padrão, então um arquivo redirecionado contém só a transcrição.
Por padrão, uma transcrição feita pela linha de comando não é guardada. Ela é impressa e descartada, e só aparece no histórico do MacWhisper se você adicionar --persist. Ctrl+C interrompe uma execução. Um arquivo de saída que já existe nunca é substituído, a menos que você adicione --overwrite.
Os comandos
Do artigo de ajuda do MacWhisper, consultado em 10 de outubro de 2026. Adicione --help a qualquer comando para ver as opções dele.
| Comando | O que faz |
|---|---|
| mw | Uma visão geral do estado: se o app está acessível, o modelo selecionado, os modelos baixados e exemplos de comandos |
| mw version | Mostra a versão do MacWhisper. Serve para conferir a conexão |
| mw models list | Lista os modelos de transcrição instalados, com um ID para cada um |
| mw models select | Troca o modelo ativo, na ferramenta de linha de comando e no app |
| mw transcribe | Transcreve arquivos de áudio ou vídeo, ou pastas inteiras, e mostra o texto |
Flags do mw transcribe
Do mesmo artigo. Um idioma que o modelo escolhido não consegue transcrever gera um erro.
| Flag | O que faz |
|---|---|
| --speakers, --no-speakers | Liga ou desliga a detecção de falantes nesta execução. Ligada, a transcrição é agrupada por falante |
| --format | txt, o padrão, ou srt, vtt, json, csv, md, html ou avid |
| --style | transcript, subtitles ou segments, os mesmos estilos do painel Export do app |
| --model | Usa um modelo nesta execução, sem mudar a seleção do app |
| --language | Um código ISO como en ou de, ou auto, ou multilingual |
| --output, -o | Grava a transcrição em um arquivo |
| --output-dir | Modo em lote. Grava uma transcrição por arquivo de entrada em uma pasta |
| --recursive | Inclui as subpastas quando você informa uma pasta |
| --stream | Mostra os segmentos à medida que ficam prontos. Só em motores locais |
| --persist | Guarda a transcrição no histórico do MacWhisper |
| --timestamps, --milliseconds, --group, --max-chars-per-line, --fps | Ajustam o layout |
Formatos, e quais exigem o Pro
Do mesmo artigo. A página de preços do MacWhisper mostra quanto custa o Pro.
| Formato | O que você recebe | Licença |
|---|---|---|
| txt | Texto simples | Todos |
| srt | Legendas SubRip | Todos |
| vtt | Legendas WebVTT | Todos |
| csv | Linhas com início, fim e transcrição, mais o falante quando detectado | Todos |
| json | Marcações de tempo em milissegundos, falantes por segmento e tempos das palavras | Pro |
| md | Markdown com blocos marcados no tempo e títulos de falantes | Pro |
| html | Um documento HTML independente | Pro |
| avid | Texto de legenda Avid com timecodes SMPTE | Pro |
Pastas inteiras
mw transcribe ~/Recordings --recursive --output-dir ~/Transcripts
mw transcribe ~/Videos --output-dir ~/Subs --format srt
mw transcribe interview.m4a --speakers -o interview.txtO que acontece: Cada arquivo de entrada recebe o próprio arquivo, com o mesmo nome, e a estrutura de pastas é espelhada. Um arquivo que falha é registrado e ignorado, e a execução continua.
A detecção de falantes precisa de um modelo que a ofereça. A página sobre o reconhecimento de falantes trata desse lado do app.
Quando não funciona
- mw: command not found. Abra uma nova janela do Terminal, ou adicione /usr/local/bin ao seu PATH.
- Ele trava. Feche e abra de novo o MacWhisper, depois tente mw version.
- Um ID de modelo não é reconhecido. Execute mw models list para ver os IDs exatos e baixe antes o modelo no app.
- Um erro de Pro em um formato. json, md, html e avid exigem uma licença Pro.
- Um erro de sandbox. Um programa em sandbox, incluindo algumas ferramentas de programação com IA, pode ser bloqueado no socket do MacWhisper. Execute o mw direto no Terminal.
A página de solução de problemas do MacWhisper trata do app em si.
Opções gratuitas pelo Terminal
O YapToText não tem ferramenta de linha de comando. Ele transcreve um arquivo que você solta nele, um de cada vez, para texto simples, de graça. Se você quer o Terminal sem pagar nada, o whisper.cpp é de código aberto e é o motor em que o YapToText se baseia. O guia do Whisper local traz os comandos, e a página sobre transcrição de código aberto compara quatro ferramentas gratuitas.
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
- Instalar. Settings, Advanced, Command-Line Tool, Install.
- Executar. mw transcribe, depois um arquivo ou uma pasta.
- Formatos gratuitos. txt, srt, vtt e csv.
- Formatos Pro. json, md, html e avid.
- Histórico. Nada é guardado, a menos que você adicione --persist.
Se o MacWhisper mudar a ferramenta e esta página ficar desatualizada, abra uma issue no GitHub. 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://docs.macwhisper.com/article/57-macwhisper-command-line-tool (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 MacWhisper tem uma ferramenta de linha de comando?
Sim. Ela se chama mw, e você a instala nos ajustes do MacWhisper, em Advanced, Command-Line Tool.
Como transcrever um arquivo com o MacWhisper pelo Terminal?
Execute mw transcribe seguido do caminho do arquivo. A transcrição é impressa na saída padrão, ou em um arquivo com -o.
A CLI do MacWhisper é gratuita?
O artigo de ajuda diz que a saída em txt, srt, vtt e csv está disponível para todos, e que json, md, html e avid exigem uma licença Pro.
A CLI do MacWhisper transcreve uma pasta inteira?
Sim. Informe uma pasta ao mw transcribe, adicione --recursive para incluir as subpastas e --output-dir para gravar uma transcrição por arquivo.
O mw precisa que o MacWhisper esteja aberto?
Ele conversa com o app em execução e abre o MacWhisper automaticamente se ele não estiver aberto.