MacWhisper CLI：安裝 mw、在終端機轉錄，以及每一個參數

作者 · 發佈於

MacWhisper 內建一個命令列工具，叫 mw。它讓你在終端機裡操作這個 App：轉錄檔案和整個資料夾、辨識說話者、輸出字幕或 JSON，也能列出和切換模型。它透過本機 socket 和正在執行的 MacWhisper 溝通，所以會用到你已經設定好的引擎、模型和設定。如果 App 沒有開啟，它會自動啟動。

我做的是另一款 Mac 聽寫和檔案轉錄 App，叫 YapToText，所以請在閱讀我對 MacWhisper 的說法時記得這一點。這裡關於 MacWhisper 的每一項內容，都來自它的說明文章 MacWhisper Command-Line Tool，我在 2026年10月10日讀過。

在 Mac App Store 下載 YapToText免費下載。不需要帳號，沒有鎖住的功能。需要搭載 Apple 晶片的 Mac 和 macOS 14 或以上版本。 原始碼在 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

  1. 打開 MacWhisper，然後依序進入 Settings（設定）和 Advanced（進階）。
  2. 在 Command-Line Tool（命令列工具）下按一下 Install（安裝）。
  3. 如果 macOS 要求，請輸入你的 Mac 密碼。寫入 /usr/local/bin 需要它。
  4. 打開新的終端機視窗，執行 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

執行結果：逐字稿會印到標準輸出。進度行會送到標準錯誤，所以重新導向的檔案裡只有逐字稿。

用命令列轉錄預設不會保存。結果只會印出來，然後丟棄，只有加上 --persist，才會出現在 MacWhisper 的歷史記錄裡。按 Ctrl+C 可以中止執行。已經存在的輸出檔案不會被取代，除非你加上 --overwrite。

所有指令

來自 MacWhisper 的說明文章，2026年10月10日查閱。在任何指令後面加上 --help，就能看到它的選項。

指令作用
mw狀態總覽：App 是否連得上、目前選的模型、已下載的模型，以及範例指令
mw version印出 MacWhisper 的版本。可以用來檢查連線
mw models list列出你已安裝的轉錄模型，每個模型都有一個 ID
mw models select更換使用中的模型，命令列工具和 App 裡都會改變
mw transcribe轉錄音訊或影片檔案，或整個資料夾，並印出文字

mw transcribe 的參數

來自同一篇文章。選用的模型無法轉錄的語言，會產生錯誤。

參數作用
--speakers, --no-speakers這一次執行開啟或關閉說話者偵測。開啟時，逐字稿會依說話者分組
--format預設是 txt，也可以是 srt、vtt、json、csv、md、html 或 avid
--styletranscript、subtitles 或 segments，和 App 輸出面板的樣式相同
--model這一次執行使用指定的模型，不會更改 App 裡的選擇
--languageISO 代碼，例如 en 或 de，或是 auto，或是 multilingual
--output, -o把逐字稿寫入檔案
--output-dir批次模式。每個輸入檔案各寫一份逐字稿，放進一個資料夾
--recursive傳入資料夾時，連子資料夾也一起處理
--stream每完成一個片段就印出來。只適用於本機引擎
--persist把這次轉錄保存在 MacWhisper 的歷史記錄裡
--timestamps, --milliseconds, --group, --max-chars-per-line, --fps微調版面

格式，以及哪些需要 Pro

來自同一篇文章。Pro 的價格請見 MacWhisper 價格頁面。

格式內容授權
txt純文字所有人
srtSubRip 字幕所有人
vttWebVTT 字幕所有人
csv每列有開始、結束和逐字稿，偵測到說話者時還有說話者所有人
json毫秒時間戳記、每個片段的說話者，以及逐字的時間Pro
mdMarkdown，有帶時間戳記的區塊和說話者標題Pro
html獨立的 HTML 文件Pro
avidAvid 字幕文字，使用 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

執行結果：每個輸入檔案都有自己的輸出檔案，以它為名，資料夾結構也會照樣重現。失敗的檔案會被回報並跳過，其餘的繼續處理。

說話者偵測需要支援它的模型。App 這方面的功能請見說話者辨識頁面。

沒有作用時

  • mw: command not found。請打開新的終端機視窗，或把 /usr/local/bin 加進 PATH。
  • 卡住不動。結束 MacWhisper 再重新打開，然後試 mw version。
  • 無法辨識模型 ID。執行 mw models list 取得正確的 ID，並先在 App 裡下載該模型。
  • 某個格式出現 Pro 錯誤。json、md、html 和 avid 需要 Pro 授權。
  • 沙盒錯誤。在沙盒裡執行的程式，包括某些 AI 寫程式工具，可能被擋在 MacWhisper 的 socket 之外。請直接在終端機裡執行 mw。

App 本身的問題請見 MacWhisper 疑難排解頁面。

在終端機使用的免費方法

YapToText 沒有命令列工具。它可以轉錄你拖進去的檔案，一次一個，輸出純文字，免費。如果你想用終端機，又不想花錢，whisper.cpp 是開放原始碼的，也是 YapToText 所用的引擎。指令請見本機 Whisper 指南，開放原始碼轉錄軟體頁面則比較了四款免費工具。

在 Mac App Store 下載 YapToText免費下載。不需要帳號，沒有鎖住的功能。需要搭載 Apple 晶片的 Mac 和 macOS 14 或以上版本。 原始碼在 GitHub 上。

重點整理

  • 安裝。Settings，Advanced，Command-Line Tool，Install。
  • 執行。mw transcribe，後面接檔案或資料夾。
  • 免費格式。txt、srt、vtt 和 csv。
  • Pro 格式。json、md、html 和 avid。
  • 歷史記錄。除非加上 --persist，否則什麼都不會保存。

如果 MacWhisper 更改了這個工具，而這個頁面沒跟上，請在 GitHub 上提交 issue。每一則我都會看。

在 Mac App Store 下載 YapToText免費下載。不需要帳號，沒有鎖住的功能。需要搭載 Apple 晶片的 Mac 和 macOS 14 或以上版本。 原始碼在 GitHub 上。

關於作者。 Ryleigh Newman 從事軟體開發，用手打字有困難，每天都用本站介紹的 YapToText 聽寫。本頁譯自英文。App 的介面和網站的其他頁面是英文的。 進一步瞭解這個專案（英文）。

指南

更多指南（英文）

資料來源

常見問題

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 為每個檔案各寫一份逐字稿。

mw 需要先開啟 MacWhisper 嗎？

它會和正在執行的 App 溝通，如果 MacWhisper 沒有開啟，它會自動啟動。