Temel indirmeler
Hiç seçenek verilmediğinde yt-dlp birleştirebildiği en iyi bileşimi seçer ve dosyayı başlığa göre adlandırır. Şaşırtıcı biçimde sık sık doğru komut budur.
yt-dlp URL
Büyük bir şey indirmeden önce gerçekte nelerin sunulduğuna bakmakta fayda var. Bu, biçim tablosunu yazdırır ve hiçbir şey indirmeden çıkar.
yt-dlp -F URL
O tablonun sol sütunu biçim id’sidir; sonrasında doğrudan onu isteyebilirsiniz. + ile birleştirilen iki id “ikisini de indir ve birleştir” demektir.
yt-dlp -f 137+140 URL
Kalite ve biçim seçimi
Sabit yazılmış biçim id’leri, bir site kodlama basamaklarını değiştirdiği anda bozulur. Seçici ifadesi kalıcı olan yoldur: istediğiniz özellikleri söyleyin, en iyi eşleşmeyi bulmayı yt-dlp’ye bırakın.
yt-dlp -f "bv*[height<=1080]+ba/b[height<=1080]" URL
Şöyle okuyun: yüksekliği en fazla 1080 olan en iyi video akışı artı en iyi ses; bu ikili yoksa yüksekliği en fazla 1080 olan en iyi tek dosya. Eğik çizgiden sonraki bu yedek seçenek, yalnızca aşamalı akış yayımlayan sitelerde komutun hata vermesini engelleyen şeydir.
İki akışı birleştirmek, yt-dlp’nin bir kapsayıcı seçmesini gerektirir. MP4 her yerde oynar; MKV içine ne atarsanız kabul eder ve altyazılarla bölümler işin içine girdiğinde bu önem kazanır.
yt-dlp -f "bv*+ba" --merge-output-format mp4 URL
Katı bir sınır yerine tercih belirtmek için süzmek yerine sıralayın. Böylece 1080p ve MP4 tercih edilir ama ikisi de yokken yine de bir şey indirilir.
yt-dlp -S "res:1080,ext:mp4" URL
Ses ve MP3
Sesi ayıklamak ffmpeg gerektirir — yeni kurulmuş bir sistemde aşağıdaki komutun başarısız olmasının açık ara en yaygın nedeni budur.
yt-dlp -x --audio-format mp3 URL
Kapak görseli ve etiket eklemek iki bayrak daha ister ve sonucu isimsiz dosyalarla dolu bir klasör olmaktan çıkarıp müzik kitaplığında kullanılabilir hale getirir.
yt-dlp -x --audio-format mp3 --audio-quality 0 --embed-thumbnail --embed-metadata URL
--audio-quality 0, “sıfır kalite” değil, en iyi ayarda değişken bit hızı demektir. Sabit bir bit hızı gerekiyorsa değerini yazın: --audio-quality 320K.
Kaynak zaten AAC ya da Opus ise MP3’e çevirmek yeniden kodlama yapar ve boşuna kalite kaybettirir. Özgün halini korumak hem daha hızlı hem daha iyidir.
yt-dlp -x --audio-format best URL
Altyazılar
Gömülü altyazılar dosyayla birlikte gider; ayrı .srt dosyalarını düzenlemek ve başka bir yere aktarmak daha kolaydır.
yt-dlp --embed-subs --sub-langs en URL yt-dlp --write-subs --sub-langs en,vi --convert-subs srt URL
Makine üretimi altyazılar ayrı bir anahtardır. O olmadan, insan altyazısı bulunmayan bir videodan hiçbir şey çıkmaz — hata da vermez.
yt-dlp --write-auto-subs --sub-langs en --convert-subs srt --skip-download URL
Oynatma listeleri ve kanallar
Bir YouTube adresi çoğu zaman hem bir videoya hem bir oynatma listesine aittir ve yt-dlp hangisini kastettiğinizi tahmin etmek zorunda kalır. Açıkça söyleyin.
yt-dlp --no-playlist URL yt-dlp --yes-playlist URL
Uzun işlerde arşiv dosyası buradaki diğer tüm seçeneklerden daha önemlidir: neyin indirildiğini kaydeder, böylece yeniden çalıştırdığınızda baştan başlamak yerine kaldığı yerden devam eder.
yt-dlp --yes-playlist -i \ --download-archive archive.txt \ -o "%(playlist_index)02d - %(title)s.%(ext)s" \ URL
-i ile birlikte, bölgesel kısıtlı ya da silinmiş tek bir video artık diğer iki yüz videoyu yarıda kesmez. Hepsi yerine bir dilim almak için -I aralık ve liste kabul eder: -I 1:10, -I "1,3,7-10".
Kesitler, bölümler ve sponsorlar
Videonun tamamı yerine bir bölümünü indirebilirsiniz. Baştaki yıldız, bölüm adını değil zaman damgasını gösterir ve tırnaklar zorunludur — bash çıplak bir * işaretini dosya adlarınıza karşı genişletir.
yt-dlp --download-sections "*00:01:30-00:03:00" URL
SponsorBlock, topluluğun gönderdiği işaretleri kullanarak bölümleri tümüyle keser ya da kendiniz atlayabileceğiniz bölümler olarak bırakır.
yt-dlp --sponsorblock-remove default URL yt-dlp --sponsorblock-mark all --embed-chapters URL
Dosya adları ve klasörler
Çıktı şablonu ikisini birden yönetir. Eğik çizgi bir dizin oluşturur, yani tek bir şablon bütün bir arşivi düzenleyebilir.
yt-dlp -o "%(uploader)s/%(upload_date>%Y-%m-%d)s - %(title)s.%(ext)s" URL
Başlıklar sık sık bazı dosya sistemlerinin kabul etmediği karakterler içerir. --restrict-filenames her şeyi düz ASCII’ye indirger; makineler arasında taşınacak her şey için buna değer.
Windows’ta bir .bat dosyasında her % ikiye katlanmalıdır — %%(title)s — yoksa toplu iş yorumlayıcısı şablonu yt-dlp görmeden yer. Bir .bat indirdiğinizde üretici bunu sizin için yapar.
Gerçekten karşılaşacağınız hatalar
ffmpeg not found
Birleştiren, dönüştüren, gömen ya da kesen her şey PATH içinde ffmpeg ister. Kurun, sonra ffmpeg -version ile doğrulayın.
Sign in to confirm you are not a bot
Önce --impersonate chrome, sonra --cookies-from-browser deneyin. İkisi de olmazsa yt-dlp’yi güncelleyin — özellikle bu denetim sık değişir ve düzeltmesi genelde birkaç gün içinde bir sürümle gelir.
Unable to extract player response
Neredeyse her zaman eskimiş bir yt-dlp’dir. Başka bir şeye dokunmadan önce güncelleyin: yt-dlp -U, ya da öyle kurduysanız paket yöneticiniz.
Requested format is not available
Seçiciniz hiçbir şeyle eşleşmedi. Nelerin var olduğunu görmek için -F çalıştırın ve katı bir süzgeç yerine sıralamayı (-S) yeğleyin ki her zaman bir yedek kalsın.
HTTP Error 403
O adres başka bir oturum ya da başka bir bölge için imzalanmıştı. Taze çerezlerle yeniden çalıştırın, --impersonate chrome ekleyin ya da --geo-bypass deneyin.
yt-dlp’yi güncel tutmak
Bildirilen sorunların düzelmesini sağlayan şey, herhangi bir bayraktan çok güncellemedir. Bağımsız çalıştırılabilir dosyayı kurduysanız:
yt-dlp -U
Bir paket yöneticisiyle kurduysanız, kurduğunuz yoldan güncelleyin — -U reddedecektir ve haklıdır.