動画ダウンロード
URL から yt-dlp を直接使用して動画や音声をダウンロードします。ラッパースクリプトは不要です。
前提条件
- yt-dlp:
brew install yt-dlpまたはpip install yt-dlp - ffmpeg:
brew install ffmpegまたはapt install ffmpeg(動画と音声ストリームの結合に必要)
サイトの変更に対応するため、yt-dlp を定期的に更新してください: yt-dlp -U または pip install -U yt-dlp。
コマンド
最高品質でダウンロード
yt-dlp "URL" -o "%(title)s.%(ext)s" --merge-output-format mp4
特定の解像度でダウンロード
# 720p
yt-dlp "URL" -f "bestvideo[height<=720]+bestaudio/best[height<=720]" --merge-output-format mp4
# 1080p
yt-dlp "URL" -f "bestvideo[height<=1080]+bestaudio/best[height<=1080]" --merge-output-format mp4
音声のみ
yt-dlp "URL" -x --audio-format mp3 --audio-quality 0
字幕のダウンロード
# 動画を英語字幕付きでダウンロード
yt-dlp "URL" --write-subs --sub-langs en --merge-output-format mp4
# 複数の字幕言語で動画をダウンロード
yt-dlp "URL" --write-subs --sub-langs "en,es,fr" --merge-output-format mp4
# 字幕のみをダウンロード(動画なし)
yt-dlp "URL" --write-subs --sub-langs en --skip-download
メタデータの取得(ダウンロードなし)
yt-dlp "URL" --dump-json --no-download
利用可能な形式の一覧表示
yt-dlp "URL" -F
出力ディレクトリの指定
yt-dlp "URL" -o "./downloads/%(title)s.%(ext)s" --merge-output-format mp4
品質プリセット
| 品質 | フォーマットフラグ |
|---|---|
| 最高 | -f "bestvideo+bestaudio/best"(デフォルト) |
| 1080p | -f "bestvideo[height<=1080]+bestaudio/best[height<=1080]" |
| 720p | -f "bestvideo[height<=720]+bestaudio/best[height<=720]" |
| 480p | -f "bestvideo[height<=480]+bestaudio/best[height<=480]" |
| 最低 | -f "worstvideo+worstaudio/worst" |
出力テンプレート変数
-o テンプレートで使用する共通変数:
| 変数 | 説明 |
|---|---|
%(title)s | 動画タイトル |
%(ext)s | ファイル拡張子 |
%(id)s | 動画 ID |
%(uploader)s | チャンネル/アップローダー名 |
%(upload_date)s | アップロード日 (YYYYMMDD) |
%(duration)s | 再生時間(秒) |
%(resolution)s | 動画解像度 |
ヒント
.webmや.mkvファイルが生成されるのを避けるため、常に--merge-output-format mp4を使用してください。- メタデータのみのクエリには
--no-downloadと--dump-jsonを併用してください。ファイルはディスクに書き込まれません。 - HTTP エラーでダウンロードが失敗した場合は、最初に yt-dlp を更新してください(
yt-dlp -U)。 - フル解像度が不要な場合は、
-f "bestvideo[height<=720]+bestaudio"を使用して帯域幅を節約できます。 - yt-dlp はレート制限とリトライを自動的に処理します。
--dump-jsonの出力には、title、duration、uploader、view_count、description、formats、subtitlesなどが含まれます。
トラブルシューティング
- 「yt-dlp: command not found」: インストール(
pip install yt-dlp)し、PATH に pip の bin ディレクトリが含まれていることを確認してください。 - 「ffmpeg: command not found」: ffmpeg をインストールしてください。これがないと、動画と音声が別々のストリームになっている場合(YouTube の HD などでよくある)、ダウンロードが失敗します。
- ダウンロードが失敗したりエラーが返される:
yt-dlp -Uを実行して更新してください。サイトは頻繁に変更され、yt-dlp は定期的に修正をリリースしています。