yt-dlp とは
yt-dlp は 1,000 を優に超えるサイトに対応したコマンドラインの音声・動画ダウンローダです。youtube-dl のフォーク（現在は開発の止まった youtube-dlc を経由）として始まり、いまでは両者のうち活発に保守されているほうになりました。はるかに強力なフォーマット選択、SponsorBlock 連携、字幕・チャプター・メタデータの埋め込み対応、そして独自抽出器のためのプラグイン機構を備えています。
⚡ yt-dlp の主な機能
🌐 数千のサイトに対応
動画プラットフォーム、放送局、ポッドキャストのホスト、ニュースサイトを網羅する 1,700 以上の抽出器に加え、誰も抽出器を書いていないページからメディアを見つける汎用抽出器も備えています。
🎚️ フォーマットを細かく指定
-f と -S は解像度・コーデック・ビットレート・コンテナに対する完全な式言語です。既定のものではなく、欲しいストリームをそのまま指定できます。
🎧 音声の抽出
-x --audio-format mp3 で音声トラックを取り出して再エンコード。--embed-thumbnail と --embed-metadata を付ければ、音楽プレーヤーが理解できるタグ付きファイルになります。
💬 字幕とチャプター
利用可能な任意の言語で字幕をダウンロードまたは埋め込み、自動生成字幕も保持できます。チャプターマーカーは出力ファイルに書き込むことも、そこで分割することもできます。
⏭️ SponsorBlock
SponsorBlock のデータベースを使い、ダウンロード時にスポンサー区間やイントロ、自己宣伝に印を付けたり削除したりできます。あとから編集する必要はありません。
🍪 Cookie とセッション
--cookies-from-browser が Firefox や Chromium のログイン済みセッションを直接読むので、非公開・年齢制限・メンバー限定のコンテンツも扱えます。
apt upgrade を実行するだけで、常に最新版を使い続けられます。
📦 deb.griffo.io からインストールする
ステップ 1: リポジトリを追加する
sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | sudo gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | sudo tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
sudo apt updateinstall -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
apt updatesudo apt install extrepo
sudo extrepo enable griffo
sudo apt update🆓 ずっと無料のミラーがあります。 deb-free.griffo.io は、アカウントもサブスクリプションもなしでパッケージをずっと無料で配布しています。上流より最大2か月遅れ、セキュリティ修正は即座に公開されます。現在収録しているのは cliamp、Ghostty、lazydocker、Oh My Posh と Zed です。yt-dlp は含まれていないため、今日入手する方法は上のリポジトリだけですが、ご要望があれば追加できます。
🧩 extrepo オプションについて。 extrepo は外部リポジトリを扱う Debian 標準のツールです。署名済みメタデータと照合して鍵を検証したうえで、sources ファイルの作成と署名鍵のインストールを代わりに行います。このリポジトリは griffo、ずっと無料のミラーは griffo-free という名前で登録されているので、Debian（bookworm、trixie、forky、sid）では上のコマンドだけで設定は完了です。
extrepo が用意するのは sources ファイルと鍵だけなので、サブスクリプションの認証情報は引き続き /etc/apt/auth.conf.d/deb.griffo.io.conf に書きます。extrepo は Debian のスイート向けメタデータしか公開していないため Ubuntu は対象外です。Ubuntu では sudo または root のコマンドを使ってください。
ステップ 2: yt-dlp をインストールする
# 最新の yt-dlp をインストール
sudo apt install yt-dlp
# インストールを確認
yt-dlp --version# 最新の yt-dlp をインストール
apt install yt-dlp
# インストールを確認
yt-dlp --versionステップ 3: ffmpeg を入れる（強く推奨）
# yt-dlp は映像と音声を別々に取得して結合するため ffmpeg が必要です、
# 音声を取り出すときや、字幕・サムネイルを埋め込むときにも使います
sudo apt install ffmpeg
# bash・zsh・fish の補完はパッケージに同梱、# 設定は不要です。新しいシェルを開いて Tab を押してください:
yt-dlp --embed-<Tab>
# man ページも一緒にインストールされます
man yt-dlp# yt-dlp は映像と音声を別々に取得して結合するため ffmpeg が必要です、
# 音声を取り出すときや、字幕・サムネイルを埋め込むときにも使います
apt install ffmpeg
# bash・zsh・fish の補完はパッケージに同梱、# 設定は不要です。新しいシェルを開いて Tab を押してください:
yt-dlp --embed-<Tab>
# man ページも一緒にインストールされます
man yt-dlp🎯 基本的な使い方
日々のダウンロード:
# 利用できる最高画質で動画をダウンロード
yt-dlp 'https://example.com/watch?v=...'
# 1080p までで最良の MP4
yt-dlp -S 'res:1080,ext:mp4' 'URL'
# 音声のみ、タグ付き MP3 で
yt-dlp -x --audio-format mp3 --embed-thumbnail --embed-metadata 'URL'
# 選ぶ前に、提供されている全フォーマットを見る
yt-dlp -F 'URL'字幕、チャプター、スポンサー区間:
# 英語字幕を、自動生成字幕も含めて埋め込む
yt-dlp --embed-subs --sub-langs en --write-auto-subs 'URL'
# チャプターマーカーをファイルに書き込む
yt-dlp --embed-chapters 'URL'
# ダウンロード時にスポンサー区間とイントロを削除
yt-dlp --sponsorblock-remove sponsor,intro 'URL'
# 動画全体ではなく、一区間だけを取得
yt-dlp --download-sections '*00:01:30-00:04:00' 'URL'プレイリスト、アーカイブ、自動化:
# プレイリスト全体を、投稿者ごとのフォルダに整理して
yt-dlp -o '%(uploader)s/%(title)s.%(ext)s' 'PLAYLIST_URL'
# 古い項目を落とし直さずにチャンネルを同期
yt-dlp --download-archive seen.txt 'CHANNEL_URL'
# ログイン済みのブラウザセッションを使って、非公開・年齢制限のコンテンツを
yt-dlp --cookies-from-browser firefox 'URL'
# aria2c を使って高速にダウンロード
yt-dlp --downloader aria2c --downloader-args aria2c:'-x 8 -s 8' 'URL'🔧 ツール連携
yt-dlp は、多くのソフトウェアが前提にしているダウンロードバックエンドです:
- ffmpeg: 結合、リマックス、音声抽出、埋め込みはすべてこれを呼び出します
- mpv: URL をその場で yt-dlp に渡して直接再生します
- aria2: 並列・分割転送のための、任意の外部ダウンローダ
- メディアサーバー: Jellyfin、Kodi、Navidrome のライブラリは yt-dlp の出力テンプレートから作られることがよくあります
- 設定ファイル: いつものフラグを
~/.config/yt-dlp/configに書けば、毎回打ち直さずに済みます
🚀 deb.griffo.io を選ぶ理由
- 公式 Debian: 提供はあるが、リリース時点のバージョンで固定。抽出器の修正が数か月ぶん遅れています
- pip / pipx: 最新ではありますが apt の外であり、PEP 668 のせいで Debian ではシステム全体への
pip installが扱いにくくなっています - deb.griffo.io: 最新版を自動更新でお届け
- ✅ 動く抽出器: 最新リリースであることが、ダウンロードが失敗しない理由です
- ✅ セットアップ不要: pip も virtualenv も、
/usr/local/binに書き込む自己更新もありません - ✅ 自動更新: 上流のリリースから数時間以内にパッケージを更新
- ✅ 全部入り: 上流公式のビルド、
yt-dlp.1man ページ、bash / zsh / fish の補完 - ✅ どのアーキテクチャでも:
Architecture: allで配布しているので、amd64、arm64、armhf、riscv64 などすべてで同じパッケージが入ります - ✅ マルチディストリビューション: Bookworm、Trixie、Forky、Sid で動作
- ✅ 手間のかからない運用: 更新は通常の apt コマンドだけ
📦 パッケージのビルドリポジトリ
Debian パッケージは、この GitHub リポジトリで自動的にビルド・管理されています:
- 📺 yt-dlp-debian - 最新リリースのビルド
🔗 関連パッケージ
deb.griffo.io では、こちらも配布しています:
- termusic - 落としてきたものを聴くためのターミナル音楽プレーヤー
- lowfi - ミニマルな lofi ラジオプレーヤー
- viu - サムネイルや画像をターミナルで表示
- Yazi - ライブラリを見て回るためのターミナルファイルマネージャ