Chuyển tới nội dung
yt-dlp

Cài yt-dlp trên Windows

Cài yt-dlp và ffmpeg trên Windows bằng winget, Scoop hoặc tải trực tiếp, và sửa các lỗi PATH thường gặp sau đó.

Bài viết này chưa được dịch nên đang hiển thị bằng tiếng Anh. Phần giao diện vẫn theo ngôn ngữ của bạn.

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.

Câu hỏi thường gặp

Windows báo yt-dlp is not recognized. Vì sao?
File thực thi không nằm trong PATH, hoặc terminal đã mở từ trước khi cài. Hãy mở một terminal mới; nếu vẫn không được, hãy cài qua winget hoặc Scoop vì chúng tự xử lý PATH cho bạn.
yt-dlp không tìm thấy ffmpeg trên Windows.
Hãy cài bằng winget install Gyan.FFmpeg, mở terminal mới rồi kiểm tra bằng ffmpeg -version. Đặt ffmpeg.exe cùng thư mục với yt-dlp.exe cũng được.
Cập nhật yt-dlp thế nào?
Bản binary độc lập tự cập nhật bằng yt-dlp -U. Nếu cài qua trình quản lý gói thì hãy cập nhật bằng chính trình đó; lệnh tự cập nhật sẽ từ chối sửa một file mà nó không sở hữu. Cập nhật sửa được nhiều lỗi hơn bất kỳ flag nào.