yt-dlp: Video İndirmek İçin Modern Bir youtube-dl Alternatifi
23 Ekim 2020'de, Amerika Kayıt Endüstrisi Birliği (RIAA), GitHub'daki youtube-dl'ye karşı DMCA kaldırma talebinde bulundu. Üç gün sonra, 26 Ekim'de, github.com/yt-dlp/yt-dlp adresinde sessizce yeni bir depo ortaya çıktı. GitHub, 16 Kasım'da orijinal projeyi (1 milyon dolarlık yeni bir geliştirici savunma fonuyla birlikte) yeniden etkinleştirdiğinde, yeni çatal (fork) çoktan youtube-dl'nin katkıda bulunanlarını bünyesine katmaya başlamıştı.
Bu çatal artık ana sürüm. Mayıs 2026 itibarıyla, yt-dlp PyPI'da ayda 12 milyondan fazla indirme sayısına ulaşıyor. GitHub deposu 160.766 yıldız almış durumda. Proje yaklaşık her iki haftada bir yeni bir sürüm yayınlıyor. Yazım anındaki en son etiket `2026.03.17`. Çıkarma eklenti sistemi aracılığıyla 1800'den fazla video ve ses sitesini destekliyor. Aşağıda, yt-dlp'nin ne olduğu ve nasıl kullanılacağına dair dürüst bir inceleme yer alıyor. Ayrıca 2026'da yasal olarak nerede durduğu ve mükemmel çalışan bir kurulumun 2025 ortalarında aniden neden çalışmayı durdurabileceği de anlatılıyor.
yt-dlp'nin kökeni: youtube-dl'nin çatallanma zinciri.
Burada soy ağacı önemlidir çünkü davranışsal bir boşluğu açıklar. yt-dlp, YouTube'da bir sorun oluştuğunda saatler içinde düzeltmeler gönderirken, youtube-dl haftalar sürebilir. Soy ağacında üç proje yer alıyor ve her adım bir öncekinden duyulan hayal kırıklığıyla yönlendirildi.
Orijinal proje youtube-dl idi. Ricardo García bunu Ağustos 2006'da yazdı ve daha sonra Philipp Hagemeister, `ytdl-org/youtube-dl` altında sıkı bir grupla birlikte projeyi yönetti. 2020 yılına gelindiğinde fiili arşivleme aracı haline gelmişti, ancak çekme istekleri birikiyordu ve YouTube düzeltmeleri geç geliyordu.
Bu boşluk, "c" harfinin "community" (topluluk) anlamına geldiği youtube-dlc'yi ortaya çıkardı. `blackjack4494` 2020'de depoyu çatalladı ve birleştirme kuyruğu birkaç gün içinde temizlendi. Çatalın kendisi aynı yılın sonlarında yarı aktif hale geldi - tek bir bakımcının olması kırılgan bir durum.
yt-dlp, youtube-dlc'nin yeniden çatallanmış bir versiyonudur. Depo, 26 Ekim 2020'de, youtube-dl'nin RIAA tarafından kaldırılmasından üç gün sonra oluşturulmuştur. yt-dlp, desteklenen web sitelerinden video ve ses dosyaları indirmenizi sağlayan bir komut satırı aracıdır. "p" harfi, erken dönemdeki baş geliştiriciyi (`pukkandan`) yansıtır. Proje şu anda `coletdjnz`, `dirkf`, `Grub4K`, `basholly` ve `seproDev`'i içeren çoklu geliştirici bir kuruluş tarafından yönetilmektedir. Ocak 2021'e kadar yt-dlp, youtube-dlc'nin katkıda bulunan tabanını bünyesine katmış ve youtube-dl'nin baskın çatalı haline gelmiştir. Odak noktası, ana geliştiricinin birleştirmediği özellikler ve iyileştirmeler olmuştur.
Proje düzeyinde birkaç önemli noktayı belirtmekte fayda var. yt-dlp takvim tabanlı sürümleme kullanıyor, bu nedenle `2026.03.17` gibi bir etiket, tam olarak sürüm tarihini gösteriyor. Lisans, çoğu FOSS projesinin bile kullanmadığı, açık bir şekilde kamu malı olarak kabul edilen The Unlicense'tır. Deponun 13.348 çatalı ve 2.507 açık sorunu var. Ubuntu 22.04, varsayılan video indirme programı olarak youtube-dl'nin yerine yt-dlp'yi getirdi ve Debian da bookworm ile bunu takip etti. `supportedsites.md` dosyasındaki desteklenen siteler listesi şu anda 1.500'den fazla isimli giriş içeriyor; kod tabanının kendisi ise tembel yükleme ile yaklaşık 1.800 çıkarıcı modül içeriyor. Arch, Fedora, NixOS, Homebrew, Chocolatey, Scoop ve Winget'in hepsi bunu paketliyor. Yılda yirmi ila otuz sürüm, dağıtımların daha yavaş olan ana akıma geri dönmesini engelledi.

RIAA'nın 2020'deki müdahalesi yt-dlp'yi nasıl kaçınılmaz hale getirdi?
RIAA'nın 23 Ekim 2020 tarihli DMCA bildirimi, 17 USC § 1201, yani telif hakkı ihlalini önleme maddesi kapsamında yapılmıştır. İddia, youtube-dl'nin YouTube'un "kayan şifreleme" imza mekanizmasını atladığı yönündeydi; RIAA bunu telif hakkıyla korunan eserlere erişimi koruyan teknolojik bir önlem olarak nitelendirmişti. GitHub başlangıçta bu uyarıya uyarak depoyu ve on yedi kopyasını kaldırdı.
Ardından tam anlamıyla Streisand etkisi yaşandı. Geliştiriciler, kaynak kodunu giderek daha yaratıcı yöntemlerle yeniden yayınladılar; bunlardan biri de piksel renkleri tüm kod tabanını kodlayan bir Twitter görseliydi. Elektronik Sınır Vakfı (Electronic Frontier Foundation), 16 Kasım 2020'de GitHub'a bir mektup gönderdi. Teknik gerekçesi basitti: Herhangi bir standartlara uygun tarayıcının çalıştırabileceği bir imza, § 1201 kapsamında "erişimi etkin bir şekilde kontrol eden teknolojik bir önlem" değildir. youtube-dl bu imzayı kullanır; onu bozmaz.
GitHub aynı gün depoyu geri yükledi. Ayrıca 1 milyon dolarlık bir geliştirici savunma fonu sözü verdi ve bundan sonraki her § 1201 kaldırma işleminin manuel teknik ve hukuki incelemesini yapacağına dair taahhütte bulundu. Bu olay yt-dlp'nin oluşturulmasına yol açtı. Yeni çatalın deposu, kaldırma işleminden üç gün sonra taahhüt geçmişinde göründü. GitHub'ın geri adım atıp atmayacağı henüz bilinmiyordu. Geliştiriciler güvence istiyordu.
yt-dlp'yi Windows, macOS ve Linux'a yükleyin.
İnsanlar kurulumun ikinci yarısını unutuyor ve sonra birleştirme adımının neden çöktüğünü merak ediyorlar. yt-dlp tek başına desteklediği sitelerden herhangi birinden tek bir akış çekebilir, elbette. Ama en iyi video artı en iyi ses? Gömülü bölümler? Bir mp4 yeniden düzenlemesi? Tüm bunlar sessizce `ffmpeg` ve `ffprobe`'a devrediliyor. Bu ikisini atlarsanız, ilk `bv*+ba/b` denemeniz anlaşılmaz bir şey yazdırır ve çöker. Bu yüzden: her seferinde ikisini de kurun.
Windows için winget'i tercih ediyorum. `winget install yt-dlp.yt-dlp` ve ardından `winget install Gyan.FFmpeg` komutlarını çalıştırın. Scoop zaten kullanıyorsanız o da işe yarar; Chocolatey de. Paket yöneticisi kullanmak gereksiz geliyorsa, GitHub Releases'da bulunan bağımsız `yt-dlp.exe` dosyasını bir klasöre bırakın, klasörü PATH'e ekleyin, işlem tamam.
Mac kullanıcıları için kolay yol: `brew install yt-dlp ffmpeg`. Tek satır. Devam edin.
Linux dağıtımına göre değişiklik gösterir. Debian'ın ana arşivi bunu içerir. Arch bunu `extra` içinde tutar. Fedora ise standart kanallar aracılığıyla alır. Sorun zamanlamada: YouTube'da bir hata oluştuğunda, dağıtım sürümleri günlerce geride kalma eğilimindedir. Kurtuluş yolu, bir düzeltme yayınlandıktan sonra aynı gün videoları indirmenin en iyi yolu olan Python kurulumudur: Python 3.9 veya daha yeni bir sürüme sahip herhangi bir sistemde `python -m pip install -U yt-dlp` komutu çalıştırılır. Bu komut ayrıca yerinde yükseltme de yapar. Curl ve chmod seçeneği hala belgelerde yer almaktadır (`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`), ancak yalnızca paket yöneticisi seçeneği mevcut olmadığında kullanılır.
Kurulumdan sonra, `yt-dlp -U` komutu pip ve ikili dosyaların kopyalarını günceller; paket yöneticisi kopyalarını bilerek atlar. Bir kurulum yöntemi seçin ve ona bağlı kalın. ffmpeg ve ffprobe'un birlikte kullanımı tartışılmazdır.
Gerçekte kullanacağınız temel yt-dlp komutları
En basit özet bilgi sayfası kısadır. `yt-dlp URL` komutu, genel durumlar için yeterlidir. Bunun ötesindeki her şey bir veya iki bayrakla halledilir.
YouTube videosu indirmeden önce, mevcut seçenekleri görmek için `yt-dlp -F URL` komutunu çalıştırın. Çıktı, çıkarıcının bulduğu her video formatını, her ses akışını ve önceden birleştirilmiş her akışı, kodekler ve dosya boyutlarıyla birlikte listeler. Çoğu kişi daha sonra doğrudan `yt-dlp -f "bv*+ba/b" URL` komutuna geçer. Bu seçici, "en iyi video artı en iyi ses, ikisi ayrı değilse en iyi birleştirilmiş akışa geri dön" anlamına gelir. Bu, yt-dlp'nin amiral gemisi format seçim sözdizimidir ve ezberlemeye değerdir. Kapsayıcıyı zorlamak için `--merge-output-format mp4` ekleyin; yalnızca ses için `-x --audio-format mp3` ekleyin. Altyazılar için, `--write-subs --sub-langs en` resmi olanları alır ve `--write-auto-subs` insan tarafından oluşturulmuş bir altyazı yoksa otomatik olarak oluşturulan parçaya geri döner.
Listeler için, `-a urls.txt` her satırda bir URL okur ve tek seferde birden fazla video indirmek için standart yöntemdir. `--playlist-items 1-10,15,20-` bayrağı bir oynatma listesini dilimler. Ve `--download-archive seen.txt` tamamlanan indirmelerin kaydını tutar, böylece tekrar çalıştırmalar zaten sahip olduklarınızı atlar. İndirme arşivi, tüm oynatma listelerini ve kanalları yeniden indirmeden artımlı olarak indirmenin en temiz yoludur. Çıktı adlandırması bir şablonu izler. `-o "%(channel)s/%(upload_date>%Y-%m-%d)s — %(title)s.%(ext)s"` dizesi, seçtiğiniz klasörde tarihli, kanal gruplandırılmış dosya adları üretir. Sonuç, Plex ve Jellyfin kütüphaneleriyle uyumludur. `-P` bayrağı hedef dizini değiştirir. `--restrict-filenames` bayrağı, dosya sistemleri arası güvenlik için her şeyi ASCII olarak tutar. `--print filename` seçeneği ise indirme işlemi başlamadan önce yt-dlp'nin ne yazacağını önizler.
Eğer indirme işlemi "indirmek yerine oynatılıyorsa", bunun nedeni tarayıcınızın yt-dlp bağlantıyı görmeden önce açmasıdır. URL'yi doğrudan argüman olarak geçirin veya tırnak içine alın ve yt-dlp'yi terminalden çalıştırın.
Gelişmiş kullanıcı özellikleri: işlem sonrası efektler, SponsorBlock, çerezler
Temel özelliklerin ötesinde, yt-dlp'nin oldukça geniş bir özellik yelpazesi var. Aşağıdaki bayraklar, pratikte en çok önem taşıyanlardır.
| Kategori | Bayrak | Kullanmak |
|---|---|---|
| Biçim sıralaması | `-S "+size,+br,res:1080"` | 1080p çözünürlükte daha küçük dosyaları tercih edin. |
| Son işlem | `--embed-thumbnail --embed-metadata --embed-chapters --embed-subs` | Resimleri, etiketleri, bölümleri ve alt başlıkları dosyaya ekleyin. |
| SponsorBlok | `--sponsorblock-mark all` / `--sponsorblock-remove sponsor,selfpromo` | YouTube videolarındaki sponsor bölümlerini işaretleyin veya kaldırın. |
| Kimlik doğrulama | `--cookies-from-browser firefox` | Tarayıcınızdan çerezleri kullanın; Chrome, Brave, Edge, Safari, Opera, Vivaldi, Chromium, Whale'i destekler. |
| Canlı kayıt | `--live-from-start --hls-use-mpegts` | Geç katılsanız bile canlı yayını baştan itibaren kaydedin. |
| Hız | `--eşzamanlı-parçalar 8` | Paralel HLS veya DASH parça indirmeleri |
| Harici indirici | `--downloader aria2c` | Paralellik için aktarımlar aria2c'ye yönlendiriliyor. |
| Eklentiler | `~/.yt-dlp/plugins/` | Özelleştirilebilir çıkarıcılar ve son işlemciler |
SponsorBlock entegrasyonu kullanışlıdır. Bu seçenek, SponsorBlock topluluk veritabanından yararlanır. Ya bölüm işaretleyicilerini işaretler ya da YouTube videolarındaki sponsor bölümlerini tamamen kaldırır. `--cookies-from-browser` seçeneği, Firefox kapsayıcıları da dahil olmak üzere tarayıcı profillerinden çerezleri okur; bu, ücretli veya oturum açma gerektiren içerikleri indirmenin en temiz yoludur. Terabaytlarca uzun süreli arşivler için, harici indiricinin aria2c'ye devredilmesi, TCP pencerelemenin darboğaz olduğu ağlarda indirme hızını belirgin şekilde artırır. Ve `--split-chapters`, video içeriğini bölümlere göre ayrı dosyalara böler; bu, tek bir yüklemede birden fazla konuşma olduğunda kullanışlıdır. yt-dlp ayrıca, sitenin birden fazla video parçası sağladığı durumlarda video parçalarını birleştirmek için `--video-multistreams` seçeneğini de destekler, ancak bu kullanımda nadirdir.
Eklenti sistemi ayrı bir satırda ele alınmayı hak ediyor. yt-dlp, `~/.yt-dlp/plugins/` dizinine yerleştirilen (veya `yt-dlp-plugins` giriş noktasıyla `pip` aracılığıyla yüklenen) Python modüllerini otomatik olarak keşfeder ve bunları çıkarıcı veya son işlemci olarak yükler. Bu sayede, alışılmadık siteler, yukarı akış yaması beklemeden desteklenir. Ayrıca, aşağıda ele alınan PoToken sağlayıcı eklentilerinin de bu şekilde entegre olması sağlanır.
2025-2026 PoToken ve SABR durumu
YouTube, 2025 yılını yt-dlp'nin işini zorlaştırmakla geçirdi. Mükemmel çalışan bir kurulumun 2026'da aniden başarısız olmaya başlamasının nedeni iki değişikliktir.
PoToken daha büyük bir sorun. Artık her video isteği için bir Kaynak Kanıtı Token'ı gerekiyor. Token videoya bağlı, kısa sürede süresi doluyor ve oturumla da bağlantılı. Manuel token çıkarma işlemi aylar önce durdu. Çalışan şey ise yan tarafta çalışan `bgutil-ytdlp-pot-provider` adlı küçük bir yardımcı program; bu program isteğe bağlı olarak token üretiyor ve ana yt-dlp çağrısı bunları otomatik olarak alıyor. yt-dlp wiki'sinde kurulumu anlatan PO Token Kılavuzu adlı bir rehber bulunuyor. Yardımcı program olmadan, istekler düşürülmüş olarak geri döner veya basitçe engellenir ve yt-dlp, tarayıcınızda otuz saniye önce oynatılan videolarda bile doğru çalışmayabilir.
SABR ikinci parça. SABR, YouTube'un Sunucu Tarafı Uyarlanabilir Bit Hızı'dır ve 2025 yılı boyunca `web` çıkarıcısı, normal indirme yolunu bozan yalnızca SABR formatlarını döndürmeye başladı. Çözüm genellikle bir çıkarıcı argümanı ipucu ve oturum açılmış bir tarayıcıdan gelen çerezlerdir. Çözüm olgunlaşırken takip edilmesi gereken konular #12482, #14307, #14390, #16082 ve #13968 numaralı sorunlardır. Sonuç olarak: yt-dlp, YouTube'daki genel içeriğin büyük çoğunluğunda hala çalışıyor, ancak 2026'da "sorunsuz çalışıyor" komutu genellikle "PoToken sağlayıcısı, yeni çerezler ve biraz sabır" komutu haline geliyor.

yt-dlp'nin 2026'daki yasal statüsü: ABD, Almanya, AB
Hukuki cevap yargı yetkisiyle ilgili ve genel kanı, henüz hiçbir şeyin kesin olarak çözüme kavuşturulmadığı yönünde.
Amerika Birleşik Devletleri'nde, yt-dlp hakkında özel olarak hiçbir mahkeme karar vermemiştir. 2020 RIAA olayı en yakın emsaldir ve yargı dışı bir kararla sonuçlanmıştır. ABD Telif Hakkı Ofisi'nin 9. Üç Yıllık Bölüm 1201 nihai kuralı 28 Ekim 2024'te yürürlüğe girmiş ve 28 Ekim 2027'ye kadar geçerli olacaktır. Önceki muafiyetleri yeniledi ve yapay zeka güvenilirliği araştırması için bir muafiyet ekledi, ancak kişisel video arşivleme için genel bir atlatma muafiyeti oluşturmadı. Bölüm 1201'in yapısal sorunu, yani niyetten bağımsız olarak DRM'ye dokunan araçları suç haline getirmesi, devam etmektedir.
Almanya'da , dava yazılımın kendisinden ziyade barındırma sorumluluğu etrafında dönüyor. Hamburg Yüksek Bölge Mahkemesi, `youtube-dl.org` sitesinin Mainz merkezli barındırıcısı Uberspace'in temyiz başvurusunu 27 Kasım 2024'te reddetti. Bu karar, barındırma sağlayıcılarının, engelleme araçlarını işaret eden sitelerden sorumlu tutulabileceğine dair 2023 tarihli bir alt mahkeme kararını kesinleştirdi. Bu doktrin doğrudan yt-dlp'yi yasaklamasa da, engelleme yeteneklerini açıkça reklam eden herhangi bir proje için Alman barındırmasını riskli hale getiriyor.
AB düzeyinde , Dijital Hizmetler Yasası, bildirim ve işlem gerektiren kaldırma prosedürlerini standartlaştırmaktadır (Madde 16-17), ancak indirme yazılımlarını düzenlememektedir. Barındırma sağlayıcılarını yt-dlp'yi engellemeye zorlayan AB çapında bir düzenleme bulunmamaktadır. Kendi içeriğinizde yt-dlp'nin kişisel kullanımı, bu yargı bölgelerinin hiçbirinde yasal baskı noktası değildir. Yaratıcının izin verdiği içerikler için de aynı durum geçerlidir. Sürtüşme, dağıtımda ve akış korumasıyla etkileşimde yatmaktadır.
GUI ön uçları ve daha geniş indirme ekosistemi
Herkes terminal istemez ve yt-dlp'nin komut satırı pazarlama açısından güçlü bir yanı değildir. yt-dlp birçok video indirme programından biridir, ancak çoğu modern video indirme programının grafik arayüzünün (GUI) altında çalışan motor olarak yer alır. Stacher, en gelişmiş platformlar arası GUI'dir. Tartube, Python/GTK alternatifidir. yt-dlg, özellikle yt-dlp için geliştirilmiş bir topluluk çatalıdır. Tube-Archivist, kanal arşivleme için kendi kendine barındırılan bir Docker sunucusudur; çeşitli web sitelerinden videoları programlı olarak indirebilir. YTDL-Material, kendi kendine barındırılan bir web arayüzüdür. ytdl-sub, Plex ve Jellyfin kullanıcıları arasında popüler olan bildirimsel bir YAML yapılandırma aracıdır. JDownloader 2, bir eklenti aracılığıyla yt-dlp'yi entegre eder. Her araç kendi video seçim arayüzünü ve indirme seçenekleri panelini sunar, ancak asıl işi yt-dlp yapar.
| Alet | Durum (2026) | Kapsam | Lisans |
|---|---|---|---|
| yt-dlp | Aktif, haftalık yayınlar | 1.800'den fazla video/ses sitesi | Lisanssız |
| youtube-dl | Yavaş, son sürüm Eylül 2021 | YouTube + ~1.000 site | Lisanssız |
| galeri-dl | Aktif | Resim galerileri; videolar için yt-dlp çağrılabilir. | GPLv2 |
| akış bağlantısı | Aktif | Canlı yayınlar bir oynatıcıya aktarılıyor. | BSD-2 |
Temel kural: Arşiv indirmeleri için yt-dlp, oynatıcıya canlı yayın için streamlink, çok fazla görsel içeren siteler için gallery-dl.
Güvenlik: yt-dlp nereden indirilir ve sahte sürümler nasıl tespit edilir?
Tek güvenli kaynaklar GitHub Sürümleri, PyPI (`pip install yt-dlp`), resmi dağıtım paketleri ve başlıca Windows paket yöneticileridir (Winget, Scoop, Chocolatey). Üçüncü taraf "yt-dlp indirici" siteleri reklam yazılımı, madencilik yazılımları veya değiştirilmiş ikili dosyalar içerir. Windows Defender, geçmişte PyInstaller ile paketlenmiş `yt-dlp.exe` dosyasını `Trojan:Win32/Wacatac.B!ml` olarak işaretlemiştir (sorunlar #7532 ve #15415). Bunlar sezgisel yanlış pozitiflerdir. İmza veritabanları genellikle birkaç gün içinde temizlenir. yt-dlp gibi küçük açık kaynak projeleri gönüllü bakımcılar sayesinde hayatta kalır. Plisio gibi ağ geçitleri aracılığıyla yapılan kripto para bağışları, uluslararası katkıda bulunanların destek almasının bankacılık sistemine karşı dirençli bir yoludur.
Bir örnek verelim. Diyelim ki bir sunum için bilgisayarınıza bir YouTube videosu indirmek istiyorsunuz. Komut şu şekildedir: `yt-dlp -f "bv*+ba/b" --merge-output-format mp4 URL`, bu da size doğru indirme formatını verir. yt-dlp, youtube-dl'den daha fazla çıkarıcıya sahip bir çataldır ve orijinali video indirmeyi reddettiğinde bile video indirmenize olanak tanıyan birçok özelliği vardır. yt-dlp, eklenti sistemiyle niş kaynakları da kapsar ve çeşitli web sitelerinden video indirmeniz gerektiğinde `-a urls.txt` seçeneğini kullanmanıza olanak tanır. yt-dlp tarafından desteklenen her şey `supportedsites.md` dosyasında yer almaktadır.