yt-dlp: Versi Modern dari youtube-dl untuk Mengunduh Video

yt-dlp: Versi Modern dari youtube-dl untuk Mengunduh Video

Pada 23 Oktober 2020, Recording Industry Association of America mengajukan permintaan penghapusan DMCA terhadap youtube-dl di GitHub. Tiga hari kemudian, pada 26 Oktober, sebuah repositori baru muncul secara diam-diam di github.com/yt-dlp/yt-dlp. Pada saat GitHub mengembalikan proyek asli pada 16 November — bersama dengan dana bantuan pengembang sebesar $1 juta — proyek baru tersebut sudah mulai menyerap kontributor youtube-dl.

Fork tersebut kini menjadi yang utama. Hingga Mei 2026, yt-dlp mencatat lebih dari 12 juta unduhan di PyPI setiap bulan. Repositori GitHub-nya memiliki 160.766 bintang. Proyek ini merilis versi baru kira-kira setiap dua minggu. Tag terbaru, pada saat penulisan, adalah `2026.03.17`. Proyek ini mendukung lebih dari 1.800 situs video dan audio melalui sistem plugin ekstraktornya. Berikut ini adalah penjelasan jujur tentang apa itu yt-dlp dan cara menggunakannya. Ditambah lagi, bagaimana status hukumnya pada tahun 2026. Dan mengapa instalasi yang berfungsi sempurna tiba-tiba dapat berhenti berfungsi pada pertengahan tahun 2025.

Asal muasal yt-dlp: rantai cabang dari youtube-dl

Silsilah proyek ini penting karena menjelaskan kesenjangan perilaku. yt-dlp mengirimkan perbaikan dalam hitungan jam setelah terjadi kerusakan di YouTube; youtube-dl bisa memakan waktu berminggu-minggu. Tiga proyek berada di pohon keluarga ini, dan setiap langkah didorong oleh rasa frustrasi terhadap langkah sebelumnya.

youtube-dl adalah yang pertama. Ricardo García menulisnya pada Agustus 2006, dan Philipp Hagemeister kemudian memimpinnya dengan kelompok kecil di bawah `ytdl-org/youtube-dl`. Pada tahun 2020, alat ini menjadi alat pengarsipan de facto, tetapi permintaan pull request terus menumpuk dan perbaikan dari YouTube terlambat diterima.

Kesenjangan itulah yang menghasilkan youtube-dlc, di mana "c" adalah singkatan dari "community" (komunitas). `blackjack4494` melakukan fork repositori pada tahun 2020 dan antrian penggabungan (merge queue) selesai dalam beberapa hari. Fork itu sendiri menjadi semi-tidak aktif di akhir tahun yang sama — satu pengelola memang rentan.

yt-dlp adalah hasil fork ulang dari youtube-dlc. Repositori ini dibuat pada 26 Oktober 2020, tiga hari setelah RIAA melakukan penghapusan terhadap youtube-dl versi upstream. yt-dlp adalah alat baris perintah yang memungkinkan Anda mengunduh video dan audio dari situs web yang didukung. Huruf "p" mencerminkan pengelola utama awal (`pukkandan`). Proyek ini sekarang dikelola oleh organisasi multi-pengelola yang mencakup `coletdjnz`, `dirkf`, `Grub4K`, `bashonly`, dan `seproDev`. Pada Januari 2021, yt-dlp telah menyerap basis kontributor youtube-dlc. Ia telah menjadi fork dominan dari youtube-dl. Fokusnya adalah pada fitur dan peningkatan yang belum digabungkan oleh upstream.

Beberapa fakta tingkat proyek perlu disorot. yt-dlp menggunakan penomoran versi kalender, jadi tag seperti `2026.03.17` secara harfiah adalah tanggal rilis. Lisensinya adalah The Unlicense, dedikasi domain publik eksplisit yang bahkan sebagian besar proyek FOSS tidak menggunakannya. Repositori ini memiliki 13.348 fork dan 2.507 masalah terbuka. Ubuntu 22.04 mengganti youtube-dl dengan yt-dlp sebagai pengunduh video default-nya, dan Debian mengikutinya dengan bookworm. Daftar situs yang didukung di `supportedsites.md` saat ini mencantumkan lebih dari 1.500 entri bernama; kode sumbernya sendiri mengirimkan hampir 1.800 modul ekstraktor dengan lazy loading. Arch, Fedora, NixOS, Homebrew, Chocolatey, Scoop, dan Winget semuanya mengemasnya. Dua puluh hingga tiga puluh rilis per tahun adalah yang mencegah distribusi kembali ke upstream yang lebih lambat.

yt-dlp

Bagaimana tindakan RIAA pada tahun 2020 membuat yt-dlp tak terhindarkan

Pemberitahuan DMCA RIAA tanggal 23 Oktober 2020 diajukan berdasarkan 17 USC § 1201, klausul anti-penghindaran. Teorinya adalah bahwa youtube-dl melewati mekanisme tanda tangan "rolling cipher" YouTube, yang oleh RIAA digambarkan sebagai langkah teknologi untuk melindungi akses ke karya berhak cipta. GitHub awalnya mematuhi dan menghapus repositori tersebut beserta tujuh belas fork-nya.

Yang terjadi selanjutnya adalah efek Streisand yang sesuai dengan buku teks. Para pengembang memposting ulang kode sumber dengan cara yang semakin kreatif, termasuk gambar Twitter yang warna pikselnya mengkodekan seluruh basis kode. Electronic Frontier Foundation mengirimkan surat kepada GitHub pada 16 November 2020. Argumen teknisnya sederhana. Tanda tangan yang dapat dijalankan oleh browser yang sesuai standar bukanlah "ukuran teknologi yang secara efektif mengontrol akses" dalam § 1201. youtube-dl menggunakan tanda tangan tersebut; ia tidak melanggarnya.

GitHub mengembalikan repositori tersebut pada hari yang sama. Mereka juga menjanjikan dana bantuan pengembang sebesar $1 juta dan berkomitmen untuk melakukan peninjauan teknis dan hukum secara manual terhadap setiap penghapusan berdasarkan § 1201 di masa mendatang. Kejadian ini memicu terciptanya yt-dlp. Repositori fork baru tersebut muncul dalam riwayat commit tiga hari setelah penghapusan. Belum ada yang tahu apakah GitHub akan mengalah. Para pengembang menginginkan jaminan.

Instal yt-dlp di Windows, macOS, dan Linux

Orang-orang melupakan bagian kedua dari instalasi, dan kemudian mereka bertanya-tanya mengapa langkah penggabungan (merge) mengalami crash. yt-dlp sendiri dapat mengambil satu aliran (stream) dari situs mana pun yang didukungnya, tentu saja. Tetapi video terbaik ditambah audio terbaik? Bab yang disematkan? Remux mp4? Semua itu diam-diam diserahkan ke `ffmpeg` dan `ffprobe`. Lewati kedua program tersebut dan percobaan `bv*+ba/b` pertama Anda akan mencetak sesuatu yang samar dan berhenti. Jadi: instal keduanya, setiap saat.

Untuk Windows, saya memilih winget. `winget install yt-dlp.yt-dlp`, lalu `winget install Gyan.FFmpeg`. Scoop berfungsi jika Anda sudah menggunakannya; Chocolatey juga. Jika pengelola paket terasa berlebihan, `yt-dlp.exe` yang berdiri sendiri tersedia di GitHub Releases — cukup letakkan di folder, tambahkan folder tersebut ke PATH, selesai.

Pengguna Mac mendapatkan versi yang mudah. `brew install yt-dlp ffmpeg`. Satu baris. Selesai.

Linux berbeda-beda tergantung distribusinya. Arsip utama Debian menyertakannya. Arch menyimpannya di `extra`. Fedora mengambilnya melalui saluran standar. Masalahnya adalah waktu: ketika perbaikan YouTube diterapkan, versi distribusi cenderung tertinggal beberapa hari. Solusinya adalah instalasi Python, yang merupakan cara terbaik untuk mengunduh video pada hari yang sama setelah perbaikan diterapkan: `python -m pip install -U yt-dlp` pada sistem apa pun dengan Python 3.9 atau yang lebih baru. Baris tersebut juga melakukan peningkatan di tempat. Opsi curl dan chmod masih ada dalam dokumentasi (`sudo curl -L https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -o /usr/local/bin/yt-dlp && sudo chmod +x /usr/local/bin/yt-dlp`), tetapi gunakan hanya jika tidak ada opsi pengelola paket yang tersedia.

Setelah instalasi, `yt-dlp -U` memperbarui salinan pip dan biner; ia sengaja melewati salinan pengelola paket. Pilih satu metode instalasi dan tetap gunakan metode tersebut. Penggunaan ffmpeg dan ffprobe secara bersamaan adalah hal yang mutlak.

Perintah dasar yt-dlp yang akan Anda gunakan

Panduan singkat minimalnya cukup sederhana. Perintah dasarnya, `yt-dlp URL`, sudah cukup untuk kasus umum. Semua yang lebih dari itu hanya membutuhkan satu atau dua flag.

Sebelum mengambil video YouTube, jalankan `yt-dlp -F URL` untuk melihat apa saja yang tersedia. Outputnya mencantumkan setiap format video, setiap aliran audio, dan setiap aliran gabungan yang ditemukan oleh ekstraktor, beserta codec dan ukuran file. Kebanyakan orang kemudian langsung menggunakan `yt-dlp -f "bv*+ba/b" URL`. Selektor tersebut berbunyi "video terbaik ditambah audio terbaik, kembali ke aliran gabungan terbaik jika keduanya tidak terpisah". Ini adalah sintaks pemilihan format andalan yt-dlp dan layak untuk dihafal. Tambahkan `--merge-output-format mp4` untuk memaksa kontainer; tambahkan `-x --audio-format mp3` untuk audio saja. Untuk subtitle, `--write-subs --sub-langs en` mengambil subtitle resmi, dan `--write-auto-subs` kembali ke trek yang dihasilkan secara otomatis jika tidak ada subtitle buatan manusia.

Untuk daftar, `-a urls.txt` membaca satu URL per baris dan merupakan cara standar untuk mengunduh beberapa video dalam satu kali proses. Opsi `--playlist-items 1-10,15,20-` memotong daftar putar. Dan `--download-archive seen.txt` menyimpan catatan unduhan yang telah selesai, sehingga proses ulang akan melewati apa yang sudah Anda miliki. Arsip unduhan adalah cara paling bersih untuk mengunduh seluruh daftar putar dan saluran secara bertahap tanpa mengunduh ulang. Penamaan output mengikuti templat. String `-o "%(channel)s/%(upload_date>%Y-%m-%d)s — %(title)s.%(ext)s"` menghasilkan nama file yang dikelompokkan berdasarkan tanggal dan saluran di folder yang Anda pilih. Hasilnya kompatibel dengan pustaka Plex dan Jellyfin. Opsi `-P` mengubah direktori tujuan. Opsi `--restrict-filenames` menjaga agar semuanya tetap dalam format ASCII untuk keamanan lintas sistem file. Dan `--print filename` menampilkan pratinjau apa yang akan ditulis oleh yt-dlp sebelum proses pengunduhan dimulai.

Jika unduhan "diputar alih-alih diunduh", itu berarti browser Anda membuka tautan sebelum yt-dlp melihatnya. Berikan URL sebagai argumen literal, atau kutip, dan jalankan yt-dlp dari terminal.

Fitur untuk pengguna tingkat lanjut: postprosesor, SponsorBlock, cookie

Di luar hal-hal mendasar, yt-dlp memiliki fitur yang sangat luas. Bendera-bendera di bawah ini adalah yang paling penting dalam praktiknya.

Kategori Bendera Menggunakan
Pengurutan format `-S "+ukuran,+br,res:1080"` Lebih suka file berukuran lebih kecil pada resolusi 1080p.
Pascaproses `--sematkan-thumbnail --sematkan-metadata --sematkan-bab --sematkan-subjudul` Masukkan gambar, tag, bab, dan subjudul ke dalam file.
Blok Sponsor `--sponsorblock-mark all` / `--sponsorblock-remove sponsor,selfpromo` Tandai atau potong bagian sponsor di video YouTube.
Autentikasi `--cookies-from-browser firefox` Gunakan cookie dari browser Anda; mendukung Chrome, Brave, Edge, Safari, Opera, Vivaldi, Chromium, Whale
Rekaman langsung `--live-from-start --hls-use-mpegts` Rekam siaran langsung dari awal, meskipun Anda bergabung terlambat.
Kecepatan `--concurrent-fragments 8` Pengunduhan fragmen HLS atau DASH paralel
Pengunduh eksternal `--downloader aria2c` Transfer data dilakukan ke aria2c untuk paralelisme.
Plugin `~/.yt-dlp/plugins/` Ekstraktor dan postprosesor kustom yang dapat dipasang langsung

Integrasi SponsorBlock sangat berguna. Opsi ini memanfaatkan basis data komunitas SponsorBlock. Opsi ini menandai penanda bab atau menghapus bagian sponsor dalam video YouTube secara langsung. Opsi `--cookies-from-browser` membaca cookie dari profil browser, termasuk kontainer Firefox, yang merupakan cara paling bersih untuk mengunduh apa pun yang berada di balik paywall atau memerlukan login. Untuk arsip berukuran terabyte yang berjalan lama, pengalihan pengunduh eksternal ke aria2c secara signifikan meningkatkan kecepatan unduhan pada jaringan di mana pembatasan TCP (TCP windowing) menjadi hambatan. Dan `--split-chapters` akan memisahkan konten video berdasarkan bab ke dalam file terpisah, yang berguna ketika satu unggahan menggabungkan beberapa ceramah. yt-dlp juga mendukung `--video-multistreams` untuk menggabungkan trek video di mana situs menyediakan beberapa trek, meskipun ini jarang terjadi.

Sistem plugin layak mendapat penjelasan tersendiri. yt-dlp akan secara otomatis menemukan modul Python yang ditempatkan di `~/.yt-dlp/plugins/` (atau diinstal melalui `pip` dengan titik masuk `yt-dlp-plugins`) dan memuatnya sebagai ekstraktor atau postprosesor. Inilah cara situs-situs yang tidak biasa didukung tanpa menunggu patch dari upstream. Ini juga cara plugin penyedia PoToken yang dibahas di bawah ini terhubung.

Situasi PoToken dan SABR tahun 2025-2026

YouTube menghabiskan tahun 2025 untuk mempersulit yt-dlp. Dua perubahan menjadi alasan mengapa instalasi yang awalnya berjalan lancar tiba-tiba bisa gagal pada tahun 2026.

PoToken adalah yang lebih besar. Setiap permintaan video sekarang membutuhkan Token Bukti Asal (Proof-of-Origin Token). Token tersebut terikat pada video, cepat kedaluwarsa, dan juga terikat pada sesi. Ekstraksi manual sudah tidak berfungsi lagi sejak beberapa bulan lalu. Yang masih berfungsi adalah sebuah program pembantu kecil bernama `bgutil-ytdlp-pot-provider` yang berjalan di sampingnya; program ini menghasilkan token sesuai permintaan dan panggilan utama yt-dlp akan mengambilnya secara otomatis. Wiki yt-dlp memiliki panduan yang disebut Panduan Token PO yang menjelaskan cara pengaturannya. Tanpa program pembantu ini, permintaan akan dikembalikan dengan kualitas yang lebih rendah atau bahkan diblokir, dan yt-dlp mungkin tidak berfungsi dengan benar bahkan pada video yang diputar di browser Anda tiga puluh detik sebelumnya.

SABR adalah bagian kedua. SABR adalah Server-side Adaptive Bitrate milik YouTube, dan hingga tahun 2025, ekstraktor `web` mulai mengembalikan format khusus SABR yang merusak jalur unduhan normal. Perbaikannya biasanya berupa petunjuk extractor-args ditambah cookie dari browser yang sudah masuk. Thread yang perlu dipantau sementara perbaikan ini berkembang adalah isu #12482, #14307, #14390, #16082, dan #13968. Hasil akhirnya: yt-dlp masih berfungsi pada sebagian besar konten YouTube publik, tetapi pada tahun 2026 perintah yang "langsung berfungsi" seringkali menjadi perintah "penyedia PoToken, cookie baru, dan sedikit kesabaran".

yt-dlp

Status hukum yt-dlp pada tahun 2026: AS, Jerman, Uni Eropa

Jawaban hukumnya bersifat yurisdiksional, dan intinya adalah belum ada keputusan pasti yang diambil.

Di Amerika Serikat , belum ada pengadilan yang secara khusus memutuskan kasus yt-dlp. Kasus RIAA tahun 2020 adalah preseden terdekat dan berakhir dengan pembatalan non-yudisial. Peraturan akhir Bagian 1201 Triwulan ke-9 dari Kantor Hak Cipta AS mulai berlaku pada 28 Oktober 2024 dan berlaku hingga 28 Oktober 2027. Peraturan ini memperbarui pengecualian sebelumnya dan menambahkan satu pengecualian untuk penelitian kepercayaan AI, tetapi tidak menciptakan pengecualian umum untuk pengarsipan video pribadi. Masalah struktural Bagian 1201, yaitu mengkriminalisasi alat yang menyentuh DRM tanpa memandang niat, tetap ada.

Di Jerman , tindakan hukum lebih berfokus pada tanggung jawab penyedia hosting daripada perangkat lunak itu sendiri. Pengadilan Tinggi Regional Hamburg menolak banding Uberspace, penyedia hosting `youtube-dl.org` di Mainz, pada 27 November 2024. Keputusan tersebut mengukuhkan putusan pengadilan tingkat rendah tahun 2023 yang menyatakan bahwa penyedia hosting dapat bertanggung jawab atas situs yang menampilkan alat-alat untuk menghindari pembatasan keamanan. Doktrin ini tidak secara langsung melarang yt-dlp, tetapi membuat hosting di Jerman berisiko bagi proyek apa pun yang secara terang-terangan mengiklankan kemampuan untuk melewati pembatasan keamanan.

Di tingkat Uni Eropa , Undang-Undang Layanan Digital menstandarisasi prosedur penghapusan pemberitahuan dan tindakan (Pasal 16–17) tetapi tidak mengatur perangkat lunak pengunduh. Tidak ada peraturan di seluruh Uni Eropa yang memaksa penyedia hosting untuk memblokir yt-dlp. Penggunaan pribadi yt-dlp pada konten Anda sendiri bukanlah titik tekanan hukum di yurisdiksi mana pun. Hal yang sama berlaku untuk konten di mana penciptanya telah memberikan izin. Hambatannya terletak pada distribusi dan interaksi dengan perlindungan streaming.

antarmuka pengguna grafis (GUI) dan ekosistem pengunduh yang lebih luas.

Tidak semua orang menginginkan terminal, dan baris perintah yt-dlp bukanlah kekuatan pemasaran. yt-dlp adalah salah satu dari banyak pengunduh video, tetapi ia berada di bawah sebagian besar GUI pengunduh video modern sebagai mesin penggeraknya. Stacher adalah GUI lintas platform yang paling canggih. Tartube adalah alternatif Python/GTK. yt-dlg adalah fork komunitas khusus untuk yt-dlp. Tube-Archivist adalah server Docker yang dihosting sendiri untuk pengarsipan saluran; ia dapat mengunduh video dari berbagai situs web sesuai jadwal. YTDL-Material adalah frontend web yang dihosting sendiri. ytdl-sub adalah alat konfigurasi YAML deklaratif yang populer di kalangan penyedia hosting mandiri Plex dan Jellyfin. JDownloader 2 mengintegrasikan yt-dlp melalui plugin. Setiap alat menampilkan antarmuka pemilihan video dan panel opsi unduhan sendiri, tetapi pekerjaan beratnya ada pada yt-dlp.

Alat Status (2026) Cakupan Lisensi
yt-dlp Rilis aktif setiap minggu 1.800+ situs video/audio Tidak berlisensi
youtube-dl Lambat, rilis terakhir September 2021 YouTube + ~1.000 situs Tidak berlisensi
galeri-dl Aktif Galeri gambar; dapat menghubungi yt-dlp untuk video. GPLv2
tautan aliran Aktif Siaran langsung dialirkan ke pemutar BSD-2

Aturan yang tepat: yt-dlp untuk unduhan arsip, streamlink untuk siaran langsung ke pemutar, gallery-dl untuk situs yang banyak memuat gambar.

Keamanan: tempat mengunduh yt-dlp dan cara mengenali yang palsu

Satu-satunya sumber yang aman adalah GitHub Releases, PyPI (`pip install yt-dlp`), paket distribusi resmi, dan pengelola paket Windows utama (Winget, Scoop, Chocolatey). Situs "pengunduh yt-dlp" pihak ketiga menyertakan adware, penambang mata uang kripto, atau biner yang dimodifikasi. Windows Defender secara historis menandai `yt-dlp.exe` yang dikemas oleh PyInstaller sebagai `Trojan:Win32/Wacatac.B!ml` (masalah #7532 dan #15415). Ini adalah false positive heuristik. Basis data tanda tangan biasanya dibersihkan dalam beberapa hari. Proyek open-source kecil seperti yt-dlp bertahan hidup berkat pengelola sukarelawan. Donasi kripto melalui gateway seperti Plisio adalah salah satu cara yang tahan terhadap penarikan dana dari bank bagi kontributor internasional untuk menerima dukungan.

Salah satu contoh praktis. Katakanlah Anda ingin mengunduh video YouTube ke komputer Anda untuk presentasi. Perintahnya adalah `yt-dlp -f "bv*+ba/b" --merge-output-format mp4 URL`, yang memberi Anda format unduhan yang tepat. yt-dlp adalah fork dengan lebih banyak ekstraktor daripada youtube-dl, dan yt-dlp memiliki banyak fitur yang memungkinkan Anda mengunduh video yang tidak dapat diunduh dari sumber aslinya. yt-dlp menggunakan sistem pluginnya untuk mencakup sumber-sumber khusus, dan yt-dlp memungkinkan `-a urls.txt` ketika Anda perlu mengunduh video dari berbagai situs web. Semua yang didukung oleh yt-dlp tercantum dalam `supportedsites.md`.

Ada pertanyaan?

Ya, dari sumber resmi: GitHub Releases, PyPI, paket distribusi. Windows Defender menandai biner tersebut sebagai false positive. Situs pihak ketiga "yt-dlp" menyertakan adware. Verifikasi URL-nya adalah github.com/yt-dlp/yt-dlp.

Hampir selalu PoToken atau SABR. YouTube sekarang mengikat Token Bukti Asal (Proof-of-Origin Token) ke setiap permintaan, dan protokol streaming SABR-nya mengganggu alur unduhan standar. Instal plugin `bgutil-ytdlp-pot-provider`, berikan `--cookies-from-browser firefox`, dan perbarui yt-dlp ke rilis terbaru.

Ya. Perintahnya adalah `yt-dlp -x --audio-format mp3 URL`, di mana `-x` mengekstrak audio dan `--audio-format` memilih kontainer. Ganti `mp3` dengan `m4a`, `opus`, atau `flac` untuk format lain. Dipasangkan dengan `--embed-thumbnail --embed-metadata`, file audio yang dihasilkan akan muncul dengan jelas di pemutar musik.

Cara paling sederhana: `winget install yt-dlp.yt-dlp` diikuti dengan `winget install Gyan.FFmpeg`. Scoop dan Chocolatey juga berfungsi. Untuk instalasi native Python, `python -m pip install -U yt-dlp`. Perbarui dengan `yt-dlp -U`. `yt-dlp.exe` versi standalone tersedia di GitHub Releases.

Warisan yang sama, kecepatan yang sangat berbeda. yt-dlp merilis sekitar dua puluh hingga tiga puluh versi per tahun; versi terakhir youtube-dl adalah pada tahun 2021. yt-dlp menambahkan SponsorBlock, pemilihan format tingkat lanjut seperti `-f "bv*+ba/b"`, fragmen HLS paralel, cookie dari browser, perekaman langsung, flag arsip unduhan, dan ekstraktor YouTube yang berfungsi.

Yurisdiksi. Tidak ada pengadilan AS yang secara khusus memutuskan tentang yt-dlp; di Jerman, putusan Hamburg November 2024 membuat penyedia hosting bertanggung jawab atas situs-situs yang menunjukkan cara menghindari pembatasan. Menggunakan yt-dlp pada unggahan Anda sendiri atau dengan izin pembuatnya tidak dipersoalkan secara hukum di mana pun. Konten yang dilindungi hak cipta berada di zona abu-abu.

Ready to Get Started?

Create an account and start accepting payments – no contracts or KYC required. Or, contact us to design a custom package for your business.

Make first step

Always know what you pay

Integrated per-transaction pricing with no hidden fees

Start your integration

Set up Plisio swiftly in just 10 minutes.