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
З тієї самої статті. Сторінка про ціни MacWhisper розповідає, скільки коштує Pro.
| Формат | Що ви отримуєте | Ліцензія |
|---|---|---|
| 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 CLI?
Його довідкова стаття каже, що формати txt, srt, vtt і csv доступні всім, а json, md, html і avid потребують ліцензії Pro.
Чи може MacWhisper CLI розшифрувати цілу папку?
Так. Передайте папку в mw transcribe, додайте --recursive для вкладених папок і --output-dir, щоб записати окрему розшифровку для кожного файлу.
Чи має MacWhisper бути відкритим, щоб працював mw?
Утиліта звертається до запущеної програми, а якщо MacWhisper не відкрито, запускає його автоматично.