La CLI de MacWhisper: cómo instalar mw, transcribir desde Terminal y todas sus opciones
Por Ryleigh Newman · Publicado el
MacWhisper incluye una herramienta de línea de comandos que se llama mw. Maneja la app desde Terminal: transcribe archivos y carpetas enteras, detecta hablantes, escribe subtítulos o JSON, y enumera o cambia modelos. Se comunica con la app MacWhisper en ejecución mediante un socket local, así que usa los motores, los modelos y los ajustes que ya configuraste, y abre la app si no está abierta.
Creé YapToText, otra app de Mac para dictado y transcripción de archivos, así que lee con eso en mente lo que digo de MacWhisper. Cada dato sobre MacWhisper de esta página sale de su artículo de ayuda MacWhisper Command-Line Tool, leído el 10 de octubre de 2026.
Descarga gratuita. Sin cuenta y sin nada bloqueado, para macOS 14 o posterior en un Mac con chip de Apple. Código fuente en GitHub.
Esta guía en otros idiomas: English, العربية, Čeština, Dansk, Deutsch, Ελληνικά, Suomi, Français, עברית, हिन्दी, Magyar, Bahasa Indonesia, Italiano, 日本語, 한국어, Norsk, Nederlands, Polski, Português, Română, Русский, Slovenčina, Svenska, ไทย, Türkçe, Українська, Tiếng Việt, 简体中文, 繁體中文
En esta página: 13 secciones
Instalar mw
- Abre MacWhisper, luego Settings (los ajustes de la app) y después Advanced.
- En Command-Line Tool, haz clic en Install.
- Escribe la contraseña de tu Mac si macOS la pide. Hace falta para escribir en /usr/local/bin.
- Abre una ventana nueva de Terminal y ejecuta mw version.
La herramienta queda en /usr/local/bin/mw, y el panel de ajustes muestra una marca de verificación verde cuando termina. Si mw version imprime un número de versión, funciona. Para quitarla, vuelve al mismo panel y haz clic en Uninstall.
Transcribir un archivo
mw transcribe ~/Desktop/meeting.m4a
mw transcribe meeting.m4a > transcript.txt
mw transcribe meeting.m4a -o transcript.txt
mw transcribe meeting.m4a | pbcopyQué pasa: La transcripción se imprime en la salida estándar. Una línea de progreso va al error estándar, así que un archivo redirigido contiene solo la transcripción.
Por defecto, una transcripción hecha por línea de comandos no se guarda. Se imprime y se descarta, y aparece en el historial de MacWhisper solo si añades --persist. Ctrl+C detiene una ejecución. Un archivo de salida que ya existe nunca se reemplaza, salvo que añadas --overwrite.
Los comandos
Del artículo de ayuda de MacWhisper, leído el 10 de octubre de 2026. Añade --help a cualquier comando para ver sus opciones.
| Comando | Qué hace |
|---|---|
| mw | Un resumen del estado: si se puede llegar a la app, el modelo seleccionado, los modelos descargados y comandos de ejemplo |
| mw version | Imprime la versión de MacWhisper. Sirve para comprobar la conexión |
| mw models list | Enumera tus modelos de transcripción instalados, con un ID para cada uno |
| mw models select | Cambia el modelo activo, en la herramienta de línea de comandos y en la app |
| mw transcribe | Transcribe archivos de audio o de vídeo, o carpetas enteras, e imprime el texto |
Opciones de mw transcribe
Del mismo artículo. Un idioma que el modelo elegido no puede transcribir da un error.
| Opción | Qué hace |
|---|---|
| --speakers, --no-speakers | Activa o desactiva la detección de hablantes en esta ejecución. Con ella activada, la transcripción se agrupa por hablante |
| --format | txt, el valor por defecto, o srt, vtt, json, csv, md, html o avid |
| --style | transcript, subtitles o segments, los mismos estilos que el panel de exportación de la app |
| --model | Usa un modelo en esta ejecución sin cambiar el que está seleccionado en la app |
| --language | Un código ISO como en o de, o auto, o multilingual |
| --output, -o | Escribe la transcripción en un archivo |
| --output-dir | Modo por lotes. Escribe una transcripción por cada entrada en una carpeta |
| --recursive | Incluye las subcarpetas cuando le pasas una carpeta |
| --stream | Imprime los segmentos a medida que terminan. Solo con motores locales |
| --persist | Guarda la transcripción en el historial de MacWhisper |
| --timestamps, --milliseconds, --group, --max-chars-per-line, --fps | Ajustan el formato con más detalle |
Formatos y cuáles necesitan Pro
Del mismo artículo. La página de precios de MacWhisper explica cuánto cuesta Pro.
| Formato | Qué obtienes | Licencia |
|---|---|---|
| txt | Texto sin formato | Todos |
| srt | Subtítulos SubRip | Todos |
| vtt | Subtítulos WebVTT | Todos |
| csv | Filas con inicio, fin y transcripción, y el hablante cuando se detecta | Todos |
| json | Marcas de tiempo en milisegundos, hablantes por segmento y tiempos de cada palabra | Pro |
| md | Markdown con bloques con marca de tiempo y títulos por hablante | Pro |
| html | Un documento HTML independiente | Pro |
| avid | Texto de subtítulos de Avid con códigos de tiempo SMPTE | Pro |
Carpetas enteras
mw transcribe ~/Recordings --recursive --output-dir ~/Transcripts
mw transcribe ~/Videos --output-dir ~/Subs --format srt
mw transcribe interview.m4a --speakers -o interview.txtQué pasa: Cada entrada recibe su propio archivo, con su nombre, y se reproduce la estructura de carpetas. Un archivo que falla se notifica y se omite, y la ejecución continúa.
La detección de hablantes necesita un modelo que la admita. La página del reconocimiento de hablantes explica esa parte de la app.
Cuando no funciona
- mw: command not found. Abre una ventana nueva de Terminal, o añade /usr/local/bin a tu PATH.
- Se queda colgado. Cierra y vuelve a abrir MacWhisper, y prueba otra vez mw version.
- No se reconoce un ID de modelo. Ejecuta mw models list para ver los ID exactos, y descarga antes el modelo en la app.
- Un error de Pro con un formato. json, md, html y avid necesitan una licencia Pro.
- Un error de sandbox. Un programa en sandbox, incluidas algunas herramientas de programación con IA, puede tener bloqueado el acceso al socket de MacWhisper. Ejecuta mw directamente en Terminal.
La página de solución de problemas de MacWhisper trata de la app en sí.
Opciones gratuitas desde Terminal
YapToText no tiene herramienta de línea de comandos. Transcribe un archivo que sueltas en la app, de uno en uno, a texto sin formato, y es gratis. Si quieres Terminal y no comprar nada, whisper.cpp es de código abierto y es el motor sobre el que está hecho YapToText. La guía de Whisper en local tiene los comandos, y la página del software de transcripción de código abierto compara cuatro herramientas gratuitas.
Descarga gratuita. Sin cuenta y sin nada bloqueado, para macOS 14 o posterior en un Mac con chip de Apple. Código fuente en GitHub.
En resumen
- Instalar. Settings, Advanced, Command-Line Tool, Install.
- Ejecutar. mw transcribe, y después un archivo o una carpeta.
- Formatos gratuitos. txt, srt, vtt y csv.
- Formatos Pro. json, md, html y avid.
- Historial. No se guarda nada a menos que añadas --persist.
Si MacWhisper cambia la herramienta y esta página se queda atrás, abre un issue en GitHub (en inglés). Los leo todos.
Descarga gratuita. Sin cuenta y sin nada bloqueado, para macOS 14 o posterior en un Mac con chip de Apple. Código fuente en GitHub.
Guías
Más guías, en inglés
Fuentes
- https://docs.macwhisper.com/article/57-macwhisper-command-line-tool (consultado el 10 de octubre de 2026)
- https://github.com/ryleighnewman/YapToText (consultado el 10 de octubre de 2026)
- https://apps.apple.com/us/app/yaptotext/id6786382289 (consultado el 10 de octubre de 2026)
Preguntas
¿MacWhisper tiene una herramienta de línea de comandos?
Sí. Se llama mw, y se instala desde los ajustes de MacWhisper, en Advanced, Command-Line Tool.
¿Cómo transcribo un archivo con MacWhisper desde Terminal?
Ejecuta mw transcribe seguido de la ruta del archivo. La transcripción se imprime en la salida estándar, o en un archivo si usas -o.
¿La CLI de MacWhisper es gratis?
Su artículo de ayuda dice que la salida en txt, srt, vtt y csv está disponible para todos, y que json, md, html y avid necesitan una licencia Pro.
¿La CLI de MacWhisper puede transcribir una carpeta entera?
Sí. Pasa una carpeta a mw transcribe, añade --recursive para las subcarpetas y --output-dir para escribir una transcripción por archivo.
¿mw necesita que MacWhisper esté abierto?
Se comunica con la app en ejecución, y abre MacWhisper automáticamente si no está abierta.