ytdlp.online
Laman Utama Tampermonkey

Cara Memuat Turun & Memasang yt-dlp

Panduan persediaan langkah demi langkah untuk Windows, macOS, dan Linux.

yt-dlp ialah pemuat turun media baris arahan yang berkuasa (fork youtube-dl yang diselenggara secara aktif) yang membolehkan anda memuat turun video dan audio daripada ribuan laman web. Oleh kerana ia berjalan dalam terminal, ia tiada antara muka grafik asli.

Untuk memuat turun video berkualiti tinggi (1080p, 4K, dll.) atau mengekstrak audio MP3, anda mesti memasang FFmpeg. Selain itu, memasang runtime JavaScript seperti Deno amat disyorkan untuk memintas pendikitan kelajuan dan sekatan bot YouTube. Di bawah ialah panduan lengkap untuk menyediakan alat-alat ini pada peranti anda.

Tidak mahu memasang perisian? Anda boleh menjalankan sebarang arahan terus dalam konsol online tanpa konfigurasi apa pun.

Kaedah 1: WinGet (Disyorkan & Paling Mudah)

Windows 10 (1809+) dan Windows 11 menyertakan Windows Package Manager (winget) secara lalai. Ia menguruskan pemasangan, laluan, dan kemas kini secara automatik.

  1. Buka PowerShell atau Command Prompt (CMD).
  2. Jalankan arahan berikut: 
    winget install yt-dlp
  3. Mulai ulang jendela terminal untuk menerapkan perubahan lingkungan.

Kaedah 2: Scoop / Chocolatey

Untuk pengguna mahir yang menggunakan pengurus pakej baris arahan di Windows.

Scoop: 
scoop install yt-dlp
Chocolatey: 
choco install yt-dlp

Kaedah 3: Muat Turun Terus (.exe)

Muat turun binari boleh laku kendiri secara terus.

  1. Muat Turun binary terbaru:
    Muat Turun yt-dlp.exe
  2. Buat folder untuk yt-dlp, contohnya: C:\yt-dlp\, dan pindahkan yt-dlp.exe yang dimuat turun ke dalamnya.
  3. Tambahkan folder ke variabel lingkungan PATH sistem Anda:
    1. Tekan Win + S dan cari "Environment Variables", kemudian klik "Edit the system environment variables".
    2. Di jendela System Properties, klik tombol "Environment Variables...".
    3. Di bawah "System variables" (atau "User variables"), cari dan pilih pemboleh ubah bernama Path, kemudian klik "Edit...".
    4. Klik "New" dan taip laluan folder: C:\yt-dlp, kemudian klik OK pada semua tetingkap dialog.
  4. Tutup dan buka kembali terminal (PowerShell atau CMD) agar perubahan PATH berlaku.

Kaedah 1: Homebrew (Disyorkan)

Homebrew ialah pengurus pakej standard untuk macOS. Ia menyelesaikan semua kebergantungan, termasuk Python dan FFmpeg, secara automatik.

  1. Buka aplikasi Terminal.
  2. Pasang yt-dlp dengan menjalankan: 
    brew install yt-dlp

Kaedah 2: MacPorts

Sebagai alternatif, anda boleh memasang yt-dlp menggunakan pengurus pakej MacPorts.

sudo port install yt-dlp

Kaedah 3: Pemasangan Terus melalui Curl

Muat turun binari terkompil terus ke laluan pelaksanaan tempatan 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

Kaedah 1: pip (Disyorkan untuk Versi Terkini)

Menggunakan pengurus pip Python memastikan anda mendapat kemas kini paling terkini untuk skrip pengekstrak video secara terus.

  1. Pasang atau perbarui yt-dlp menggunakan Python 3 pip: 
    python3 -m pip install -U yt-dlp

Kaedah 2: Pengurus Pakej Distribusi

Pasang yt-dlp melalui pengurus pakej distribusi Linux anda.

Debian / Ubuntu: 
sudo apt update && sudo apt install yt-dlp
Arch Linux: 
sudo pacman -S yt-dlp
Fedora: 
sudo dnf install yt-dlp

Kaedah 3: Muat Turun Terus

Muat turun binari Linux kendiri terus ke laluan binari boleh laku tempatan anda.

  1. Muat turun dan tetapkan kebenaran menggunakan wget/curl: 
    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

Cara Memasang FFmpeg (Diperlukan untuk HD & MP3)

FFmpeg ialah pustaka media sumber terbuka yang digunakan yt-dlp di sebalik tabir untuk menggabungkan muat turun trek video definisi tinggi (1080p, 4K) dan trek audio yang berasingan, atau untuk mengekstrak audio sebagai MP3. Tanpa FFmpeg, yt-dlp hanya akan memuat turun strim 720p atau kualiti lebih rendah dengan audio terbina dalam.

Windows

Pasang FFmpeg dengan winget dalam satu arahan:

winget install Gyan.FFmpeg

Sebagai alternatif, muat turun binaan dari Gyan.dev, nyahzip, dan tambah direktori bin ke pemboleh ubah persekitaran PATH anda.

macOS

Jika anda menggunakan Homebrew, ia dipasang secara automatik. Pasang secara manual dengan:

brew install ffmpeg
Linux

Pasang melalui pengurus pakej sistem anda:

Debian / Ubuntu: 
sudo apt install ffmpeg
Arch Linux: 
sudo pacman -S ffmpeg

Cara Memasang Deno (Disyorkan untuk YouTube)

Deno ialah runtime JavaScript moden. yt-dlp menggunakan Deno di sebalik tabir untuk melaksanakan algoritma penyahsulitan tandatangan berasaskan JavaScript YouTube. Memasang Deno membantu memintas pendikitan kelajuan muat turun YouTube dan sekatan pengesanan bot "n-challenge".

Windows

Pasang Deno dengan winget dalam satu arahan:

winget install DenoLand.Deno

Atau gunakan Scoop: scoop install deno

macOS

Pasang Deno via Homebrew:

brew install deno
Linux

Pasang Deno menggunakan skrip shell resmi:

curl -fsSL https://deno.land/install.sh | sh

Pastikan unzip dan curl telah dipasang sebelum menjalankan skrip ini.

Sahkan Pemasangan

Setelah dipasang, buka terminal anda (PowerShell, Command Prompt, atau Terminal.app) dan sahkan semuanya berfungsi dengan menjalankan arahan semakan versi.

1. Jalankan Arahan Versi

Jalankan arahan pertanyaan versi dalam terminal anda:

yt-dlp --version
2. Output yang Diharapkan

Jika berjaya dipasang, ia akan memaparkan nombor versi tarikh keluaran seperti:

2026.06.18

Jika muncul "Command not found", pastikan anda memulakan semula terminal atau sahkan bahawa folder yang mengandungi yt-dlp telah ditambah dengan betul ke PATH persekitaran sistem.

Pemecahan Masalah Error Umum

Mengalami masalah? Berikut perbaikan untuk error yt-dlp yang paling umum di Windows, macOS, dan Linux.

Ini bermakna yt-dlp tiada dalam PATH sistem anda. Jika anda memasang melalui winget, Homebrew, atau pip, cukup tutup dan buka semula terminal anda — PATH hanya dikemas kini untuk sesi baharu.

Jika anda memuat turun yt-dlp.exe secara manual, anda perlu menambahkan foldernya ke pembolehubah persekitaran PATH anda. Lihat langkah persediaan PATH yang terperinci di atas.

Atau langkau terus persediaan tempatan dan jalankan yt-dlp dalam konsol dalam talian kami — tidak perlu konfigurasi.

YouTube menyekat muat turun daripada alamat IP yang ditandakan atau pusat data. Untuk membetulkannya secara tempatan, hantar cookie penyemak imbas anda kepada yt-dlp: 
yt-dlp --cookies-from-browser chrome "URL"
Ini membolehkan yt-dlp menggunakan sesi YouTube anda yang telah disahkan untuk memintas sekatan itu.

Di ytdlp.online, pelayan backend kami menukar IP proksi kediaman secara automatik untuk ahli premium bagi memintas sekatan ini.

yt-dlp memerlukan FFmpeg untuk menggabungkan strim video dan audio berasingan (diperlukan untuk muat turun 1080p+) atau untuk mengekstrak audio MP3. Lihat bahagian pemasangan FFmpeg di atas untuk arahan persediaan terperinci pada semua platform.

Perbaikan cepat: 
winget install ffmpeg
Di ytdlp.online, FFmpeg telah sedia terpasang — semua penggabungan dan pengekstrakan audio berlaku secara automatik di pelayan kami.

Ini biasanya berlaku apabila YouTube mengemas kini algoritma penstrimannya, menyebabkan versi lama yt-dlp gagal berfungsi. Betulkan dengan mengemas kini ke versi terkini: 
yt-dlp -U
Jika anda memasang melalui pengurus pakej, gunakan arahan kemas kininya (cth. winget upgrade yt-dlp atau brew upgrade yt-dlp).

Di ytdlp.online, kami mengimbas kemas kini upstream setiap jam dan memastikan teras sistem sentiasa dikemas kini secara automatik.

YouTube sengaja mendikit kelajuan muat turun untuk yt-dlp. Memasang Deno (runtime JavaScript) membolehkan yt-dlp memintas pendikitan secara automatik. Lihat bahagian pemasangan Deno di atas.

Selain itu, pastikan anda menggunakan versi terkini yt-dlp (yt-dlp -U), kerana kaedah pintasan pendikitan kerap dikemas kini.

Di ytdlp.online, Deno telah sedia dikonfigurasi dan muat turun berjalan di pelayan lebar jalur tinggi untuk kelajuan maksimum.

Ini ialah positif palsu. yt-dlp.exe kendiri dibina menggunakan PyInstaller, yang membungkus penterjemah Python ke dalam satu fail boleh laku. Perisian antivirus sering menandakan bundel PyInstaller kerana teknik pembungkusan yang sama digunakan oleh sesetengah perisian hasad — tetapi yt-dlp sendiri selamat sepenuhnya.

yt-dlp adalah proyek open-source 100% yang dihosting di GitHub dengan 100.000+ bintang dan ratusan kontributor. Kode sumber dapat diaudit publik.

Untuk membetulkannya: tambahkan pengecualian dalam Windows Security untuk folder yt-dlp, atau pasang melalui winget install yt-dlp (pakej yang disahkan Microsoft tidak ditandakan).

Tidak mahu menjalankan binari tempatan? Gunakan konsol dalam talian berasaskan awan sebagai ganti — tiada apa-apa dipasang pada peranti anda.

Cara Mengemas Kini yt-dlp

YouTube dan platform video lain kerap mengemas kini protokol penstriman mereka, yang boleh menyebabkan versi lama yt-dlp berhenti berfungsi. Pastikan pemasangan tempatan anda sentiasa terkini untuk menyelesaikan ralat pengekstrakan secara automatik.

Kaedah A: Kemas Kini Binari Kendiri

Jika anda memuat turun binari secara terus atau memasang melalui pip, jalankan arahan kemas kini terbina dalam pada terminal anda:

yt-dlp -U
Kaedah B: Kemas Kini melalui Pengurus Pakej

Windows (winget): winget upgrade yt-dlp

macOS (Homebrew): brew upgrade yt-dlp

Python (pip): python3 -m pip install --upgrade yt-dlp

Arahan Mulai Cepat

Mulai dengan arahan dasar ini di terminal Anda:

Tujuan Arahan Tindakan
Muat Turun 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"
Tips Pro: Perlukan arahan lebih lanjut untuk pengekstrakan sari kata, penapisan format, muat turun pukal, atau memintas sekatan bot? Lihat Helaian Rujukan yt-dlp lengkap kami →
💖 Suka panduan pemasangan ini? Kongsikan dengan rakan anda! 💖

Apakah yt-dlp Aman Digunakan di 2026?

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.

  • Tanpa telemetri, tanpa iklan, tanpa perisian tambahan. yt-dlp adalah alat CLI bersih dengan satu tujuan.
  • Positif palsu Windows Defender disebabkan oleh pembungkusan PyInstaller, bukan kod berniat jahat. Pasang melalui winget untuk mengelakkannya.
  • Penggunaan sah: yt-dlp ialah pemuat turun media serba guna. Muat turun hanya kandungan yang anda berhak muat turun — muat naik anda sendiri, bahan Creative Commons, atau kandungan dengan kebenaran yang jelas.

Jika anda tidak mahu menjalankan fail boleh laku secara tempatan, konsol online menjalankan yt-dlp di pelayan kami — tiada apa-apa dipasang pada peranti anda.

100K+ ⭐
Open Source di GitHub

Tidak mahu memasang perisian pada peranti anda?

Jalankan arahan yt-dlp anda terus di pelayan kami. Gunakan UI web kami untuk memuat turun senarai main, merakam strim, dan mengekstrak audio serta-merta.

Cuba Pemuat Turun Playlist Cuba Pemuat Turun Saluran Cuba Perakam Strim Langsung Cuba Pemuat Turun Twitch Cuba Pemuat Turun Video Reddit Cuba Pemuat Turun Sari Kata
Alat yt-dlp
Pemuat Turun Senarai Main Simpan keseluruhan senarai main YouTube sekali gus Pemuat Turun Saluran YouTube Muat turun pukal semua video daripada saluran Perakam Siaran Langsung Rakam aliran langsung semasa disiarkan Pemuat Turun Twitch Simpan VOD, klip dan aliran Twitch Pemuat Turun Video Reddit Muat turun video Reddit dengan bunyi Pemuat Turun Sari Kata Ekstrak sarikata sebagai SRT, VTT atau TXT
Lihat semua alat yt-dlp
Bantuan & Dokumen yt-dlp
Muat Turun & Pasang
Pasang binari & kebergantungan yt-dlp
Helaian Rujukan yt-dlp
Rujukan pantas untuk arahan
Penjana Arahan
Pembina arahan interaktif
Referensi Bantuan Lengkap
Senarai pilihan lengkap
Dokumentasi API
Dokumentasi REST API