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

Kılavuzlar

yt-dlp nasıl kullanılır?

Nightly sürümünü kurma, biçim seçimi, altyazılar, veri kümeleri ve koleksiyonları sürdürme konularını kapsayan Linux odaklı indirme rehberi.

Bu sayfada

Günlük kullanım bazeline kurun

Gece + Deno + FFmpeg ile başlatın. Bir proje sanal ortamını kullanın ve tarayıcı kişiselleştirme etkinleştirin --impersonate="". Aşağıdaki Linux ayarları araçları yüklüyor; macOS ve Windows alternatifleri sekmelerde yer alıyor.

Ubuntu / Debian örneği Python 3.11+ ile. sistem araçları yüklemek, bir proje sanal ortam oluşturmak, sonra mevcut gece ve ekler yüklemek. Deno'nun yükleri çalıştırın aynı kullanıcı olarak işçinin sahip olduğu.

Linux İşçi Yükleme
sudo apt-get update
sudo apt-get install -y python3 python3-venv ffmpeg aria2 curl unzip
python3 -m venv .venv
source .venv/bin/activate
python -m pip install -U --pre "yt-dlp[default,curl-cffi]"
curl -fsSL https://deno.land/install.sh -o /tmp/install-deno.sh
sh /tmp/install-deno.sh
export PATH="$HOME/.deno/bin:$PATH"
deno --version
python -m yt_dlp --version
Tool Tool ToolNe yapıyorKontrol
Python 3.11+Bu seride Python paketini ve örneklerini çalıştırır.python --version
Son yt-dlp gece + varsayılan,curl-cffi eklerYouTube'un mevcut ekstraktörü, EJS çözücü ve tarayıcı impersonalasyon desteği ile eşleşir.python -m yt_dlp --version
FFmpeg ve ffprobeAkışları birleştirin, ses değiştirin, klipleri kesin ve kaydedilen medyayı kontrol edin.ffmpeg -version / ffprobe -version
Deno 2.3+ (bu çalışma akışında gerekli)YouTube'un zorluklarını yürütür. her işçi üzerinde yükleme, sadece geliştirme makinesi değil.deno --version

İçeriler de yükleme. [default] EJS yazılarını sağlar; Deno ayrıdır. FFmpeg ve ffprobe aynı zamanda işçinin PATH'sinde olmalıdır.

Baseline'nin tamamını kontrol edin
deno --version
ffmpeg -version
ffprobe -version
python -m pip show yt-dlp yt-dlp-ejs curl-cffi
python -m yt_dlp --list-impersonate-targets
Son komut mevcut tarayıcı hedeflerini listelemeye gerekmektedir. hedefler mevcut değilse, curl-cffi bu tam sanal ortamda yüklendiğinden emin olun.
Deno ve tarayıcı impersonalasyonu ile test ekstraksiyonu
python -m yt_dlp --ignore-config --js-runtimes deno --impersonate="" --verbose \
  --simulate "https://www.youtube.com/watch?v=jNQXAC9IVRw"
JS koşu zamanlarını ve talep-handler hatlarını kontrol edin. bir simülasyon çekim testi; gerçek bir transfer ile takip edin.

FlashData'nın çalışma tabanı --impersonate=" içerir: curl-cffi mevcut bir tarayıcı parmak izi seçmesine izin verir. Bu, isteğin parmak izini değiştirir; giriş çerezleri vermez, JavaScript zorluklarını çözmez veya çıkış IP'si değiştirmez. Bu seçenek bir çalışma yolu yavaşlarsa veya hatalar girerse, aynı tek video testi olmadan tekrarlayın ve çalışma yapılandırmasını tutun.

Bir işçi üzerinde koymadan önce serbest bırakma kontrol edin

Resmi projenin yayın sayfasında yürütücüler alın veya yayınlanan paket kaynağından Python paketini yükleme. Bir tek bir binary indirmek istiyorsanız, SHA-256 ile bu sürüm SHA2-256SUMS eşleşen fil adı ile karşılaştırın. Serbest bırakma ve kontrolü işçinizin görüntüsü ile kaydedin, böylece tam olarak neyi çalıştığını belirleyebilirsiniz.

Download dosyası için hash
sha256sum yt-dlp

Bir kontrol miktarı karşılaştırması sadece beklenen değeri güvenilir bir serbest bırakma, aynı bilinmeyen ayna değil, gerçekleştirilebilir olduğunda yararlıdır. Güvenlik yazılımı bir dosyayı bayraklıyorsa, bir istisna yapmadan önce kaynağını ve raporunu araştırın. Açık kaynaklı kullanılabilirlik yalnızca her indirilmiş ikili veya üçüncü taraf eklenti güvenli olduğunu kanıtlamaz.

Paylaşılan yapılandırma dosyalarını incelemek için kod olarak ele alın: --exec gibi seçenekler komutları başlatabilir ve eklentiler indirme sürecine kod ekleyebilir. tarayıcı çerezleri, proxy kimlikleri ve imzalanan URL'leri yapılandırma örneklerinden ve teşhis raporlarından çıkarın.

1 video indirmek

İlk olarak kısa bir video kullanın. URL'yi alın, --no-playlist ekleyin ve dosyayı video ID ile adlandırın.

1 video, 1 çıkış klasörü
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist -P downloads \
  -o "%(id)s.%(ext)s" --print after_move:filepath \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Yazdırılan yol, birleşme ve post-processing sonrası dosyadır. bu yolu açın; dosyanın .mp4'te sona ereceğini varsaymayın.

Bir format aşırı olması olmadan, yt-dlp tercih edilen mevcut akışları seçer. Yüksek kaliteli kaynaklar genellikle ayrı video ve ses akışları vardır, bu nedenle FFmpeg birleşme ile takip edilen iki transfer normaldir. Orta dosyalar ve bir .part dosyası iş çalıştığında görünebilir.

Kaliteli ve kodek seçimi

Bu video formatlarını kontrol edin
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  -F "https://www.youtube.com/watch?v=jNQXAC9IVRw"

Bir politikayı seçin, kopyalanmış bir format kimliği değil. Çözünürlüğünü, kodekleri ve ayrı audio/video izlerini kontrol edin.

Seçici veya seçenekAnlam AnlamıNe zaman kullanmalı
Bv + BvSadece bir video akışı ve bir ses akışı seçin; FFmpeg bunları birleştirin.Her iki yoldan da ihtiyacınız var ve yerel olarak birleştirebilirsiniz.
A/BA seçeneğini deneyin, A kullanılamazsa B seçeneğini deneyin.Her kaynağın aynı biçimlere sahip olduğunu varsaymak yerine açık bir düşüşü tanımlayın.
[height<=1080]1080 piksel yükseklikten fazla akışları hariç tutun.Yüksek bir yük, bir gerekliliktir.
-S res:10801080 kadar çözünürlüklü tercih; aşağıdaki hiçbiri mevcut olmadığında daha büyük birini seçebilirsiniz.1080p bir çatıdan ziyade bir tercihtir.
--merge-output-format mp4Konteyner seçin ayrı akımları birleştirirken.Daha önce uyumlu akışları seçtiğiniz. transkod kodları yapmıyor.
Kaynak kodeklerini, sert bir çatı ile tutun 1080p
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  -f "bv*[height<=1080]+ba/b[height<=1080]" -P downloads \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Bu WebM, MP4 veya başka bir destekli konteyner üretebilir. hiçbir biçim çatıya ulaşmazsa başarısız olur; sessizce indirmez 4K.

H.264 video ve AAC ses gerektiren bir editör veya oynatma çubuğu için, bu kodekleri filtreleyin ve MP4'ye birleşin. MP4 bir konteyner: bir konteyner MP4 içindeki bir akım hala bir kodek içerebilir ve uygulamanız dekore edemez.

H.264 + AAC, 1080p'ye kadar
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 -P downloads "https://www.youtube.com/watch?v=jNQXAC9IVRw"
İhtiyaç duyulan kodekler mevcut değilse, bu sıkı seçici başarısız olur. farklı kaynak kodekleri veya transkodları kabul etmeye karar verin; gerekliliği kaza yoluyla kaldırmayın.

Remuxing, akışları yeniden kodlamadan yeniden paketler. Transkodlama kodekleri değiştirir ve CPU'yu tüketir ve aynı zamanda potansiyel olarak kaliteyi değiştirir. Akışlar zaten hedef konteynerine uygun olduğunda --remux-video kullanın; bir düşük akışlı dekoder farklı kodekler gerektirdiğinde kasıtlı bir FFmpeg dönüşüm kullanın.

Ses kaydetme veya MP3

Transcription pipeline kaynağı ses kodek kabul ederse, bu doğrudan aktar. Bu, gereksiz kayıp dönüşümünü önler. MP3 bir tüketici tarafından belirli bir şekilde talep edildiğinde yararlıdır; yüksek MP3 bitrate kaynağında zaten kaybolan ayrıntıları geri getiremez.

En iyi ses akışı tutun
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"
Kaynak konteynerini ve kodeklerini bekleyin, genellikle M4A/AAC veya WebM/Opus.
Sesin MP3 olarak dönüştürülmesi
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist -f ba -x \
  --audio-format mp3 --audio-quality 0 -P audio -o "%(id)s.%(ext)s" \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
FFmpeg gerektirir. --audio-quality 0 en iyi değişken kalitesi ayarını seçer; aşağı akış özelliklerinizin birini gerektirdiğinde 192K gibi bir bit hızı kullanın.

Captions ve Metadata'yı Kaydet

Faydalı bir koleksiyon filenamelerden daha fazlasını gerektirir. Video ID'leri, kaynak URL'leri, başlıkları, süresi ve mevcut kapakları saklayın, böylece koleksiyonu arama yapabilir ve bir varlığın kaynağına geri dönmesini sağlayabilirsiniz. Başlangıçta, etiket izlerini listelemek; en istemek her video İngilizce bir izi içerdiği anlamına gelmez.

Kapakları kontrol edin, sonra medya olmadan İngilizce izleri kaydedin
python -m yt_dlp --list-subs "https://www.youtube.com/watch?v=jNQXAC9IVRw"
python -m yt_dlp --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"
--write-subs sağlanan alt başlıkları seçer; --write-auto-subs aynı zamanda otomatik çekimlere izin verir. bu mevcut izleri geri alır ve hiçbir videoya sahip olmayan bir videoyu geçmez.
Metadata ve bir miniatür ile medya
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist --write-info-json \
  --write-thumbnail -P downloads -o "%(id)s.%(ext)s" \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"

.info.json dosyası ayrıntılı bir işletim metadata, temiz bir kamu API cevabı değil. Bu, geçmiş medya URL'leri ve talep ile ilgili alanları içerebilir. Toplam yan çubuğu ile tutun ve sadece aşağı akış sistem ihtiyacınız olan alanları ihraç edin. VTT yerine SRT'ye ihtiyacınız varsa --convert-subs srt ekleyin ve FFmpeg'in mevcut olduğundan emin olun.

Bir AI veri kümesi öğesi oluşturun

Bir eğitim koleksiyonu için, medya ve metin çıkışları bir araya getirmek. Bir ortak gereksinim, en iyi mevcut video ve ses, MP4 birleştirilmiş, zamanlı çekim ve ekstraksiyon metadata aynı video ID altında tutulan. Önizlemeler için yararlı bir çözünürlük çatı genellikle kaynak kalitesi veri kümesi için yanlış varsayımdır.

1 adet tam veri set öğesi indirin
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" \
  --print after_move:filepath "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Örnek Bash. FFmpeg ayrı akımları birleştirir; --remux-video ayrıca bir kombine akım düşüşünü de kapsar. --list-subs'den doğru bir dil etiketini kullanın; veri kümesi ihtiyaçlarınızın diliyle en değiştirin.

Başlangıçta doğru bir yazı diliyle başlayın. Canlı kontrolümüzde, en.* en, en-en ve en-de seçildi; üçüncü yol 429 geri döndü, medya indirme başlamadan önce. Bir yazı hatası, öğeyi bu aşamada durdurabilir. Bir soğutma sonrasında, sadece gerekli yolu geri çekmek, ya da medya ve not işleri bölünürse koleksiyonu medya içeriği hareket ettirmek zorunda kalır.

/best fallback, ayrı yollar mevcut olmadığında kombine bir video/audio akışına izin verir. Toplama sözleşmeniz ayrı bestvideo ve bestaudio kaynakları gerektirirse bu düşüşü kaldırın. MP4 anlamına gelmez H.264: bu reçete seçilen kaynak kodeklerini tutar. Yukarıdaki sıkı H.264/AAC seçiciyi kullanın, eğitim dekoderiniz bu kodekleri veya ayrı, kaydedilmiş bir adım olarak transkod gerektirirse.

İngilizce bir işaret yolu varsa beklenen dosyalar
dataset/VIDEO_ID/
  VIDEO_ID.mp4
  VIDEO_ID.info.json
  VIDEO_ID.en.vtt
Not defteri, istediğiniz yoldan ulaşılamadığında hiçbir not dosyası oluşturulmaz; metin kapaklarını tamamlamayı işaretlemeyin sadece MP4 bittiği için.
GereklilikKoleksiyon Kararı
En yüksek kaynak kalitesiBestvideo+bestaudio kullanın, kaynak kodeklerini tutun ve ffprobe ile birleşik akışları doğrulayın.
Zamanlı YazıVTT/SRT segmentleri ve dilini video ID'nin yanında tutun. düzleştirme metni, kliplerin düzeltilmesi için gerekli zamanlamayı gösterir.
Altyazılar eksikEksik metni açıkça kaydedin. yazının zorunlu olması durumunda kaydedilen sesin transcription aşamasına yönlendirilmesi.
Birçok dil için kaptanlarHer ek iz istekleri ekler ve medyadan bağımsız olarak 429 ile karşılaşabilir.
Resumable Media + Metin TeslimatıAyrı bir veri kümesi arşivi ve medya, metadata ve yazı statüleri ile bir inventori kullanın. bir arşiv giriş tüm gerekli sayfa çubukları var olduğunu kanıtlamaz.

Bu yeni politika için yalnızca çalışan bir önceki medya tarafından oluşturulan bir arşiv yeniden kullanmayın: arşivlenmiş videolar kayıp çekimleri toplanacak önce kaybolabilir. Ya kendi arşiviyle veri set politikalarını çalıştırın ya da eksik metin kimlikleri için ayrı bir yazı onarım geçişini planlayın. Orijinal kapakları kaydet; modelinizin temiz bir transcript metni ihtiyacı varsa, versiyonlandırılmış bir işleme adımında elde edin.

IP'yi aşmadan transfer geçişini iyileştirin

aria2c tek bir bağlantı güvenilmez veya yüksek yavaşlık bağlantıyı altında olduğunda yardımcı olabilir. reddedilen bir oyuncu isteği veya bir çıkış IP'si düzeltemez. İlk olarak, yerli indirme cihazı tek bir kaynaktan çalıştırın; daha sonra transfer süresini ve hataları küçük bir sayıda aria2 bağlantı ile karşılaştırın.

2 bağlantı ile başlatın HTTP transfer için
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 -o "%(id)s.%(ext)s" "https://www.youtube.com/watch?v=jNQXAC9IVRw"
İlk olarak aria2 yükleme. DASH/HLS burada yerli indirme ile tutun, böylece segment rekabet açık kalır.
KontrolüNe sınırlı
aria2c -x 2Bir indirme için bir sunucuda bağlantı kurun.
aria2c -s 2Bir dosya için istenen bölünmeler; bölünme ayrıca dosya boyutuna ve sunucunun desteğine bağlıdır.
aria2c -j 1Bu aria2 çağrısı içindeki eşdeğer öğeler, diğer yt-dlp işçiler değil.
--concurrent-fragments 1Fragment indirme içindeki yerli DASH/HLS indirme.
İşin ÇiçeğiToplam aktif videolar aynı ev sahibi veya proxy çıkış IP paylaşır.

curl-cffi impersonalasyon yt-dlp'nin kendi isteğine aittir; aria2'in TLS parmak izini ayarlamaz. Eğer yerli indirme çalışıyor ama aria2 alır 403, değiştirmeden önce yerli geri dönmek için bağımsız ekstrakt ayarları. Ekstraksiyon ve dış transferleri aynı proxy oturumunda tutun.

FlashData'nın işleyişinde, rekabet yükseltme çok saldırgan bir şekilde bir çalışma yolu hemen geri dönmeye başlar 403. Eğer böyle bir şey olursa, diğer işleri durdurun, bir işçi ve bir bağlantıya geri dönün, sonra yeniden test edin. Daha fazla aria2 bölünme ekleyerek veya aynı reddedilen akışın paralel olarak geri çekilmesiyle telafi etmeyin. Bu IP düşük yükte reddedilirse, 403 IP-yedek çalışma akışını kullanın.

Karşılaştırma için muhafazakar yerli transfer
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  --downloader native --concurrent-fragments 1 --limit-rate 2M \
  --sleep-requests 2 --sleep-interval 5 --max-sleep-interval 10 \
  -P diagnostics "https://www.youtube.com/watch?v=jNQXAC9IVRw"
2M bir tanı bant genişliği kapak, bir evrensel YouTube sınırı değil. artış geçiş yavaş yavaş sadece yol çalıştıktan sonra.

Koleksiyonu hazırlayın

Küçük bir bilinen set için, satır başına bir URL ile bir UTF-8 urls.txt oluşturun. Bir YouTube oynatma listesi için, öncelikle kimliklerini bir manifesto içine listelenin. Düz çekim, her video için tam bir çekim yapmadan oynatma listesini inceler; kapsam incelemesi için yararlıdır, ancak girişleri uzunluk, biçimler ve kullanılabilirlik ayrıntıları eksik olabilir.

YouTube Playlist Manifesto oluşturun
python -m yt_dlp --flat-playlist --print "https://www.youtube.com/watch?v=%(id)s" \
  "https://www.youtube.com/playlist?list=YOUR_PLAYLIST_ID" > urls.txt
YOUR_PLAYLIST_ID değiştirin. medya transferini başlatmadan önce urls.txt kontrol edin. yeniden yönlendirme, yeniden çalıştırıldığında bu manifestoyi değiştirir.

Bir koleksiyonu denemek için, --playlist-items 1 ile oynatma listesi girişlerini seçin: 5. Bir kanalın /video sekmesi, yüklenen videolar için daha net bir başlangıç noktasıdır. Oyunun listesi siparişini kimlik olarak görmeyin: öğeler yerleştirilebilir, yeniden sipariş edilebilir veya kaldırılabilir.

FiltreKullanımSonuçlar
--playlist-items 1:5Şu anki listede ilk beş giriş.Küçük bir deneme için yararlı, kalıcı bir kontrol noktası değil.
--dateafter 202601011 Ocak 2026 tarihinden sonra veya tarihinden sonra kayıtları tutun.Tarih filtreleme hala per-video çıkarma gerekebilir.
--match-filters "!is_live & duration <= 1800"Bilinen bir süre ile canlı olmayan bir öğe gerektirir en fazla 30 dakika.Bilinmeyen süreye sahip girişler bu sıkı filtre ile uyumlu değildir.
--download-archive archive.txtKaynak kimliklerini kaydetmek, önceki indirme ile zaten kaydedilmiştir.Değişen başlıklar ve playlist pozisyonları üzerinde çalışıyor.

Koleksiyonu güvenli bir şekilde yeniden oluşturun

Bu, urls.txt ile birlikte toplama klasörünüzde yt-dlp-work.conf olarak aşağıdaki şeyi kaydedin. Bir kez çıkış politikası tanımlar, koleksiyonun kendi arşivini verir ve geri çekilme sınırlamaları sağlar. Çıkış dosyalarını ve bu arşivi bir araya getirin: bir arşiv, mevcut dosyanın kontrol sayısı veya konumu değil, çıkarıcı ve kimlik tarafından başarı kaydedilir.

yt-dlp-work.conf
# YouTube worker baseline
--js-runtimes deno
--impersonate=""
--concurrent-fragments 1

# Output policy
--no-playlist
-f "bv*[height<=1080]+ba/b[height<=1080]"
-P downloads
-o "%(channel_id)s/%(id)s.%(ext)s"
--write-info-json

# Resume and remember completed media
--continue
--download-archive archive.txt
--no-abort-on-error

# Bound each attempt and spread out work
--retries 5
--fragment-retries 5
--socket-timeout 30
--sleep-requests 1
--sleep-interval 5
--max-sleep-interval 10

# Append paths only after the final move
--print-to-file after_move:filepath completed-paths.txt
düz metin yapılandırması, satır başına bir seçenek. bu örnekteki yollar çalışma dizinine karşılık gelir. bir programcı başka bir yerde başlatılabildiğinde mutlak yollar kullanın.
Koleksiyonu çalıştırın
python -m yt_dlp --ignore-config --config-locations yt-dlp-work.conf --batch-file urls.txt
--ignore-config ilkel user/system yapılandırmasını kaldırır; açıkça sağlanan --config-locations dosyası hala yüklendi.

Aynı komutu bir kesintiye sonra tekrar yapın. Tamamlanmış kimlikler kaybolur ve geri dönüştürülebilir kısmi transferler desteklenen yerlerde devam eder. Ekstraksiyon eksiklikleri bir sonraki seferde yeniden gözden geçirilebilir. Varsayılan .part dosyaları yararlı bir durumdur; bunları rutin bir geri çekilme adım olarak silmeyin.

--no-abort-on-error geçmişte mevcut olmayan girişleri devam eder, ancak bir çalışma hala sıfır olmayan çıkabilir ve işleme sonrası hatalar dikkat gerektirir. Sadece yeşil bir iş bulmak için --ignore-errors eklemekten kaçının: işleme sonrası başarısızlıkları başarılı indirme olarak ele alabilir. Koleksiyonu tamamlamadan önce kayıtları ve bitmiş çıkışları inceleyin.

Tamamlanmış dosyaları kontrol edin

completed-paths.txt dosyası yararlı bir başlangıç kayıtlıdır. Geçici video-sadece akışı yerine gerçek nihai çıkışını test edin. ffprobe konteyner ve akış metadata okuyor; ayrı bir dekodlama geçiş, yalnızca okunabilir bir başlık eksik olacak sorunları yakalar.

1 bitmiş dosyayı inceleyin
ffprobe -v error -show_entries format=duration,size:stream=codec_type,codec_name,width,height -of json "downloads/CHANNEL_ID/VIDEO_ID.mp4"
Yolun bir completed-paths.txt ile değiştirilmesi. beklenen süreyi kontrol edin, gerekli audio/video akışları ve dekoder- uyumlu kodekleri.
Seçmeli tam dekod kontrolü
ffmpeg -v error -i "downloads/CHANNEL_ID/VIDEO_ID.mp4" -f null -
Yeni bir medya çıkışı oluşturmadan tüm dosyayı okuyor ve dekore eder. çıkış durumunu ve mesajları kontrol edin; bu ffprobe'den daha uzun sürer.
BulmaYapılacak işlem
Sadece bir .part veya ayrı akış dosyası kalırtransfer/merge hatasını kontrol edin ve orijinal işini yeniden başlatın; orta dosyayı tamamlamayı etiketlemeyin.
Video sesli oynanmaSeçilen biçimi ve ffprobe akışlarını kontrol edin. video-only biçim bir ses seçimi ve birleşme gerektirir.
MP4 Editörünüzde açılmayacakKodekleri, sadece uzantıyı değil, kontrol edin; uyumlu akışları veya transkodları açıkça seçin.
Arşivli kimlik ama yerel dosya yokDosya moved/deleted. olup olmadığını kontrol edin Arşiv girişlerini değiştirmeden önce kayıt defterini birleştirin.

9. Kanıtlanmış bir komutu planlanan bir işe aktarın

Tam komutu planlamadan önce el ile başarıyla çalıştırın. Bir programcı genellikle farklı bir PATH ve çalışma diziniyle başlar. Bu, sanal ortamın tam Python yolu, tam konfig yolu ve açık bir çalışma dizinini verin; ayrıca FFmpeg ve JavaScript çalışma saatini bu süreç için kullanılabilir hale getirin.

  • Bir collection/archive. için tek bir işçi kullanın Dün koşu aynı çıkışlara karşı dünkü koşu aşmasına izin vermeyin.
  • Linux'ta, bir çalışma dizin ve bir kilit gibi bir çalışma dizin ve bir timer/service veya kron girişini kullanın.
  • macOS'ta, mutlak yürütülebilir ve çalışma yönlendirme yolları ile başlatma kullanın.
  • Windows Görev Programı'nda, Çevre python.exe için Program, -m yt_dlp için Argümanlar ve konfig ve batch seçenekleri ve Toplama klasörüne giriş yapın.
  • Kayıt start/end zaman, yürütülebilir versiyon, kaynak manifesti, çıkış durumu ve completed/failed sayılır.
  • Çerez dosyalarını ve hedef kimliklerini paylaştığınız yapılandırma depolarından çıkarın. bir işe sadece ihtiyacı olan kimlikleri verin.

Konfig'teki uyku seçenekleri tek bir süreç içinde hareket eder. Aynı ayarları kullanan 10 işçi hala 10 aşırı talep akışını üretiyor. --concurrent-fragments artışı, bir indirme içinde parçaların rekabetini değiştirir, iş aralığınızdaki videoların sayısını değil.

Doğru hata kılavuzu seçin

Python ortamını güncelleyin
python -m pip install -U --pre "yt-dlp[default,curl-cffi]"
python -m yt_dlp --version

Bir önceden çalışan kaynak kırıldığında, en son gece ilk güncelleştirme, eşleşen ekler de dahil olmak üzere. Gece boyunca tek başına ikili kullanım için yt-dlp --update-to; -U tek başına mevcut kanalda kalır. Her güncelleme sonrasında küçük bir kanarya çalıştırın, sonra işçileri yeniden inşa edin ve revizyonu kaydedin, böylece donanma sessizce yayınları karıştırmaz.

semptomlarBuradan başlayın
Requested format is not availableFormatları listeleyin ve geri dönüşleri değiştirmeden önce sıkı filtrelerinizi kontrol edin.
ffmpeg not found / ffprobe and ffmpeg not foundPATH'yi gerçek işçi veya programcı hesabından kontrol edin.
JavaScript Challenge / eksik çalışma saatleri uyarısıÇalışma süresi tespiti ve eşleşen EJS paketini kontrol edin.
HTTP 403 transfer sırasındareddedilen ev sahibi ve sahneyi tanımlayın; medya transferinden ayrı çıkarma.
HTTP 429Etkili IP'yi durdurun, soğuk düşüş ve düşük extraction/caption talep frekansı sağlar.
Sign in to confirm you’re not a botÇiftin durdurulması ve tek kaynak, oturum ve ağ teşhis edilmesi.

Bir bulut tüpüne ait olduğunda

İndiricinin sahibi olmak istiyorsanız, yukarıdaki çalışma akışları dosya, biçim ve işleme kontrolü sağlar. Uygulamanızın depolama için teslim edilen tamamlanmış medya ihtiyacı varsa, FlashData izlenmiş YouTube indirme işleri, bot işleme, proxy yönlendirme ve geri çekilme sağlar. Başvuru kaynağı ve çıkış ayarlarını sunar, sonra iş kimliği ve teslimat kayıtlarını tutar.

Referans Malzemeleri

Upstream seçenek referansı yüklü sürümünüz için gerçeğin kaynağıdır. bir toplama politikası değiştirirken veya bir işçi görüntüsünü güncelleyecek zaman bu bölümleri kullanın.