Question 1

なぜ yt-dlp の Python API では SponsorBlock ポストプロセッサが 'No matching segments were found' と報告するのに、CLI では正常に動作するのですか？

Accepted Answer

バグは `'categories': 'ModifyChapters'` です — `categories` は SponsorBlock のカテゴリ名のセットでなければならず、`ModifyChapters` はチャプターをファイルに書き込むために追加する必要がある別のポストプロセッサです。単一の文字列を渡したため、一致するカテゴリが 0 件となり、何も見つかりませんでした。

CLI フラグ `--sponsorblock-mark all` は、実際には 2 つのポストプロセッサを設定します。任意の CLI コマンドを API オプションに変換するには、[devscripts/cli_to_api.py](https://github.com/yt-dlp/yt-dlp/blob/master/devscripts/cli_to_api.py) を使用してください。正しい設定は次のとおりです:

```python
ydl_opts = {
    'format': 'worstvideo+worstaudio',
    'outtmpl': '%(title)s.%(ext)s',
    'merge_output_format': 'mkv',
    'postprocessors': [{
        'key': 'SponsorBlock',
        'api': 'https://sponsor.ajay.app',
        'categories': {'sponsor', 'selfpromo', 'interaction', 'intro',
                       'outro', 'preview', 'music_offtopic', 'filler',
                       'poi_highlight', 'chapter'},
        'when': 'after_filter',
    }, {
        'key': 'ModifyChapters',
        'force_keyframes': False,
        'remove_chapters_patterns': [],
        'remove_ranges': [],
        'remove_sponsor_segments': set(),
        'sponsorblock_chapter_title': '[SponsorBlock]: %(category_names)l',
    }]
}
```

API オプションは `yt_dlp/YoutubeDL.py` 内の `YoutubeDL` の docstring に記載されています。記載されていないものについては、動作する CLI コマンドを `cli_to_api.py` に通せば、正確な Python 相当を取得できます。

Question 2

なぜyt-dlpはYouTubeでstoryboard (sb0/sb1) フォーマットしか表示せず、「challenge solving failed: Some formats may be missing」というエラーで失敗するのですか？

Accepted Answer

YouTubeでは実際の動画フォーマットを取得するためにJavaScriptチャレンジを解く必要がありますが、JSランタイムが検出されませんでした（詳細ログには `JS runtimes: none` と表示され、すべてのJS Challenge Providersが 'unavailable' となっています）。そのため、yt-dlpはストーリーボードフォーマットのみをリストし、その後 'Requested format is not available' で失敗します。解決策: EJSチャレンジソルバー（yt_dlp_ejs）が動作できるよう、サポートされているJavaScriptランタイムをインストールしてください。たとえば、Node.js（LTS）、Deno、またはBunをインストールし、それがPATHに含まれていることを確認してから、yt-dlpを再実行してください。これは特に `--cookies` を使用する場合に必要です。公式ガイドを参照してください: https://github.com/yt-dlp/yt-dlp/wiki/EJS#step-1-install-a-supported-javascript-runtime

Question 3

yt-dlpとFFmpeg 8.0でYouTubeの音声を抽出する際に発生する「Error parsing Opus packet header」エラーの修正方法

Accepted Answer

これは yt-dlp のダウンロード破損ではなく、Google が配信する WebM/Opus ファイルに関する FFmpeg のパース処理の問題です。これは FFmpeg の上流で修正されました（issue #20954）。FFmpeg を修正済みの 8.x 以降のビルド、または修正を含むディストリビューションパッケージにアップグレードしてください。`ffmpeg -version` で確認できます。Nixpkgs の stable ブランチのように修正が利用できないディストリビューションでは、Nixpkgs unstable または公式の静的 FFmpeg ビルドを使用してください。回避策として、yt-dlp の `--extract-audio` で生成された `.opus` ファイルを使用してください。リマックスされた Opus ファイルは、元の `.webm` が警告を発生させる場合でも、通常は検証に合格します。FFmpeg が正常に完了し、出力された音声が正しく再生される場合は、警告を無視することもできます。

Question 4

yt-dlpでYouTube動画をダウンロードした後、mpvで再生すると音声のピッチが低くなるのはなぜですか？

Accepted Answer

これは yt-dlp のダウンロードが破損しているのではなく、mpv の再生/設定に関する問題です。VLC でファイルを再生するか、`mpv --no-config video.mkv` を実行して確認してください。そちらでピッチが正常であれば、mpv の設定ファイル（Linux/macOS では `~/.config/mpv/mpv.conf`、Windows では `%APPDATA%\mpv\mpv.conf`）にあるカスタムの `video-sync-max-video-change` の行を削除するかコメントアウトしてから、mpv を再起動してください。この設定は、タイミングが通常と異なる動画に対してオーディオのリサンプリングや速度調整を引き起こすことがあり、その結果ピッチが低く聞こえる場合があります。

Question 5

yt-dlpで'nsig extraction failed'と'Sign in to confirm you’re not a bot'エラーを修正する方法は？

Accepted Answer

1. yt-dlpを最新のナイトリーバージョンにアップデート: `yt-dlp -U` または `pip install -U yt-dlp`。
2. それでも「Sign in to confirm you’re not a bot」エラーが表示される場合は、ブラウザのクッキーを渡してYouTubeのボット対策を回避します。`--cookies-from-browser BROWSER`（例: `--cookies-from-browser chrome`）を使用するか、`--cookies COOKIES_FILE`でクッキーファイルをエクスポートします。詳細な手順はこちら: https://github.com/yt-dlp/yt-dlp/wiki/Extractors#exporting-youtube-cookies
3. 「nsig extraction failed」警告はアップデート後に消えることが多いです。消えない場合は既知の一時的な問題です。リンク先のGitHub issuesをフォローして更新を確認してください。

yt-dlp

主な機能

できないこと

使用例

タグ

はじめ方

類似プロジェクト