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