yt-dlp

インストール

youtube-dl が動作しなくなったようなので，その代替として yt-dlp を入れてみる。yt-dlpのインストール方法は幾つかある。

wgetによる場合

$ sudo wget https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -O /usr/local/bin/yt-dlp
$ sudo chmod a+rx /usr/local/bin/yt-dlp
$ yt-dlp --version
$ yt-dlp --format best [download_url]

$ pip install -U --pre yt-dlp

Defaulting to user installation because normal site-packages is not writeable
Collecting yt-dlp
  Downloading yt_dlp-2025.10.1.232815.dev0-py3-none-any.whl (3.2 MB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 3.2/3.2 MB 5.2 MB/s eta 0:00:00
Installing collected packages: yt-dlp
Successfully installed yt-dlp-2025.10.1.232815.dev0

$ pip install pycryptodomex

Defaulting to user installation because normal site-packages is not writeable
Collecting pycryptodomex
  Downloading pycryptodomex-3.23.0-cp37-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (2.3 MB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 2.3/2.3 MB 17.0 MB/s eta 0:00:00
Installing collected packages: pycryptodomex
Successfully installed pycryptodomex-3.23.0

各種オプション

mp4で取得する場合

$ yt-dlp -f "bv*[ext=mp4]+ba[ext=m4a]/b[ext=mp4]" [URL]

–idを付ける際，mp4で出力したい場合。

$ yt-dlp --id -f mp4 [URL]

ファイル名を全角50文字で切り詰める

$ yt-dlp -o "%(title).50s.%(ext)s" [URL]

1080pでダウンロードする

$ yt-dlp -f "bestvideo[height=1080]+bestaudio/best[height<=1080]" [URL]

設定ファイルへの記載

$ mkdir -p ~/.config/yt-dlp
$ cd ~/.config/yt-dlp
$ touch config
---------------------------------------------------
コード スニペット
# 最大解像度を1080pに制限する
-f "bestvideo[height=1080]+bestaudio/best[height<=1080]"

# ファイル名を50文字で切り詰める
-o "%(title).50s.%(ext)s"

# (推奨) 映像と音声の結合にffmpegを使用
--downloader ffmpeg

トラブルシュート

なんらかのCookie制限が出る場合。

$ yt-dlp --cookies-from-browser [ブラウザの名前] [URL] （ -u [ユーザー名] -p [パスワード]）

shortsの取得ができなくなった場合

ここを参照のこと。

$ sudo yt-dlp --update-to nightly

HTTP Error 403: Forbidden

突然，このエラーが出て失敗することがある。

単純にキャッシュの不整合であるならば，次を実行

$ yt-dlp --rm-cache-dir