본문으로 건너뛰기
yt-dlp

Windows에 yt-dlp 설치하기

winget, Scoop 또는 직접 내려받기로 Windows에 yt-dlp와 ffmpeg를 설치하고, 그 뒤에 생기는 PATH 오류를 해결합니다.

1. yt-dlp 설치

winget은 Windows 10과 11에 기본으로 들어 있고 PATH까지 처리해 줍니다. 손으로 설치할 때 사람들이 틀리는 부분이 바로 그 대목입니다.

winget install yt-dlp.yt-dlp

이미 Scoop이나 Chocolatey를 쓰고 있다면 어느 쪽이든 똑같이 괜찮습니다:

scoop install yt-dlp
choco install yt-dlp

수동으로 하려면 공식 릴리스 페이지에서 yt-dlp.exe 하나만 받으면 됩니다. PATH에 들어 있는 폴더에 두세요. 바탕화면에 두면 터미널이 마침 그 폴더에 있을 때만 동작하는데, 이것이 "yt-dlp is not recognized"의 흔한 원인입니다.

2. ffmpeg 설치

yt-dlp는 ffmpeg 없이도 내려받지만, 쓸 만한 기능은 전부 그것을 필요로 합니다. 분리된 영상과 소리 병합, MP3 추출, 자막이나 섬네일 삽입, 구간 잘라내기. 첫 번째 알 수 없는 실패를 겪은 뒤가 아니라 지금 설치해 두세요.

winget install Gyan.FFmpeg

3. 제대로 됐는지 확인

터미널을 여세요. 이미 열려 있던 창은 아직 예전 PATH를 갖고 있습니다. 그런 다음 실행하세요:

yt-dlp --version
ffmpeg -version

버전 번호가 두 개 나오면 끝입니다.

Windows에서의 따옴표

PowerShell과 cmd는 bash처럼 따옴표를 다루지 않습니다. Linux 위주 튜토리얼에서 복사한 명령어가 깨지는 이유가 대개 정확히 이것입니다. PowerShell에서는 작은따옴표가 문자 그대로여서 포맷 셀렉터나 출력 템플릿에 가장 안전합니다. cmd에서는 큰따옴표를 쓰세요. .bat 파일에서는 모든 %를 두 번씩 써야 합니다.

yt-dlp -o '%(title)s.%(ext)s' URL     # PowerShell
yt-dlp -o "%(title)s.%(ext)s" URL     # cmd
yt-dlp -o "%%(title)s.%%(ext)s" URL   # inside a .bat file

생성기의 셸 전환은 이 각각에 맞는 올바른 형태를 만들어 주므로, 고쳐 쓸 필요 없이 그대로 복사하면 됩니다.

갱신

독립 실행 yt-dlp.exeyt-dlp -U로 스스로를 갱신합니다. winget, Scoop, Chocolatey로 설치했다면 같은 도구로 갱신하세요. 파일의 주인이 패키지 관리자이므로 자체 갱신은 거부됩니다.

자주 묻는 질문

Windows가 yt-dlp를 인식하지 못한다고 합니다. 왜죠?
실행 파일이 PATH에 없거나, 터미널을 설치 전에 열어 두었기 때문입니다. 먼저 새 터미널을 열어 보세요. 그래도 안 되면 PATH를 알아서 처리해 주는 winget이나 Scoop으로 설치하세요.
Windows에서 yt-dlp가 ffmpeg를 찾지 못합니다.
winget install Gyan.FFmpeg 로 설치하고, 새 터미널을 열어 ffmpeg -version 으로 확인하세요. ffmpeg.exe를 yt-dlp.exe와 같은 폴더에 두는 것도 됩니다.