video-download
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」: yt-dlp をインストールし(
pip install yt-dlp)、PATH に pip の bin ディレクトリが含まれていることを確認してください。 - 「ffmpeg: command not found」: ffmpeg をインストールしてください。これがないと、動画と音声が別々のストリームになっている場合(YouTube の HD でよくある)にダウンロードが失敗します。
- ダウンロードが失敗したりエラーが返る場合:
yt-dlp -Uを実行して更新してください。サイトは頻繁に変更され、yt-dlp は定期的に修正をリリースしています。