MacWhisperのCLI：mwのインストール、Terminalでの文字起こし、すべてのフラグ

著者 · 公開日

MacWhisperには、mwというコマンドラインツールが付属しています。Terminal（ターミナル）からアプリを操作して、ファイルやフォルダ全体の文字起こし、話者の検出、字幕やJSONの書き出し、モデルの一覧表示と切り替えができます。実行中のMacWhisperアプリとローカルのソケットでやり取りするため、すでに設定したエンジン、モデル、設定がそのまま使われ、アプリが開いていなければ自動で起動します。

私はMac用の別の音声入力・ファイル文字起こしアプリ、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. 新しい Terminal ウインドウを開き、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状態の概要を表示します。アプリに接続できるか、選択中のモデル、ダウンロード済みのモデル、コマンドの例がわかります
mw versionMacWhisperのバージョンを表示します。接続の確認に便利です
mw models listインストール済みの文字起こしモデルを、それぞれのIDとともに一覧表示します
mw models select使用するモデルを、コマンドラインツールとアプリの両方で変更します
mw transcribe音声や動画のファイル、またはフォルダ全体を文字起こしして、テキストを表示します

mw transcribe のフラグ

同じ記事より。選んだモデルが文字起こしできない言語を指定すると、エラーになります。

フラグ内容
--speakers, --no-speakersこの実行だけ、話者検出をオンまたはオフにします。オンにすると、文字起こしが話者ごとにまとめられます
--format初期設定は txt で、srt、vtt、json、csv、md、html、avid も選べます
--styletranscript、subtitles、segments のいずれかで、アプリの Export パネルと同じスタイルです
--modelこの実行だけ1つのモデルを使い、アプリで選んでいるモデルは変更しません
--languageen や de のようなISOコード、または auto、multilingual
--output, -o文字起こしをファイルに書き出します
--output-dirバッチモードです。入力ごとに1つずつ、文字起こしをフォルダに書き出します
--recursiveフォルダを指定したときに、サブフォルダも含めます
--stream完成したセグメントから順に表示します。ローカルのエンジンのみ
--persist文字起こしをMacWhisperの履歴に残します
--timestamps, --milliseconds, --group, --max-chars-per-line, --fpsレイアウトを細かく調整します

出力形式と、Proが必要なもの

同じ記事より。Proの価格は MacWhisperの料金ページ にまとめています。

形式内容ライセンス
txtプレーンテキスト全員
srtSubRip形式の字幕全員
vttWebVTT形式の字幕全員
csv開始、終了、文字起こしの行で、話者を検出した場合は話者も入ります全員
jsonミリ秒単位のタイムスタンプ、セグメントごとの話者、単語ごとのタイミングPro
mdタイムスタンプ付きのブロックと話者の見出しを持つMarkdownPro
html単独で開けるHTML文書Pro
avidSMPTEタイムコード付きのAvid字幕テキスト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 と表示される。 新しい Terminal ウインドウを開くか、/usr/local/bin をPATHに追加してください。
  • 反応しなくなる。 MacWhisperを終了して開き直し、mw version を試してください。
  • モデルIDが認識されない。 mw models list で正確なIDを確認し、先にアプリでそのモデルをダウンロードしてください。
  • 形式でProのエラーが出る。 json、md、html、avid にはProライセンスが必要です。
  • サンドボックスのエラーが出る。 AIコーディングツールなど、サンドボックス内で動くプログラムは、MacWhisperのソケットへの接続を遮断されることがあります。mw は Terminal で直接実行してください。

MacWhisperのトラブルシューティングのページ では、アプリ自体の問題を扱っています。

Terminalで使える無料の方法

YapToTextにはコマンドラインツールがありません。ドロップしたファイルを1つずつ、プレーンテキストに無料で文字起こしします。Terminalを使いたくて、何も購入したくない場合は、オープンソースのwhisper.cppが選択肢になります。YapToTextが土台にしているエンジンでもあります。コマンドは ローカルWhisperのガイド に、無料ツール4つの比較は オープンソース文字起こしのページ にあります。

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で毎日音声入力をしています。このページは英語から翻訳したものです。アプリの画面とサイトのほかのページは英語です。 プロジェクトについて（英語）。

ガイド

そのほかのガイド（英語）

出典

よくある質問

MacWhisperにはコマンドラインツールがありますか？

はい。mwというツールで、MacWhisperの Settings の Advanced にある Command-Line Tool からインストールします。

TerminalからMacWhisperでファイルを文字起こしするには？

mw transcribe のあとにファイルのパスを付けて実行します。文字起こしは標準出力に表示され、-o を付けるとファイルに書き出されます。

MacWhisperのCLIは無料ですか？

ヘルプ記事では、txt、srt、vtt、csv の出力は全員が使え、json、md、html、avid にはProライセンスが必要とされています。

MacWhisperのCLIでフォルダ全体を文字起こしできますか？

はい。mw transcribe にフォルダを渡し、サブフォルダも含めるなら --recursive、ファイルごとに文字起こしを書き出すなら --output-dir を付けます。

mwを使うとき、MacWhisperを開いておく必要はありますか？

mwは実行中のアプリと通信し、MacWhisperが開いていなければ自動で起動します。