İçeriğe atla
yt-dlp

yt-dlp seçenek listesi

yt-dlp 2026.07.21 esas alınarak yazıldı. Sürümler arasında seçenekler eklenir ve adları değişir; kendi sürümünüzü yt-dlp --version ile kontrol edin.

Temel

Ne istiyorsunuz

Yalnızca ses seçeneği ses parçasını çıkarır ve görüntüyü atar.

Video ve kalite

-f FORMAT --format

En yüksek kalite

Yüksekliğe üst sınır koyar. yt-dlp yine de o sınırdaki veya altındaki en iyi akışı seçer.

-f FORMAT --format

Kendi format selector'ınız

Kalite listesinin yerine geçer. Format söz dizimini zaten bilenler için.

Örnekler

  • -f "bv*[vcodec^=av01]+ba"
  • -f "b[filesize<50M]"
--remux-video FORMAT ffmpeg gerekir

Şuna remux et

Akışları yeniden kodlamadan yeniden paketler. Hızlı ve kayıpsız.

Şuna yeniden kodla

Videoyu yeniden kodlar. Yavaş ve kayıplı — yalnızca remux yetmediğinde.

Ses

Ses kalitesi

VBR en iyi boyut-kalite oranını verir; sabit bitrate boyutu daha kolay kestirilir.

Altyazı

Altyazı

Gömmek altyazıyı videonun içine koyar; kaydetmek yanına ayrı bir .srt dosyası yazar.

Altyazı dilleri

Virgülle ayırın. Mevcut bütün diller için all yazın.

Örnekler

  • --sub-langs "en,vi"
  • --sub-langs "en.*,ja"
  • --sub-langs all

Otomatik oluşturulan altyazılar

İnsan eliyle yazılmış altyazı yoksa makine üretimi olanları da alır.

Oynatma listeleri ve kanallar

Oynatma listesi davranışı

Adres hem bir videoya hem bir oynatma listesine aitse ne yapılacağı.

-I ITEM_SPEC --playlist-items

Hangi öğeler

Aralık da liste de çalışır; örneğin 1-10,15 ya da sondan başlayarak iki öğeden birini almak için -5::2.

Örnekler

  • -I 1:5
  • -I "1,3,7-10"
  • -I "-5::2"

Kayıt dosyası

Nelerin indirildiğini not eder, böylece komutu yeniden çalıştırınca onları atlar. Bir kanalı güncel tutmanın yolu budur.

Bölümler ve sahneler

Yalnızca bir bölümü indir

*00:01:30-00:03:00 gibi bir zaman aralığı ya da bir sahne adı. Baştaki yıldız, bunun bir zaman damgası olduğunu belirtir.

Örnekler

  • --download-sections "*00:01:30-00:03:00"
  • --download-sections "intro"
--split-chapters ffmpeg gerekir

Sahnelere böl

Tek uzun dosya yerine her sahne için ayrı bir dosya yazar.

Üstveri ve kapak

--embed-thumbnail ffmpeg gerekir

Küçük resmi göm

Videonun küçük resmini kapak olarak kullanır.

--embed-metadata ffmpeg gerekir

Üstveriyi göm

Başlığı, yükleyeni ve tarihi dosyanın kendi içine yazar.

--embed-chapters ffmpeg gerekir

Sahneleri göm

Oynatıcınızın aralarında atlayabileceği sahne işaretleri ekler.

Küçük resmi dosya olarak kaydet

Kapak görselini videonun yanına yazar.

Üstveriyi JSON olarak kaydet

yt-dlp'nin video hakkında bildiği her şeyi bir .info.json dosyasına yazar.

SponsorBlock

Bölümleri çıkar

SponsorBlock verilerine dayanarak topluluğun işaretlediği bölümleri dosyadan keser.

Bölümleri sahne olarak işaretle

Bölümleri bırakır ama işaretler, böylece kendiniz atlayabilirsiniz.

Dosyalar ve klasörler

Dosya adı şablonu

Alan adları %(...)s içine yazılır. Eğik çizgiler klasör oluşturur.

Örnekler

  • -o "%(title)s.%(ext)s"
  • -o "%(playlist_index)02d - %(title)s.%(ext)s"

İndirme klasörü

Dosyaların nereye yazılacağı. Yukarıdaki şablonla birleştirince alt klasörler oluşur.

Güvenli dosya adları (yalnızca ASCII)

Aksanları, boşlukları ve titiz bir dosya sisteminin geri çevirebileceği her karakteri atar.

Windows'a uygun adlar

Başka bir sistemde çalışıyor olsanız da Windows'un kabul etmediği karakterleri atar.

Var olan dosyaların üzerine yaz

Zaten orada olan dosyaların yerine yenisini koyar.

-w --no-overwrites

Asla üzerine yazma

Daha önce indirilmiş olan her şeyi atlar.

-c --continue

Yarım kalan indirmeleri sürdür

İndirmenin kesildiği yerden devam eder.

Filtreler

Şu tarihten sonra yüklenmiş

YYYYAAGG ya da now-1month gibi göreli bir tarih.

Örnekler

  • --dateafter 20240101
  • --dateafter now-1month

En küçük boyut

Bundan küçük olanları atlar. 5M, 500K gibi değerleri kabul eder.

-r RATE --limit-rate

Hız sınırı

Örneğin 2M ya da 500K. Bant genişliğinin kalanına başka bir iş için ihtiyacınız varsa işe yarar.

-N N --concurrent-fragments

Koşut fragment sayısı

Parçalara bölünmüş akışları hızlandırır. Dört, makul bir başlangıçtır.

-R RETRIES --retries

Yeniden deneme

Başarısız olan bir parçanın kaç kez yeniden denenceği. infinite de yazılabilir.

Bölge engelini aş

İsteğin kaynağını başka gösterir. Kimi sitelerde işe yarar, hepsinde değil.

Tarayıcı gibi görün

İstekleri gerçek bir tarayıcıdan geliyormuş gibi gösterir. Aniden 403 almaya başladığınızda alışılmış çözüm budur.

Oturum ve cookies

Cookies dosyası

Tarayıcınızdan dışa aktarılmış, Netscape biçiminde bir cookies.txt dosyası.

Canlı yayın

Baştan kaydet

Canlı yayını şu andan değil, başından itibaren kaydetmeye başlar.

Yayını bekle

Planlanmış bir yayın başlayana dek sorgular. MIN-MAX, denetimler arasındaki saniye aralığıdır.

Geçici çözümler

--user-agent UA eskimiş — --add-headers

User agent

--add-headers lehine eskimiştir. Pek çok eski rehber hâlâ bunu kullandığı için duruyor.

--referer URL eskimiş — --add-headers

Referer

--add-headers lehine eskimiştir.

Extractor argümanları

Siteye özgü seçenekler, örneğin youtube:player_client=web.

Örnekler

  • --extractor-args "youtube:player_client=web,android"

Çıktı ve hata ayıklama

-i --ignore-errors

Hataya rağmen sürdür

Durmak yerine başarısız öğeleri atlar. Büyük oynatma listelerinde şart.

-F --list-formats

Yalnızca biçimleri listele

Mevcut biçimleri yazdırır ve indirme yapmadan çıkar.

-s --simulate

Deneme çalıştırması

Dosyayı yazmak dışında her şeyi yapar.