Panduan pengaturan langkah demi langkah untuk Windows, macOS, dan Linux.
yt-dlp adalah pengunduh media baris perintah yang kuat (fork youtube-dl yang aktif dikelola) yang memungkinkan Anda mengunduh video dan audio dari ribuan situs. Karena berjalan di terminal, ia tidak memiliki antarmuka grafis bawaan.
Untuk mengunduh video berkualitas tinggi (1080p, 4K, dll.) atau mengekstrak audio MP3, Anda harus menginstal FFmpeg. Selain itu, menginstal runtime JavaScript seperti Deno sangat direkomendasikan untuk melewati pembatasan kecepatan YouTube dan pemblokiran bot. Di bawah ini panduan lengkap untuk mengatur alat-alat ini.
Tidak ingin menginstal perangkat lunak? Anda dapat menjalankan perintah apa pun langsung di konsol online tanpa konfigurasi apa pun.
Windows 10 (1809+) dan Windows 11 menyertakan Windows Package Manager (winget) secara default. Ia mengelola instalasi, jalur, dan pembaruan secara otomatis.
winget install yt-dlp
Untuk pengguna tingkat lanjut yang menggunakan manajer paket baris perintah di Windows.
scoop install yt-dlp
choco install yt-dlp
Unduh binary eksekusi mandiri secara langsung.
C:\yt-dlp\, dan pindahkan yt-dlp.exe yang diunduh ke dalamnya.
C:\yt-dlp, lalu klik OK di semua jendela dialog.Homebrew adalah manajer paket standar untuk macOS. Ia menyelesaikan semua dependensi, termasuk Python dan FFmpeg, secara otomatis.
brew install yt-dlp
Atau Anda dapat menginstal yt-dlp menggunakan manajer paket MacPorts.
sudo port install yt-dlp
Unduh binary yang dikompilasi langsung ke jalur eksekusi lokal Anda.
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-dlp
Menggunakan manajer pip Python memastikan Anda mendapatkan pembaruan terbaru untuk skrip ekstraksi video secara langsung.
python3 -m pip install -U yt-dlp
Instal yt-dlp melalui manajer paket distribusi Linux Anda.
sudo apt update && sudo apt install yt-dlp
sudo pacman -S yt-dlp
sudo dnf install yt-dlp
Unduh binary Linux mandiri langsung ke jalur binary eksekusi lokal Anda.
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-dlp
FFmpeg adalah perpustakaan media open-source yang digunakan yt-dlp untuk menggabungkan unduhan trek video definisi tinggi (1080p, 4K) dan trek audio terpisah, atau mengekstrak audio sebagai MP3. Tanpa FFmpeg, yt-dlp hanya akan mengunduh streaming 720p atau kualitas lebih rendah dengan audio bawaan.
Instal FFmpeg dengan winget dalam satu perintah:
winget install Gyan.FFmpeg
Atau, unduh build dari Gyan.dev, ekstrak, dan tambahkan direktori bin ke variabel lingkungan PATH Anda.
Jika menggunakan Homebrew, terinstal secara otomatis. Instal manual dengan:
brew install ffmpeg
Instal melalui manajer paket sistem Anda:
Debian / Ubuntu:sudo apt install ffmpeg
sudo pacman -S ffmpeg
Deno adalah runtime JavaScript modern. yt-dlp menggunakan Deno untuk menjalankan algoritma dekripsi tanda tangan berbasis JavaScript YouTube. Menginstal Deno membantu melewati pembatasan kecepatan unduh YouTube dan pemblokiran deteksi bot "n-challenge".
Instal Deno dengan winget dalam satu perintah:
winget install DenoLand.Deno
Atau gunakan Scoop: scoop install deno
Instal Deno via Homebrew:
brew install deno
Instal Deno menggunakan skrip shell resmi:
curl -fsSL https://deno.land/install.sh | sh
Pastikan unzip dan curl terinstal sebelum menjalankan skrip ini.
Setelah terinstal, buka terminal (PowerShell, Command Prompt, atau Terminal.app) dan verifikasi semuanya berfungsi dengan menjalankan perintah cek versi.
Jalankan perintah kueri versi di terminal Anda:
yt-dlp --version
Jika berhasil terinstal, ia akan menampilkan nomor versi tanggal rilis seperti:
2026.06.18
Jika muncul "Command not found", pastikan untuk memulai ulang terminal atau verifikasi bahwa folder yang berisi yt-dlp telah ditambahkan dengan benar ke PATH lingkungan sistem.
Mengalami masalah? Berikut perbaikan untuk error yt-dlp yang paling umum di Windows, macOS, dan Linux.
yt-dlp tidak ada di PATH sistem. Jika menginstal via winget, Homebrew, atau pip, cukup tutup dan buka kembali terminal — PATH diperbarui hanya untuk sesi baru.
yt-dlp.exe secara manual, Anda perlu menambahkan foldernya ke variabel lingkungan PATH. Lihat langkah pengaturan PATH detail di atas.
yt-dlp --cookies-from-browser chrome "URL"
winget install ffmpeg
yt-dlp -U
winget upgrade yt-dlp atau brew upgrade yt-dlp).
yt-dlp -U), karena metode bypass throttle sering diperbarui.
yt-dlp.exe mandiri dibangun menggunakan PyInstaller yang menggabungkan interpreter Python ke dalam satu file eksekusi. Perangkat lunak antivirus sering menandai paket PyInstaller karena teknik pengemasan yang sama digunakan oleh beberapa malware — tetapi yt-dlp sendiri sepenuhnya aman.
winget install yt-dlp (paket terverifikasi Microsoft tidak ditandai).
YouTube dan platform video lainnya sering memperbarui protokol streaming, yang dapat menyebabkan versi lama yt-dlp berhenti bekerja. Jaga instalasi lokal tetap terbaru untuk menyelesaikan error ekstraksi secara otomatis.
Jika Anda mengunduh binary langsung atau menginstal via pip, jalankan perintah pembaruan bawaan di terminal:
yt-dlp -U
Windows (winget): winget upgrade yt-dlp
macOS (Homebrew): brew upgrade yt-dlp
Python (pip): python3 -m pip install --upgrade yt-dlp
Mulai dengan perintah dasar ini di terminal Anda:
| Tujuan | Perintah | Tindakan |
|---|---|---|
| Unduh Video (Kualitas Terbaik) | yt-dlp "https://www.youtube.com/watch?v=oHg5SJYRHA0" |
|
| Ekstrak Audio MP3 | yt-dlp -x --audio-format mp3 "https://www.youtube.com/watch?v=oHg5SJYRHA0" |
|
Ya, yt-dlp aman. Ini adalah proyek open-source 100% berlisensi Unlicense, dihosting di GitHub dengan 100.000+ bintang dan ratusan kontributor aktif. Setiap baris kode dapat diaudit publik.
winget untuk menghindari ini.Jika Anda lebih suka tidak menjalankan file eksekusi secara lokal, konsol online menjalankan yt-dlp di server kami — tidak ada yang diinstal di perangkat Anda.
100K+ ⭐
Open Source di GitHub
Jalankan perintah yt-dlp langsung di server kami. Gunakan UI web kami untuk mengunduh playlist, merekam streaming, dan mengekstrak audio secara instan.