Question 1

CLI에서는 정상적으로 작동하는데 왜 yt-dlp Python API의 SponsorBlock postprocessor에서는 'No matching segments were found'가 보고되는가?

Accepted Answer

버그는 `'categories': 'ModifyChapters'` 부분입니다. `categories`는 SponsorBlock 카테고리 이름들의 집합이어야 하며, `ModifyChapters`는 챕터를 파일에 기록하기 위해 별도로 추가해야 하는 postprocessor입니다. 단일 문자열을 전달했기 때문에 일치하는 카테고리가 하나도 없었고, 따라서 아무것도 찾지 못한 것입니다.

CLI 플래그 `--sponsorblock-mark all`은 실제로 두 개의 postprocessor를 설정합니다. 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에서 스토리보드(sb0/sb1) 포맷만 표시하고 'challenge solving failed: Some formats may be missing' 오류로 실패하나요?

Accepted Answer

YouTube는 실제 동영상 포맷을 잠금 해제하기 위해 JavaScript 챌린지를 해결해야 하지만, JS 런타임이 감지되지 않았습니다(verbose 로그에 `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 브랜치처럼 해당 수정을 사용할 수 없는 배포판에서는 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를 최신 nightly 버전으로 업데이트하세요: `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 이슈를 따라 업데이트를 확인하세요.

yt-dlp

주요 기능

할 수 없는 것

사용 사례

태그

시작하기

유사한 프로젝트