環境構築 — ffmpeg・Whisper・auto-editorをMacにインストールする【第2回】

実際に環境を構築した記録。macOS（Apple Silicon）での手順。

前提

• macOS（Apple Silicon）
• Homebrew インストール済み
• Python 3.x インストール済み

1. ffmpegをインストール

brew install ffmpeg

数分かかる。完了したら確認。

ffmpeg -version
# ffmpeg version 8.x ...

2. WhisperとAuto-editorをインストール

pip3 install openai-whisper auto-editor

macOSでのハマりポイント

Python 3.12以降を使っている場合、以下のエラーが出ることがある。

error: externally-managed-environment

これはHomebrewのPython環境を保護するためのものだ。--break-system-packages フラグをつけると回避できる。

pip3 install openai-whisper auto-editor --break-system-packages

インストール時にPyTorchも一緒に入るので、合計で数GBになる。

3. Whisperのモデルダウンロード

初回実行時にモデルファイルが自動でダウンロードされる。

モデル	サイズ	精度	速度
tiny	75MB	低	速い
base	145MB	中	普通
turbo	1.5GB	高	普通
large	3GB	最高	遅い

日本語の精度を優先するなら turbo 以上を選ぶ。

# turboモデルを使う場合
whisper test.mp4 --model turbo --language Japanese

初回実行時は ~/.cache/whisper/ にモデルがダウンロードされる。

ファイル名の特殊文字に注意

macOSのスクリーン録画ファイル名には ナローノーブレークスペース（U+202F） が含まれている。通常のスペースと見た目が同じなのでわかりにくい。

Screen Recording 2026-04-10 at 12.50.43 PM.mov
                                         ↑ U+202F（通常スペースではない）

シェルからアクセスしようとすると「ファイルが見つからない」エラーになる。

# これはエラーになる
whisper "Screen Recording 2026-04-10 at 12.50.43 PM.mov"
# Error opening input: No such file or directory

回避策はPythonで正確なファイル名を取得してからコピーすること。

import shutil, os

files = os.listdir(os.path.expanduser('~/Desktop'))
target = [f for f in files if '12.50.43' in f][0]
src = os.path.expanduser('~/Desktop/') + target
shutil.copy2(src, '/tmp/test.mov')

または最初からスペースのないパスに保存するか、ファイルをリネームしてから処理する。

動作確認

# バージョン確認
ffmpeg -version
whisper --help
auto-editor --help

3つとも応答が返れば環境構築完了。第3回ではWhisperで実際に文字起こしを行う。