MacWhisper CLI: как установить mw, расшифровывать из Терминала и все флаги
Текст: Ryleigh Newman · Опубликовано
В MacWhisper есть утилита командной строки mw. Она управляет приложением из Терминала: расшифровывает файлы и целые папки, определяет говорящих, создаёт субтитры или JSON, показывает список моделей и переключает их. Утилита обращается к запущенному приложению MacWhisper через локальный сокет, поэтому использует те движки, модели и настройки, которые вы уже выбрали, а если приложение закрыто, запускает его.
Я разрабатываю YapToText, другое приложение для Mac, для диктовки и расшифровки файлов, поэтому читайте мои слова о MacWhisper с учётом этого. Все сведения о MacWhisper здесь взяты из его справочной статьи MacWhisper Command-Line Tool, прочитанной 10 октября 2026 года.
Бесплатно. Без учётной записи и без закрытых функций, для macOS 14 или новее на Mac с чипом Apple. Исходный код на GitHub.
Это руководство на других языках: English, العربية, Čeština, Dansk, Deutsch, Ελληνικά, Español, Suomi, Français, עברית, हिन्दी, Magyar, Bahasa Indonesia, Italiano, 日本語, 한국어, Norsk, Nederlands, Polski, Português, Română, Slovenčina, Svenska, ไทย, Türkçe, Українська, Tiếng Việt, 简体中文, 繁體中文
Установка mw
- Откройте MacWhisper, затем Settings (настройки), затем Advanced (дополнительные).
- В разделе Command-Line Tool (утилита командной строки) нажмите Install (установить).
- Если macOS спросит, введите пароль от вашего Mac. Он нужен для записи в /usr/local/bin.
- Откройте новое окно Терминала и выполните mw version.
Утилита появится по адресу /usr/local/bin/mw, а в окне настроек загорится зелёная галочка. Если mw version выводит номер версии, всё работает. Чтобы удалить утилиту, вернитесь в тот же раздел и нажмите Uninstall (удалить).
Как расшифровать файл
mw transcribe ~/Desktop/meeting.m4a
mw transcribe meeting.m4a > transcript.txt
mw transcribe meeting.m4a -o transcript.txt
mw transcribe meeting.m4a | pbcopyЧто происходит. Расшифровка выводится в стандартный вывод. Строка с ходом работы идёт в стандартный поток ошибок, поэтому в перенаправленном файле окажется только текст расшифровки.
По умолчанию расшифровка, сделанная из командной строки, не сохраняется. Она печатается и сразу удаляется, и в истории MacWhisper появится, только если добавить --persist. Ctrl+C останавливает работу. Уже существующий файл с результатом никогда не заменяется, если не добавить --overwrite.
Команды
По справочной статье MacWhisper, прочитанной 10 октября 2026 года. Добавьте --help к любой команде, чтобы увидеть её параметры.
| Команда | Что делает |
|---|---|
| mw | Показывает состояние: доступно ли приложение, какая модель выбрана, какие модели загружены, а также примеры команд |
| mw version | Выводит версию MacWhisper. Удобно для проверки связи с приложением |
| mw models list | Показывает установленные модели распознавания с идентификатором каждой |
| mw models select | Меняет активную модель и в утилите, и в приложении |
| mw transcribe | Расшифровывает аудио- и видеофайлы или целые папки и выводит текст |
Флаги команды mw transcribe
Из той же статьи. Если выбранная модель не умеет расшифровывать заданный язык, команда завершится ошибкой.
| Флаг | Что делает |
|---|---|
| --speakers, --no-speakers | Включает или выключает определение говорящих для этого запуска. Если оно включено, расшифровка группируется по говорящим |
| --format | txt по умолчанию, либо srt, vtt, json, csv, md, html или avid |
| --style | transcript, subtitles или segments, те же стили, что на панели экспорта в приложении |
| --model | Использует одну модель только для этого запуска, не меняя выбор в приложении |
| --language | Код ISO, например en или de, либо auto, либо multilingual |
| --output, -o | Записывает расшифровку в файл |
| --output-dir | Пакетный режим. Записывает по одной расшифровке на каждый исходный файл в папку |
| --recursive | Включает вложенные папки, если вы передали папку |
| --stream | Печатает сегменты по мере готовности. Только для локальных движков |
| --persist | Сохраняет расшифровку в истории MacWhisper |
| --timestamps, --milliseconds, --group, --max-chars-per-line, --fps | Тонкая настройка оформления |
Форматы и какие из них требуют Pro
Из той же статьи. О стоимости Pro рассказывает страница о ценах MacWhisper.
| Формат | Что вы получите | Лицензия |
|---|---|---|
| txt | Простой текст | Все |
| srt | Субтитры SubRip | Все |
| vtt | Субтитры WebVTT | Все |
| csv | Строки с началом, концом и текстом, а при определении говорящих ещё и говорящий | Все |
| json | Метки времени в миллисекундах, говорящие по сегментам и время каждого слова | Pro |
| md | Markdown с блоками по меткам времени и заголовками говорящих | Pro |
| html | Отдельный документ HTML | Pro |
| avid | Текст субтитров Avid с таймкодами SMPTE | Pro |
Целые папки
mw transcribe ~/Recordings --recursive --output-dir ~/Transcripts
mw transcribe ~/Videos --output-dir ~/Subs --format srt
mw transcribe interview.m4a --speakers -o interview.txtЧто происходит. Каждый исходный файл получает собственный файл с тем же именем, а структура папок повторяется. Если файл не удалось обработать, об этом сообщается, файл пропускается и работа продолжается.
Для определения говорящих нужна модель, которая это умеет. Об этой стороне приложения рассказывает страница о распознавании говорящих.
Если не работает
- mw: command not found. Откройте новое окно Терминала или добавьте /usr/local/bin в PATH.
- Команда зависает. Закройте и снова откройте MacWhisper, затем попробуйте mw version.
- Идентификатор модели не распознаётся. Выполните mw models list, чтобы увидеть точные идентификаторы, и сначала загрузите модель в приложении.
- Ошибка о Pro при выборе формата. Для json, md, html и avid нужна лицензия Pro.
- Ошибка песочницы. Программе в песочнице, в том числе некоторым ИИ-инструментам для программирования, может быть закрыт доступ к сокету MacWhisper. Запускайте mw прямо в Терминале.
О самом приложении рассказывает страница о неполадках MacWhisper.
Бесплатные способы из Терминала
У YapToText нет утилиты командной строки. Он расшифровывает файл, который вы перетащили на него, по одному за раз, в простой текст и бесплатно. Если нужен Терминал и ничего покупать не хочется, подойдёт whisper.cpp: у него открытый исходный код, и на нём построен YapToText. Команды есть в руководстве по локальному Whisper, а в обзоре расшифровки с открытым кодом сравниваются четыре бесплатных инструмента.
Бесплатно. Без учётной записи и без закрытых функций, для macOS 14 или новее на Mac с чипом Apple. Исходный код на GitHub.
Коротко
- Установка. Settings, Advanced, Command-Line Tool, Install.
- Запуск. mw transcribe, затем файл или папка.
- Бесплатные форматы. txt, srt, vtt и csv.
- Форматы Pro. json, md, html и avid.
- История. Ничего не сохраняется, пока вы не добавите --persist.
Если MacWhisper изменит утилиту, а эта страница устареет, создайте issue на GitHub. Я читаю каждое.
Бесплатно. Без учётной записи и без закрытых функций, для macOS 14 или новее на Mac с чипом Apple. Исходный код на GitHub.
Руководства
Другие руководства, на английском
Источники
- https://docs.macwhisper.com/article/57-macwhisper-command-line-tool (проверено 10.10.2026)
- https://github.com/ryleighnewman/YapToText (проверено 10.10.2026)
- https://apps.apple.com/us/app/yaptotext/id6786382289 (проверено 10.10.2026)
Вопросы
Есть ли у MacWhisper утилита командной строки?
Да. Она называется mw, и устанавливается в настройках MacWhisper: Settings, Advanced, Command-Line Tool.
Как расшифровать файл в MacWhisper из Терминала?
Выполните mw transcribe и укажите путь к файлу. Расшифровка выводится в стандартный вывод, а с параметром -o записывается в файл.
Бесплатна ли командная строка MacWhisper?
Справочная статья говорит, что результат в txt, srt, vtt и csv доступен всем, а для json, md, html и avid нужна лицензия Pro.
Может ли mw расшифровать целую папку?
Да. Передайте папку команде mw transcribe, добавьте --recursive, чтобы включить вложенные папки, и --output-dir, чтобы записать по одной расшифровке на каждый файл.
Нужно ли держать MacWhisper открытым, чтобы работал mw?
Утилита обращается к запущенному приложению, а если MacWhisper закрыт, запускает его автоматически.