İçeriğe geç
TR
API anahtarı al
Belgeleri incele

Kılavuzlar

Günlük işler için yt-dlp komutları

Video, ses, altyazı, veri kümeleri ve koleksiyona devam etmek için komutları kopyalayın.

Bu sayfada

Kurulum ve Komut Sözleşmeleri

Gece ve tam bağımlılıklardan başlayın
python -m pip install -U --pre "yt-dlp[default,curl-cffi]"
deno --version
ffmpeg -version
python -m yt_dlp --list-impersonate-targets

İndirme tarifleri Deno ve --impersonate="" temel çizgisi olarak kullanır. Bu, curl-cffi gerektirir ve mevcut bir tarayıcı parmak izi seçmesine izin verir. Linux/macOS komutlar Bash sintax kullanır; bir planlı işçi için, bu bağımlılıkları da bu hizmet ortamında kullanılabilir hale getirmek.

Bu terminal örnekleri Python yüklemeyi kullanır yt-dlp. Python'u sanal ortamınızda kullanın veya Python -m yt_dlp'yi yalnız yt-dlp komutuyla değiştirin. İlk olarak, kurulum kılavuzunda macOS ve Windows alternatifleri ile Linux kullanın. Birleşmek için FFmpeg/ffprobe yükleme ve YouTube meydan okuması çözmek için Deno. Örnek URL'yi kaynağınızla değiştirin.

KonvansiyonNeden önemli
URL ve ŞablonlarıŞelalesi, & gibi karakterleri, alanları ve parantezileri yorumlar.
%(ext)s filenamalarında tutunSeçilen medya ve post-processing uzantıyı belirler.
--no-playlist bir saat URL için kullanınBir oynatma listesinden bağlantılı bir video beklenmedik bir şekilde işinizi genişletmemelidir.
Kurtarılan yapılandırmanızı kontrol edinÖrnekler küresel bir konfig'e miras kalabilir. izolasyon test için --ignore-config kullanın.
Windows .bat: çift şablon yüzde işaretleri%(id)s'i bir paket dosyasında kullanın, %(id)s ise etkileşimli PowerShell ve normal yapılandırma dosyalarında kullanın.

Video kalitesi ve MP4

Baseline: en son gece, Deno ve FFmpeg, ile --impersonate="". reçeteler Bash kullanır; örnek URL kaynağı ile değiştirin.

Bir video indirmek için varsayılan seçeneklerle
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist -P downloads \
  -o "%(id)s.%(ext)s" "https://www.youtube.com/watch?v=jNQXAC9IVRw"
yt-dlp default kullanılarak mevcut akışları seçin. konteyner mutlaka MP4 değildir.
Mevcut formatı listesi
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  -F "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Kodekleri ve audio-only/video-only satırlarını kontrol edin. Numerik format kimlikleri taşınabilir çıkış politikaları değildir.
Daha çok tercih 1080p
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist -S "res:1080" \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Bir tercih: Hedef üzerinde veya altındaki herhangi bir biçim mevcut değilse, sınıflandırma üstünde birini seçebilir.
En fazla 1080p tutarını uygulayın
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  -f "bv*[height<=1080]+ba/b[height<=1080]" "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Filtre: Format eşleşmediğinde başarısız olur. kaynak kodek seçeneğini tutar.
H.264 video ve AAC ses MP4
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  -f "bv[vcodec^=avc1][height<=1080]+ba[acodec^=mp4a]/b[vcodec^=avc1][acodec^=mp4a][height<=1080]" \
  --merge-output-format mp4 "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Sıkı kodek seçimi. eşleşen biçimleri ve ayrı akım birleştirme için FFmpeg gerektirir.

AI veri kümesi: MP4 + kapsiyonlar + metadata

En İyi Video + Ses, MP4, Kapsalar ve Metadata
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  -f "bestvideo+bestaudio/best" --merge-output-format mp4 --remux-video mp4 \
  --write-info-json --write-subs --write-auto-subs --sub-langs "en" --sub-format "vtt/best" \
  --sleep-subtitles 5 --concurrent-fragments 1 -P dataset -o "%(id)s/%(id)s.%(ext)s" \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
FFmpeg kaynak akışları birleştirir. MP4 kaynak kodeklerini tutar; dekoder uyumluluğunu kontrol eder ve ayrı olarak etiket kapsama.

Dış indirme: aria2c

İki bağlantı, yerli DASH/HLS
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist --downloader aria2c \
  --downloader "dash,m3u8:native" --downloader-args "aria2c:-x 2 -s 2 -j 1" \
  --concurrent-fragments 1 -P downloads "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Потрібен виконуваний файл aria2c. Спочатку перевірте завантаження одного відео, а тоді збільшуйте кількість з’єднань. У разі помилки 403 негайно зменште їх кількість.

aria2 kendi ağ uygulaması vardır. yt-dlp'nin curl-cffi impersonalasyonu aria2'nin parmak izini ayarlamaz. Sadece dış indirmeyi başarısız hale getirirseniz, --downloader yerli kullanın ve aynı kaynağı ve proxy yolu karşılaştırın.

Ses ve MP3

Orijinal ses akışını kaydedin
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist -f ba -P audio \
  -o "%(id)s.%(ext)s" "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Hiçbir MP3 dönüştürme. Transcription veya playback pipeline orijinal kodek kabul ettiğinde yararlıdır.
Hedef bitrate ile MP3 dönüştürülür
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist -f ba -x \
  --audio-format mp3 --audio-quality 192K -P audio \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
FFmpeg kullanır. 192K çıkış kodlaması kontrol eder; kaynak kalitesini geri getirmez.
M4A'yı tercih edersiniz
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist -f "ba[ext=m4a]" -P audio \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Sadece M4A sesli biçim kullanılamazsa başarısız olur. /ba eklemek yalnızca uygulamanız diğer kaynak konteynerlerini kabul ederse.
MP3 yerleşik metadata ve kapak ile
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist -f ba -x \
  --audio-format mp3 --embed-metadata --embed-thumbnail -P audio \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
metadata/thumbnail adımları ek işlem sonrası. son dosyayı kontrol edin, sadece transfer hoke değil.

Kapsül ve alt başlıklar

Mevcut yollar listesi
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  --list-subs "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Bu kaynağın sunduğu dil etiketlerini seçmeden önce okuyun --sub-langs.
Sadece İngilizce alt başlıkları indirmek
python -m yt_dlp --js-runtimes deno --impersonate="" --skip-download --write-subs \
  --sub-langs "en.*" --sub-format "vtt/best" -P captions -o "%(id)s.%(ext)s" \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Otomatik çekimlere geri dönmez ve medyayı indirmez.
Ayrıca otomatik İngilizce kaplamaları da sağlanmaktadır.
python -m yt_dlp --js-runtimes deno --impersonate="" --skip-download --write-subs \
  --write-auto-subs --sub-langs "en.*" --sub-format "vtt/best" -P captions \
  -o "%(id)s.%(ext)s" "https://www.youtube.com/watch?v=jNQXAC9IVRw"
en.* çok sayıda İngilizce varyantı eşleşebilir. bu mevcut izleri alır; konuşma tanıma çalıştırmaz.
Seçilen yolları SRT olarak dönüştürün
python -m yt_dlp --js-runtimes deno --impersonate="" --skip-download --write-subs \
  --write-auto-subs --sub-langs "en" --convert-subs srt -P captions \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
İhtiyaçlar FFmpeg Başka bir dil kodu --list-subs seçin.
Bu bölümde yer alan bölümler MKV
python -m yt_dlp --js-runtimes deno --impersonate="" --write-subs --sub-langs "en" \
  --embed-subs --remux-video mkv -P downloads "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Medya indirmesi, İngilizce alt başlıkları sağlanan talepler ve mevcut yolu içerir.

Tüm yazı dilini talep etmek, taleplerin ve dosyaların sayısını önemli ölçüde arttırabilir. Rutin çalışma için dilini açıkça tutun. Kaynak kimliğini ve dilini veri kümesi listesinde saklayın, böylece transcriptler açıkladıkları medyadan ayrılmamalıdır.

Metadata ve çıkış yolları

Video metadata baskı JSON olarak yazdırılır.
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  --dump-json "https://www.youtube.com/watch?v=jNQXAC9IVRw" > video.json
İndirimleri varsayılan olarak simüle eder, ancak çıkarma yapar. yönlendirme video.json yerine geçer.
Media olmadan tam metadata sayfa çubuğu yazın
python -m yt_dlp --js-runtimes deno --impersonate="" --skip-download --write-info-json \
  -P metadata -o "%(id)s.%(ext)s" "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Bir .info.json yan çubuğu oluşturur. bu operasyonel çıkarıcı verileridir; proje alanları, bunu kamuya açık hale getirmeden önce.
Sadece miniatürü indirin
python -m yt_dlp --js-runtimes deno --impersonate="" --skip-download --write-thumbnail \
  -P thumbnails -o "%(id)s.%(ext)s" "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Kullanılabilir miniatürü kaynak biçiminde kaydeder. --convert-thumbnails jpg JPEG gerektirdiğinde bir dönüşüm adımını eklenir.
Son medya yolu işleme sonra yazdırın
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  --print after_move:filepath -P downloads -o "%(id)s.%(ext)s" \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Bir varsayılan aşamadan farklı olarak --print, bir after_move baskı gerçek bir indirme ve nihai hareket için bekler.
Manifest için tamamlanmış yolları eklemek
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  --print-to-file after_move:filepath completed-paths.txt -P downloads \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Ekler, böylece geri çekilme tekrarlanan girişler üretebilir. tamamlama logu olarak ele alın, deduplikat bir kayıt değil.

Zaman ve bölümler

İndir sekiz 5 üzerinden 10
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  --download-sections "*00:00:05-00:00:10" -o "clips/%(id)s-%(section_start)s.%(ext)s" \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Gereksinimler FFmpeg. Bir klip sınırı mevcut anahtar çerçevelerle uyum sağlayabilir; doğru zamanlama sorunu olduğunda çıkışını doğrulayın.
İsteyen kesimler etrafında yeniden kodlama
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  --download-sections "*00:00:05-00:00:10" --force-keyframes-at-cuts \
  -o "clips/%(id)s-%(section_start)s.%(ext)s" "https://www.youtube.com/watch?v=jNQXAC9IVRw"
İsteyen sınırlarda kesmeyi iyileştirmek için yeniden kodlama çalışmasını eklemek. sonuçlanan süreyi ve audio/video uyumunu kontrol edin.
Bir videoyu dosyaya bölün
python -m yt_dlp --split-chapters -o "chapter:%(id)s-%(section_number)03d.%(ext)s" \
  "https://www.youtube.com/watch?v=YOUR_VIDEO_ID"
Başlık metadata ile bir video kullanın. başlık çıkışları orijinal tam indirme ile ayrıdır; her ikisi için de bütçe disk alanı.

Klipler ve tam videolar için farklı bir çıkış politikası veya arşiv kullanın. kaynak düzeyindeki bir arşiv girişinin seçilen start/end zamanları kodlamaması, böylece bir paylaşım arşivi oluşturmak istediğiniz bir sonraki klibi silebilir.

Playlist ve URL listeleri

Bilinen URL listesini indirin
python -m yt_dlp --no-playlist --batch-file urls.txt -P collection -o "%(id)s.%(ext)s"
Bir satır başına bir URL'yi izleyen bir UTF-8 dosyasını oluşturun. --no-playlist oynatma listesi bağlamını içeren URL'leri izlemek için geçerlidir.
YouTube oynatma listesini tam video çekimi olmadan kontrol edin
python -m yt_dlp --flat-playlist \
  --dump-json "https://www.youtube.com/playlist?list=YOUR_PLAYLIST_ID" > playlist.jsonl
1 JSON nesne giriş başına. düz girişler süresi ve biçim ayrıntıları kaçırılabilir.
İlk 5 oyun listesi girişini indirin
python -m yt_dlp --playlist-items 1:5 -P collection -o "%(playlist_index)03d-%(id)s.%(ext)s" \
  "https://www.youtube.com/playlist?list=YOUR_PLAYLIST_ID"
Oyunun listesi göstergeleri sırası değil kimlik gösterir. video ID'yi dosya adı içinde tutun.
Tarih ve Süreçle Uygun Videoları Sınırlandırın
python -m yt_dlp --dateafter 20260101 --match-filters "!is_live & duration <= 1800" \
  --batch-file urls.txt
Bilinen süreye kadar 30 dakikalar, Ocak ayında veya sonrasında tarih 1, 2026. filtre hala video istekleri gerekebilir.
10 yeni indirme sonrası durun
python -m yt_dlp --download-archive archive.txt --max-downloads 10 --batch-file urls.txt
Sınır yeni indirilmiş dosyaları kontrol eder, kaç listing/extraction isteği meydana gelmez.

Arşiv ve kurtarma

Aynı politikaya sahip bir koleksiyonu yeniden oluşturun
python -m yt_dlp --download-archive archive.txt --continue --no-abort-on-error -P collection \
  -o "%(id)s.%(ext)s" --batch-file urls.txt
Tamamlanmış kimlikler kaybolur. kısmi indirme desteklenen yerlerde yeniden kaybolur. orijinal iş ile aynı arşiv ve çıkış yollarını kullanın.
Bir işçi barış ve emekliliklerini bağlayın
python -m yt_dlp --sleep-requests 1 --sleep-interval 5 --max-sleep-interval 10 --retries 3 \
  --fragment-retries 3 --socket-timeout 30 --batch-file urls.txt
Bu süreç ayarlarıdır. bir yol veya oturum paylaştığında bir kuve düzeyinde bir işçi sınırı ekleyin.
Kap Transferi Bandwidth
python -m yt_dlp --js-runtimes deno --impersonate="" --limit-rate 2M \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Medya transfer hızı kontrol eder. çıkarma taleplerinin sayısını düzenlemez.
Native Fragment Rekabetini Azaltmak
python -m yt_dlp --js-runtimes deno --impersonate="" --concurrent-fragments 1 \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Araştırma sırasında bir parçadan başlayın 403s Diğer işçi süreçleri hala kendi eşdeğer taleplerini ekler.

Konfigürasyon ve Filename

Sadece açık koleksiyonunuzu konfig yükleme
python -m yt_dlp --ignore-config --config-locations yt-dlp-work.conf --batch-file urls.txt
Açıklanan konfig bile --ignore-config ile yüklenir. programlı işler için tam yollar kullanın.
istikrarlı kimlik ile okunabilir isimler
python -m yt_dlp --js-runtimes deno --impersonate="" -P downloads \
  -o "%(channel_id)s/%(upload_date)s-%(title).150B [%(id)s].%(ext)s" \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Bu şablonda 150 byte olarak adlandırılır. ID'ler çoğaltılmış veya değişen başlıkları ayırt eder.
ayrı bir geçici dizin kullanın
python -m yt_dlp --js-runtimes deno --impersonate="" -P "home:downloads" -P "temp:work" \
  -o "%(id)s.%(ext)s" "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Son hareket işleme sonra gerçekleşir. her iki dizin de yeterli alanı vardır; farklı dosya sistemleri bir kopya gerekebilir.

Uzun ömürlü koleksiyonlar için, filenamaların insan okunabilir veya istikrarlı uygulama anahtarları olup olmadığına karar verin. Kanal isimleri ve başlıkları değişebilir. Channel/video Kimlikler, metadata saklanan açıklayıcı alanlarla deduplikasyon için daha iyi anahtarlardır.

Çerezler ve Runtime yolları

erişimi olan tarayıcı profili kullanın
python -m yt_dlp --js-runtimes deno --impersonate="" \
  --cookies-from-browser "chrome:Profile 1" \
  --no-playlist "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Profile 1'yi gerçek tarayıcı profili ile değiştirin. oturum çerezlerini yalnızca gerektiğinde kullanın ve bunları gizli tutun.
Mevcut özel cookie dosyasını okuyun
python -m yt_dlp --js-runtimes deno --impersonate="" --cookies private/youtube-cookies.txt \
  --no-playlist "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Netscape cookie dosya biçimi gerektirir. bir JSON ihracatı eşdeğer değildir.
İşçi PATH dışında yürütülebilir bir Deno kullanın
python -m yt_dlp --js-runtimes "deno:/opt/deno/bin/deno" --impersonate="" \
  --no-playlist "https://www.youtube.com/watch?v=jNQXAC9IVRw"
İşçiniz için yüklü Deno binary ile yolu değiştirin.

Diagnostik ve doğrulama

Temiz bir ekstraksiyonu kontrol edin
python -m yt_dlp --js-runtimes deno --impersonate="" --ignore-config --verbose --simulate \
  --no-playlist "https://www.youtube.com/watch?v=jNQXAC9IVRw"
İllimsel konfig kaldırır ve hiçbir medya kaydeder. hala çıkarma talepleri yapar ve bir transferin başarılı olacağını kanıtlamaz.
Özel Diagnostik Log Almak
python -m yt_dlp --js-runtimes deno --impersonate="" --ignore-config --verbose --simulate \
  --no-playlist "https://www.youtube.com/watch?v=jNQXAC9IVRw" > diagnostic.log 2>&1
Yönlendirme, log'u değiştirir. cookie/header değerlerini, proxy kimliklerini ve paylaşmadan önce imzalanan URL'leri düzenleyin.
- Kaynaklar ve süresi kontrol etmek
ffprobe -v error -show_entries format=duration,size:stream=codec_type,codec_name,width,height -of json "YOUR_OUTPUT_FILE"
İşleme sonrası son yolu kullanın. ffprobe başlıkları okuyor; her çerçeveyi dekore etmiyor.
Kaydetilen dosyayı kaydetmeden çıkış oluşturma
ffmpeg -v error -i "YOUR_OUTPUT_FILE" -f null -
Tüm dosyayı okuyan daha derin bir kontrol. çıkış durumu ve mesajları kontrol edin.
Python paketini güncelleyin ve versiyonunu kontrol edin
python -m pip install -U --pre "yt-dlp[default,curl-cffi]"
python -m yt_dlp --version