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 đó.

1. Cài yt-dlp

winget có sẵn trong Windows 10 và 11, và nó lo phần PATH giúp bạn — đúng cái phần mà người ta hay làm sai khi cài bằng tay.

winget install yt-dlp.yt-dlp

Nếu bạn đã dùng Scoop hoặc Chocolatey rồi thì cái nào cũng tốt như nhau:

scoop install yt-dlp
choco install yt-dlp

Cách thủ công là lấy một tệp yt-dlp.exe duy nhất từ trang phát hành chính thức. Đặt nó vào một thư mục nằm trong PATH — để trên Desktop thì chỉ chạy được khi terminal tình cờ đang ở đúng thư mục đó, và đây là nguyên nhân thường gặp của "yt-dlp is not recognized".

2. Cài ffmpeg

yt-dlp vẫn tải được khi không có ffmpeg, nhưng mọi thứ thú vị đều cần nó: ghép video và âm thanh rời, tách MP3, nhúng phụ đề hay ảnh thu nhỏ, cắt đoạn. Hãy cài ngay bây giờ thay vì đợi tới lần thất bại khó hiểu đầu tiên.

winget install Gyan.FFmpeg

3. Kiểm tra xem đã được chưa

Mở một cửa sổ terminal mới — cửa sổ đang mở vẫn giữ PATH cũ — rồi chạy:

yt-dlp --version
ffmpeg -version

Hiện ra hai số phiên bản nghĩa là xong.

Dấu nháy trên Windows

PowerShell và cmd không đặt dấu nháy giống bash, và một lệnh chép từ hướng dẫn viết cho Linux thường hỏng đúng vì lý do này. Trong PowerShell, dấu nháy đơn là nguyên văn — lựa chọn an toàn nhất cho bộ chọn định dạng hay mẫu đầu ra. Trong cmd, dùng dấu nháy kép. Trong tệp .bat, mọi dấu % phải được nhân đôi.

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

Nút chuyển shell của bộ sinh lệnh tạo ra đúng dạng cho từng trường hợp trên, nên bạn cứ chép nguyên mà không phải sửa gì.

Cập nhật

Một tệp yt-dlp.exe độc lập tự cập nhật bằng yt-dlp -U. Nếu cài qua winget, Scoop hay Chocolatey thì cập nhật bằng chính công cụ đó — tự cập nhật sẽ từ chối, vì tệp thuộc quyền của trình quản lý gói.

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.