# 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.

Canonical referans: https://flashdata.dev/tr/docs/guides/how-to-use-yt-dlp
İnceleme: 2026-11-13 Tarafından FlashData

- [Araçları kurun](https://flashdata.dev/tr/docs/guides/how-to-use-yt-dlp/reference.md#install) — Python, FFmpeg ve JavaScript
- [Üretimi seçin](https://flashdata.dev/tr/docs/guides/how-to-use-yt-dlp/reference.md#formats) — Video, Ses ve Kaplama
- [Koleksiyonu tekrarlayın](https://flashdata.dev/tr/docs/guides/how-to-use-yt-dlp/reference.md#repeatable) — Manifest, Config ve Arşiv
- [Başarısız bir koşu düzeltmek](https://flashdata.dev/tr/docs/guides/how-to-use-yt-dlp/reference.md#maintain) — Doğru teşhis bulmak

<a id="install"></a>

## 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.

**Linux**

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**

```bash
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
```


**macOS**

Homebrew yüklendiğinde, Python, Deno, FFmpeg ve aria2 için kullanın. yt-dlp projenin ortamında kendisini tutun, böylece gece güncelleştirme komutu Linux'ta olduğu gibi aynıdır.


**macOS kurulum**

```bash
brew install python deno ffmpeg aria2
python3 -m venv .venv
source .venv/bin/activate
python -m pip install -U --pre "yt-dlp[default,curl-cffi]"
deno --version
python -m yt_dlp --version
```


**Windows · PowerShell**

Python 3.11+, Deno ve FFmpeg uygulama yapabilenleri yükleme, sonra yeni bir terminal açın. PowerShell etkinliği engelleyecek şekilde çevre çevirisini doğrudan kullanın. aria2 seçmeli; dış indirme tarifi kullanırsanız ayrı yükleme.


**Windows Çevre**

```powershell
py -3 -m venv .venv
.\.venv\Scripts\python.exe -m pip install -U --pre "yt-dlp[default,curl-cffi]"
deno --version
ffmpeg -version
.\.venv\Scripts\python.exe -m yt_dlp --version
```


| Tool Tool Tool | Ne yapıyor | Kontrol |
| --- | --- | --- |
| Python 3.11+ | Bu seride Python paketini ve örneklerini çalıştırır. | python --version |
| Son yt-dlp gece + varsayılan,curl-cffi ekler | YouTube'un mevcut ekstraktörü, EJS çözücü ve tarayıcı impersonalasyon desteği ile eşleşir. | python -m yt_dlp --version |
| FFmpeg ve ffprobe | Akış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**

```bash
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**

```bash
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 hizmetin kendi yoluna ihtiyacı var**
> Deno yükleri genellikle binary yerleştirir ~/.deno/bin. Bir interaktif şelalesi bulmak bir sistemd hizmet, konteyner veya cron iş yapabilir kanıtlamaz. İşçi PATH veya geç --js-runtimes deno:/absolute/path/to/deno. Hizmet komutunda sanal ortamın Python yolu kullanın.

- [Resmi kurulum](https://github.com/yt-dlp/yt-dlp/wiki/Installation)
- [FFmpeg İndirme](https://ffmpeg.org/download.html)
- [Deno Yükleme](https://docs.deno.com/runtime/getting_started/installation/)
- [YouTube Runtime Yükleme](https://github.com/yt-dlp/yt-dlp/wiki/EJS)

<a id="verify-install"></a>

### 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.

**Linux**


**Download dosyası için hash**

```bash
sha256sum yt-dlp
```


**macOS**


**Download dosyası için hash**

```bash
shasum -a 256 yt-dlp_macos
```


**Windows**


**Download dosyası için hash**

```powershell
Get-FileHash -Algorithm SHA256 .\yt-dlp.exe
```


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.

- [Resmi yayınlar ve kontroller](https://github.com/yt-dlp/yt-dlp/releases)

<a id="first-download"></a>

## 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ü**

```bash
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.

> **Uzunluğu zorlaştırmayın**
> %(ext)s'i çıkış şablonunda tutun. bir WebM akımını file.mp4 adlandırmak sadece adını değiştirir. format seçimi, yeniden yapıştırma ve dönüşüm dosyanın içindeki şeyi belirler.

<a id="formats"></a>

## Kaliteli ve kodek seçimi


**Bu video formatlarını kontrol edin**

```bash
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çenek | Anlam Anlamı | Ne zaman kullanmalı |
| --- | --- | --- |
| Bv + Bv | Sadece 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/B | A 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:1080 | 1080 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 mp4 | Konteyner 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**

```bash
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**

```bash
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.

<a id="audio"></a>

## 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**

```bash
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**

```bash
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.

<a id="sidecars"></a>

## 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**

```bash
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**

```bash
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.

<a id="dataset"></a>

## 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**

```bash
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**

```text
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.

| Gereklilik | Koleksiyon Kararı |
| --- | --- |
| En yüksek kaynak kalitesi | Bestvideo+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 eksik | Eksik metni açıkça kaydedin. yazının zorunlu olması durumunda kaydedilen sesin transcription aşamasına yönlendirilmesi. |
| Birçok dil için kaptanlar | Her 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.

- [Python'da aynı veri set reçetesi](https://flashdata.dev/tr/docs/guides/yt-dlp-python-api/reference.md#dataset)
- [Metadata ve Metatalar 429s](https://flashdata.dev/tr/docs/guides/yt-dlp-429-too-many-requests/reference.md)

<a id="aria2"></a>

## 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**

```bash
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 2 | Bir indirme için bir sunucuda bağlantı kurun. |
| aria2c -s 2 | Bir dosya için istenen bölünmeler; bölünme ayrıca dosya boyutuna ve sunucunun desteğine bağlıdır. |
| aria2c -j 1 | Bu aria2 çağrısı içindeki eşdeğer öğeler, diğer yt-dlp işçiler değil. |
| --concurrent-fragments 1 | Fragment indirme içindeki yerli DASH/HLS indirme. |
| İşin Çiçeği | Toplam 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**

```bash
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.

- [aria2 Bağlantı ve bölünmüş seçenekler](https://aria2.github.io/manual/en/html/aria2c.html)
- [403 İyileşme emri](https://flashdata.dev/tr/docs/guides/yt-dlp-403-forbidden/reference.md#rate)
- [Metadata ve Captions için Hız Kontrolü](https://flashdata.dev/tr/docs/guides/yt-dlp-429-too-many-requests/reference.md#pacing)

<a id="collections"></a>

## 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**

```bash
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.

| Filtre | Kullanım | Sonuç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 20260101 | 1 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.txt | Kaynak kimliklerini kaydetmek, önceki indirme ile zaten kaydedilmiştir. | Değişen başlıklar ve playlist pozisyonları üzerinde çalışıyor. |

<a id="repeatable"></a>

## 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**

```text
# 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**

```bash
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.

> **Ayrı çıkışlar için ayrı arşivler**
> archive.txt'daki tek bir kimlik MP3, 1080p ve 4K'ı ayırt etmez. Farklı çıkış politikaları için farklı arşiv dosyalarını kullanın. Bir medya dosyasını silerseniz ama arşiv girişini tutarsanız, yt-dlp hala kaybolur. Daha sonra dosyaları bulut depolama alanına yüklerseniz, yerel indirme başarısından ayrı başarı kaydedin.

--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.

<a id="verify"></a>

## 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**

```bash
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ü**

```bash
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.

| Bulma | Yapılacak işlem |
| --- | --- |
| Sadece bir .part veya ayrı akış dosyası kalır | transfer/merge hatasını kontrol edin ve orijinal işini yeniden başlatın; orta dosyayı tamamlamayı etiketlemeyin. |
| Video sesli oynanma | Seç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çılmayacak | Kodekleri, sadece uzantıyı değil, kontrol edin; uyumlu akışları veya transkodları açıkça seçin. |
| Arşivli kimlik ama yerel dosya yok | Dosya moved/deleted. olup olmadığını kontrol edin Arşiv girişlerini değiştirmeden önce kayıt defterini birleştirin. |

<a id="schedule"></a>

## 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.

<a id="maintain"></a>

## Doğru hata kılavuzu seçin


**Python ortamını güncelleyin**

```bash
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.

| semptomlar | Buradan başlayın |
| --- | --- |
| `Requested format is not available` | Formatları listeleyin ve geri dönüşleri değiştirmeden önce sıkı filtrelerinizi kontrol edin. |
| `ffmpeg not found` / `ffprobe and ffmpeg not found` | PATH'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ında | reddedilen ev sahibi ve sahneyi tanımlayın; medya transferinden ayrı çıkarma. |
| HTTP 429 | Etkili 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. |

- [403 Diagnostik çalışma akışı](https://flashdata.dev/tr/docs/guides/yt-dlp-403-forbidden/reference.md)
- [Bot-check Diagnostik Çalışma Akışı](https://flashdata.dev/tr/docs/guides/yt-dlp-sign-in-not-a-bot/reference.md)
- [429 Hız sınırı geri dönüş](https://flashdata.dev/tr/docs/guides/yt-dlp-429-too-many-requests/reference.md)
- [Günlük komut referansı](https://flashdata.dev/tr/docs/guides/yt-dlp-commands/reference.md)
- [Python Çalışanları Yapmak](https://flashdata.dev/tr/docs/guides/yt-dlp-python-api/reference.md)

<a id="managed-downloads"></a>

## 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.

- [İki çalışma modeli karşılaştırın](https://flashdata.dev/tr/docs/guides/flashdata-vs-yt-dlp/reference.md)
- [YouTube videolarını toplu indirme](https://flashdata.dev/tr/products/youtube-download#bulk-downloads)
- [Download demo için tıklayınız](https://flashdata.dev/tr/products/youtube-download#playground)
- [Download API Referansları](https://flashdata.dev/tr/docs/sources/youtube_download/reference.md)

<a id="references"></a>

## 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.

- [Format Seçimi ve Sınıflandırma](https://github.com/yt-dlp/yt-dlp#format-selection)
- [Yükleme Konfigurasyon](https://github.com/yt-dlp/yt-dlp#configuration)
- [çıkış şablonları](https://github.com/yt-dlp/yt-dlp#output-template)
- [Поширені запитання про yt-dlp](https://github.com/yt-dlp/yt-dlp/wiki/FAQ)
