在 AI 語音辨識領域備受好評，很多人用來上字幕、轉逐字稿的 macOS 應用 MacWhisper，今日推出了可能是許多進階用戶期待已久的功能：指令列工具（CLI）。新版 MacWhisper 13.20 版內建了一個名為 mw 的命令行工具，讓用戶可以直接在終端機（Terminal）中進行語音轉文字、管理模型，甚至將轉錄結果整合到自動化腳本中。這項更新意味著 MacWhisper 不再只是一款漂亮的圖形介面 App，更進一步成為 macOS 生態系中強大的 AI 轉錄「引擎」，可被開發者、Podcaster、記者與研究人員整合到各種工作流程中。
什麼是 MacWhisper？
MacWhisper 是由獨立開發者 Jordi Bruin 開發的 macOS 原生語音轉文字應用，底層採用 OpenAI 的 Whisper 模型（經由 whisper.cpp 與 WhisperKit）以及 NVIDIA 的 Parakeet 模型。它最大的優勢在於：
- 完全離線運作：所有語音辨識都在本機完成，不需上傳檔案到雲端。
- Apple Silicon 優化：充分利用 Mac 的神經網路引擎（ANE）與 CoreML 加速。
- 多模型支援：可自由切換不同大小的 Whisper 模型、NVIDIA Parakeet 以及 macOS 26+ 內建的 Apple 語音模型。
MacWhisper 13.20 is out now with full CLI support!
Transcribe and stream media files using any of the local or cloud models, connect to agents and scripts, and use LLMs to refine your transcripts and pass them into your workflows.
Full documentation: https://t.co/ngDkhAOMCu pic.twitter.com/iDnuzWKFRH
— Jordi Bruin (@jordibruin) April 23, 2026
安裝 mw CLI 工具
安裝方式非常簡單，直接在 MacWhisper 圖形介面中操作即可：
- 開啟 MacWhisper → 設定 → Advanced（進階）
- 在 Command-Line Tool（指令列工具） 段落點擊 Install（安裝）
- MacWhisper 會自動將
mw二進位檔案放置到/usr/local/bin/mw - 安裝完成後，畫面會顯示綠色勾勾：「installed at /usr/local/bin/mw」
首次安裝時，macOS 可能會要求輸入密碼，這是因為需要寫入權限到 /usr/local/bin 目錄。若要移除，回到同一個設定頁面點擊 Uninstall 即可。
驗證安裝的方式很簡單，開啟新的終端機視窗輸入：
$ mw version
MacWhisper 13.19.2 (1409)如果看到版本號，就表示安裝成功。
核心指令一覽
mw 提供四個主要子指令，覆蓋了轉錄工作的核心需求：
| 指令 | 功能說明 |
|---|---|
mw version |
顯示 MacWhisper 版本，可作為連線檢查 |
mw models list |
列出目前已安裝的語音辨識模型 |
mw models select <id> |
切換當前使用的模型 |
mw transcribe <檔案> |
轉錄音訊或影片檔案，輸出文字 |
只輸入 mw 會顯示完整的幫助摘要；在任何子指令後加上 --help 可查看更多詳細選項（如 mw transcribe --help）。
管理工作：列出與切換模型
mw 支援多種語音辨識引擎，包括 OpenAI Whisper、NVIDIA Parakeet 與 Apple 原生語音模型：
$ mw models list
ID NAME SIZE
whisper-cpp:ggml-tiny.en Tiny (English Only) 80 MB
whisperkit:openai_whisper-small Small 483 MB
▸ parakeet-pro:nvidia_parakeet-v2_476MB Parakeet v2 (476MB) 476 MB
apple:en-GB English (United Kingdom) -▸標記表示當前正在使用的模型- ID 欄位（如
whisperkit:openai_whisper-small）就是你在--model或mw models select指令中要傳入的名稱 apple:<locale>項目是 macOS 26+ 提供的 Apple 本機語音模型，容量由系統管理
切換模型也只需要一行指令：
$ mw models select whisperkit:openai_whisper-small
Selected: whisperkit:openai_whisper-small (Small)切換會立即生效，同時影響 CLI 與 MacWhisper 圖形介面。
轉錄音檔：最核心的功能
最基本的用法就是直接傳入一個音訊或影片檔案：
$ mw transcribe ~/Desktop/meeting.m4a
Hello everyone, welcome to the meeting...轉錄結果預設為 暫態（transient）：只輸出到終端機後即丟棄，不會儲存在 MacWhisper 的歷史記錄中。這對處理大量臨時檔案或隱私敏感內容非常實用。
實用參數
mw transcribe 支援多個實用旗標：
| 參數 | 範例 | 說明 |
|---|---|---|
--model |
mw transcribe --model apple:en-GB talk.wav |
指定此次使用的模型 |
--output |
mw transcribe --output transcript.txt meeting.m4a |
將結果寫入檔案 |
--format |
--format srt / vtt / txt / json |
選擇輸出格式 |
--timestamps |
mw transcribe --timestamps podcast.mp3 |
輸出含時間戳記 |
--stream |
mw transcribe --stream live.m4a |
即時串流模式 |
Pipeline 整合
CLI 的真正威力在於可與其他 Unix 指令串接：
# 轉錄後直接統計字數
mw transcribe meeting.m4a | wc -w
# 轉錄後進行翻譯（需先安裝 translate-cli）
mw transcribe meeting.m4a | trans -b :zh-TW
# 轉錄後用 Glow 渲染 Markdown
mw transcribe meeting.m4a | glow -底層技術與運作原理
mw CLI 工具透過本機 Socket 與正在執行的 MacWhisper 應用溝通，因此它使用的完全是你已經在圖形介面中設定好的引擎、模型與參數。如果呼叫 mw 時 MacWhisper 尚未啟動，CLI 會自動為你啟動它。
這意味著：
- 你不需要額外安裝 Python、PyTorch 或任何依賴套件
- 轉錄品質與圖形介面完全一致
- 模型管理（下載、更新）仍須透過 MacWhisper UI 進行
慶祝上市：Pro 版本 10% 折扣
為了慶祝 CLI 工具上市，開發者 Jordi Bruin 推出了 MacWhisper Pro 的 10% 折扣優惠（也有免費版）。Pro 版本提供批次轉錄、高精度模型與更長音訊支援，適合專業工作者使用。