本文へスキップ
yt-dlp

macOS に yt-dlp をインストールする

Homebrew か pipx で macOS に yt-dlp と ffmpeg を入れ、最新の状態に保ちます。

1. yt-dlp を入れる

Homebrew がいちばん手間のかからない方法で、両方のツールを一行で入れられます。

brew install yt-dlp ffmpeg

Homebrew を使わない場合、pipx は yt-dlp を専用の環境に置くので、Python 経由で入れた他のものと衝突しません。

pipx install yt-dlp

システムの Python への素の pip install は避けてください。最近の macOS はこれを止めにかかりますし、通ったとしても後で無関係な理由で壊れがちです。

2. ffmpeg を入れる

Homebrew を使ったなら上で一緒に入っています。そうでなければ別に入れてください。結合も MP3 の抽出も埋め込みも、すべてこれに依存します。

brew install ffmpeg

3. うまくいったか確認する

yt-dlp --version
ffmpeg -version

pipx で入れたあとシェルが yt-dlp を見つけられない場合は、pipx ensurepath を実行して新しいターミナルを開いてください。

Safari の Cookie

--cookies-from-browser safari にはターミナルへの Full Disk Access が必要で、System Settings → Privacy & Security で許可します。ないと権限エラーで失敗しますが、そのメッセージはこの設定に触れません。Chrome と Firefox はこれなしで動きます。

更新

brew upgrade yt-dlp     # Homebrew
pipx upgrade yt-dlp     # pipx

よくある質問

pipx で入れたあと macOS が yt-dlp を見つけられません。
pipx ensurepath を実行し、新しい端末を開いて更新後の PATH を読み込ませてください。
macOS で cookies を使うのに何か追加設定が必要ですか?
Safari の場合だけです:--cookies-from-browser safari は端末にフルディスクアクセスを要求します(システム設定 → プライバシーとセキュリティ)。Chrome と Firefox は不要です。