yt-dlp & FFmpeg 導入マニュアル

動画ダウンロードツールと変換ツールのセットアップガイド

1 OSを選択してください

Mac OS での手順

1. Homebrewのインストール

ターミナルを起動し、以下のコマンドをコピーして貼り付けて実行してください。

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

※Xcode Command Line Toolsが自動的にインストールされますが、大容量の為通信環境の良い場所で作業してください。

2. パスの設定（環境構築）

インストール完了後、以下の2つのコマンドを順番に実行してください。

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc
eval "$(/opt/homebrew/bin/brew shellenv)"

3. ツールのインストール

yt-dlp、ffmpeg、Node.js（JavaScript環境）をまとめてインストールします。

brew install yt-dlp ffmpeg node

Windows での手順

1. Pythonのインストール

公式サイトからインストーラーをダウンロードします。

Python公式サイトへ

※重要：インストール時に「Add Python to PATH」に必ずチェックを入れてください。

2. ツールのインストール準備

PowerShellを管理者として起動してください。

3. FFmpegのインストール

以下のコマンドを入力して実行します。

winget install ffmpeg

4. yt-dlpのインストール

以下のコマンドを入力して実行します。

pip install yt-dlp

5. Node.jsのインストール

以下のコマンドを入力してNode.jsをインストールします。

winget install OpenJS.NodeJS

困ったときのQ&A

Q. 「コマンドが見つかりません」と出る

インストールが正常に完了していません。

  • Windows: Pythonインストール時に「Add to PATH」にチェックを入れましたか？ PowerShellを再起動しましたか？
  • Mac: インストール完了後にターミナルを一度終了し、再起動してみてください。

Q. エラーが出てダウンロードできない

YouTubeの仕様変更により、ツールが古くなっている可能性があります。更新コマンドを実行してください。

Windows pip install -U yt-dlp
Mac brew upgrade yt-dlp

Q. 上記を見てもわからない場合

一栁にSignal経由でご連絡ください。
個別にご対応いたします。