본문으로 건너뛰기
yt-dlp

Windows에 yt-dlp 설치하기

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

이 글은 아직 번역되지 않아 영어로 표시됩니다. 화면 인터페이스는 여러분의 언어로 되어 있습니다.

1. Install yt-dlp

winget ships with Windows 10 and 11 and handles the PATH for you, which is the part people get wrong when installing by hand.

winget install yt-dlp.yt-dlp

If you already use Scoop or Chocolatey, either is equally fine:

scoop install yt-dlp
choco install yt-dlp

The manual route is a single yt-dlp.exe from the official releases page. Put it in a folder that is on your PATH — dropping it on the Desktop works only while your terminal happens to be in that folder, which is the usual cause of "yt-dlp is not recognized".

2. Install ffmpeg

yt-dlp downloads without ffmpeg, but everything interesting needs it: merging separate video and audio, MP3 extraction, embedding subtitles or thumbnails, cutting sections. Install it now rather than after the first confusing failure.

winget install Gyan.FFmpeg

3. Check it worked

Open a new terminal — an existing one still has the old PATH — and run:

yt-dlp --version
ffmpeg -version

Two version numbers means you are done.

Quoting on Windows

PowerShell and cmd do not quote the way bash does, and a command copied from a Linux-oriented tutorial often breaks for exactly this reason. In PowerShell, single quotes are literal — the safest choice for a format selector or an output template. In cmd, use double quotes. In a .bat file, every % must be doubled.

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

The generator's shell switch produces the right form for each of these, so you can copy without translating.

Updating

A standalone yt-dlp.exe updates itself with yt-dlp -U. Installed via winget, Scoop or Chocolatey, update it through the same tool — self-update will refuse, because the package manager owns the file.

자주 묻는 질문

Windows가 yt-dlp를 인식하지 못한다고 합니다. 왜죠?
실행 파일이 PATH에 없거나, 터미널을 설치 전에 열어 두었기 때문입니다. 먼저 새 터미널을 열어 보세요. 그래도 안 되면 PATH를 알아서 처리해 주는 winget이나 Scoop으로 설치하세요.
Windows에서 yt-dlp가 ffmpeg를 찾지 못합니다.
winget install Gyan.FFmpeg 로 설치하고, 새 터미널을 열어 ffmpeg -version 으로 확인하세요. ffmpeg.exe를 yt-dlp.exe와 같은 폴더에 두는 것도 됩니다.
yt-dlp는 어떻게 갱신하나요?
단독 바이너리는 yt-dlp -U 로 스스로 갱신합니다. 패키지 관리자로 설치했다면 그쪽으로 갱신하세요. 자체 갱신은 자기 소유가 아닌 파일을 건드리지 않습니다. 어떤 flag보다도 갱신이 더 많은 문제를 해결합니다.