Hướng dẫn cài đặt từng bước cho Windows, macOS và Linux.
yt-dlp là trình tải phương tiện dòng lệnh mạnh mẽ (bản fork được duy trì tích cực của youtube-dl) cho phép bạn tải video và âm thanh từ hàng nghìn trang web. Vì chạy trong terminal nên không có giao diện đồ họa gốc.
Để tải video chất lượng cao (1080p, 4K, v.v.) hoặc trích xuất MP3, bạn phải cài FFmpeg. Ngoài ra, cài runtime JavaScript như Deno rất được khuyến nghị để vượt qua giới hạn tốc độ và chặn bot YouTube. Dưới đây là hướng dẫn đầy đủ để cài các công cụ trên thiết bị.
Không muốn cài phần mềm? Bạn có thể chạy bất kỳ lệnh nào trực tiếp trong bảng điều khiển trực tuyến không cần cấu hình.
Windows 10 (1809+) và Windows 11 có sẵn Windows Package Manager (winget). Quản lý cài đặt, đường dẫn và cập nhật tự động.
winget install yt-dlpDành cho người dùng nâng cao sử dụng trình quản lý gói dòng lệnh trên Windows.
scoop install yt-dlpchoco install yt-dlpTải trực tiếp tệp nhị phân thực thi độc lập.
C:\yt-dlp\, và di chuyển tệp yt-dlp.exe đã tải vào đó.
C:\yt-dlp, sau đó nhấn OK trên tất cả cửa sổ hộp thoại.Homebrew là trình quản lý gói tiêu chuẩn cho macOS. Tự động giải quyết tất cả phụ thuộc, bao gồm Python và FFmpeg.
brew install yt-dlpHoặc bạn có thể cài yt-dlp bằng trình quản lý gói MacPorts.
sudo port install yt-dlpTải tệp nhị phân đã biên dịch trực tiếp vào đường dẫn thực thi cục bộ.
sudo curl -L https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -o /usr/local/bin/yt-dlp && sudo chmod a+rx /usr/local/bin/yt-dlpDùng trình quản lý pip Python đảm bảo bạn nhận được cập nhật mới nhất cho script trích xuất video.
python3 -m pip install -U yt-dlpCài yt-dlp qua trình quản lý gói của phân phối Linux.
sudo apt update && sudo apt install yt-dlpsudo pacman -S yt-dlpsudo dnf install yt-dlpTải tệp nhị phân Linux độc lập trực tiếp vào đường dẫn thực thi cục bộ.
sudo wget https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -O /usr/local/bin/yt-dlp && sudo chmod a+rx /usr/local/bin/yt-dlpFFmpeg là thư viện đa phương tiện mã nguồn mở mà yt-dlp sử dụng bên trong để ghép các track video độ phân giải cao (1080p, 4K) và audio riêng biệt, hoặc trích xuất âm thanh thành MP3. Không có FFmpeg, yt-dlp chỉ tải được stream 720p trở xuống có sẵn âm thanh.
Dùng winget để cài FFmpeg bằng một lệnh:
winget install Gyan.FFmpegHoặc tải xuống các bản dựng từ Gyan.dev, giải nén và thêm thư mục bin vào biến môi trường PATH của bạn.
Nếu dùng Homebrew, sẽ tự động cài. Cài thủ công bằng:
brew install ffmpegCài qua trình quản lý gói hệ thống:
Debian / Ubuntu:sudo apt install ffmpegsudo pacman -S ffmpegDeno là runtime JavaScript hiện đại. yt-dlp sử dụng Deno bên trong để thực thi các thuật toán giải mã chữ ký JavaScript của YouTube. Cài đặt Deno giúp vượt qua giới hạn tốc độ tải và chặn bot "n-challenge" của YouTube.
Dùng winget để cài Deno bằng một lệnh:
winget install DenoLand.DenoHoặc dùng Scoop: scoop install deno
Cài Deno qua Homebrew:
brew install denoCài Deno bằng script shell chính thức:
curl -fsSL https://deno.land/install.sh | shĐảm bảo đã cài unzip và curl trước khi chạy script này.
Sau khi cài, mở terminal (PowerShell, Command Prompt hoặc Terminal.app) và xác minh mọi thứ hoạt động bằng lệnh kiểm tra phiên bản.
Chạy lệnh kiểm tra phiên bản trong terminal:
yt-dlp --versionNếu cài thành công, sẽ hiển thị số phiên bản ngày phát hành như:
2026.06.18Nếu gặp "Command not found", hãy khởi động lại terminal hoặc xác minh thư mục chứa yt-dlp đã được thêm đúng vào biến môi trường PATH hệ thống.
Gặp vấn đề? Đây là cách sửa các lỗi yt-dlp phổ biến nhất trên Windows, macOS và Linux.
yt-dlp không nằm trong PATH hệ thống. Nếu cài qua winget, Homebrew hoặc pip, chỉ cần đóng và mở lại terminal — PATH chỉ cập nhật cho phiên mới.
yt-dlp.exe thủ công, cần thêm thư mục chứa nó vào biến môi trường PATH. Xem các bước thiết lập PATH chi tiết ở trên.
yt-dlp --cookies-from-browser chrome "URL"winget install ffmpegyt-dlp -Uwinget upgrade yt-dlp hoặc brew upgrade yt-dlp).
yt-dlp -U), vì các phương pháp vượt giới hạn tốc độ được cập nhật thường xuyên.
yt-dlp.exe độc lập được xây dựng bằng PyInstaller, đóng gói trình thông dịch Python vào một tệp thực thi. Phần mềm diệt virus thường đánh dấu các gói PyInstaller vì kỹ thuật đóng gói tương tự được sử dụng bởi một số phần mềm độc hại — nhưng bản thân yt-dlp hoàn toàn an toàn.
winget install yt-dlp (gói xác minh Microsoft không bị đánh dấu).
YouTube và các nền tảng video khác cập nhật giao thức streaming thường xuyên, có thể khiến phiên bản yt-dlp cũ ngừng hoạt động. Giữ cài đặt cục bộ luôn mới nhất để tự động khắc phục lỗi trích xuất.
Nếu bạn tải trực tiếp tệp nhị phân hoặc cài qua pip, chạy lệnh cập nhật tích hợp trong terminal:
yt-dlp -UWindows (winget): winget upgrade yt-dlp
macOS (Homebrew): brew upgrade yt-dlp
Python (pip): python3 -m pip install --upgrade yt-dlp
Bắt đầu với các lệnh cơ bản trong terminal:
| Mục tiêu | Lệnh | Hành động |
|---|---|---|
| Tải video (Chất lượng tốt nhất) | yt-dlp "https://www.youtube.com/watch?v=oHg5SJYRHA0" |
|
| Trích xuất âm thanh MP3 | yt-dlp -x --audio-format mp3 "https://www.youtube.com/watch?v=oHg5SJYRHA0" |
|
Có, yt-dlp an toàn. Đây là dự án mã nguồn mở 100% với giấy phép Unlicense, lưu trữ trên GitHub với hơn 100.000 sao và hàng trăm người đóng góp tích cực. Mọi dòng mã đều có thể kiểm tra công khai.
winget để tránh vấn đề này.Nếu bạn không muốn chạy tệp thực thi cục bộ, bảng điều khiển trực tuyến chạy yt-dlp trên máy chủ của chúng tôi — không cần cài gì trên thiết bị.
100K+ ⭐
Mã nguồn mở trên GitHub
Chạy lệnh yt-dlp trực tiếp trên máy chủ. Dùng giao diện web để tải danh sách phát, ghi stream, và trích xuất âm thanh ngay lập tức.