topic★★★★★난이도
yt-dlp — 미디어 다운로더
유튜브 등 수천 개 사이트에서 영상·오디오·자막을 다운로드하는 강력한 CLI/라이브러리.
#yt-dlp#유튜브#다운로드#오디오추출
왜 배우는가
강의 영상 백업, 오디오 추출(Whisper 연계), 자막 수집 등 미디어 활용의 시작점이다.
yt-dlp는 유튜브를 포함한 수천 개 사이트에서 미디어를 다운로드하는 도구다. 영상, 오디오(MP3), 자막 파일을 선택적으로 받을 수 있다. youtube-dl의 활발히 유지보수되는 포크 버전이다.
| 용도 | 설명 |
|---|---|
| `yt-dlp URL` | 최고 화질 영상 다운로드 (CLI) |
| `-x --audio-format mp3` | 오디오만 MP3로 추출 |
| `--write-sub --sub-lang ko` | 한국어 자막 다운로드 |
| `-f 'best[height<=720]'` | 720p 이하로 포맷 제한 |
| `ydl.download([url])` | Python 코드에서 호출 |
YoutubeDL에 옵션 딕셔너리를 넘기고 download()를 호출한다. postprocessors로 ffmpeg 변환을 자동 적용한다. CLI에서 yt-dlp -x --audio-format mp3 URL로도 동일하게 사용 가능.
Claude Code에서 "이 유튜브 영상에서 오디오만 추출해서 Whisper로 텍스트 변환해줘"라고 하면 yt-dlp + Whisper 파이프라인을 한번에 만들어준다. ffmpeg 설치가 선행 조건이다.