Ga naar de inhoud
NL
API-sleutel ophalen
Documentatie bekijken

Handleidingen

yt-dlp-opdrachten voor dagelijks gebruik

Kopieer opdrachten voor video, audio, ondertitels, datasets en het hervatten van verzamelingen.

Op deze pagina

Instelling en bestelling conventies

Begin met de huidige nachtelijke en complete afhankelijkheid
python -m pip install -U --pre "yt-dlp[default,curl-cffi]"
deno --version
ffmpeg -version
python -m yt_dlp --list-impersonate-targets

De downloadrecepten gebruiken Deno en --impersonate="" als de basislijn. De laatste vereist curl-cffi en laat het kiezen van een beschikbare browser vingerafdruk. Linux/macOS bevelen Bash syntax te gebruiken; voor een geplande werknemer, ook deze afhankelijkheden beschikbaar maken in die service omgeving.

Deze terminal voorbeelden gebruiken de Python-installatie van yt-dlp. Gebruik uw virtuele omgeving Python, of vervang python -m yt_dlp met de standaard yt-dlp-bestelling. Gebruik Linux eerst, met macOS en Windows-alternatieven in de installatiedijl. Installeren FFmpeg/ffprobe voor de fusie en Deno voor YouTube challenge solving. Vervang de URL met uw bron.

ConventieWaarom het belangrijk is
URL's en templates verwijzenDe shell anders interpreteert karakters zoals &, ruimtes en parenteses.
%(ext)s in filenamen houdenDe geselecteerde media en post-verwerking bepalen de uitbreiding.
Gebruik --no-playlist voor een urlEen video die is gekoppeld aan een playlist, mag uw werk niet onverwacht uitbreiden.
Controleer uw beveiligde configuratieVoorbeelden kunnen een wereldwijde config erven. gebruik --ignore-config voor een geïsoleerde test.
Windows .bat: dubbele template percentage tekensGebruik %%(id)s in een setbestand, maar %(id)s in interactieve PowerShell en normale configuratiebestanden.

Video kwaliteit en MP4

Base line: laatste nachtelijk, Deno en FFmpeg, met --impersonate="". De recepten gebruiken Bash; vervangen de URL van het voorbeeld met uw bron.

Download één video met standaard selectie
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist -P downloads \
  -o "%(id)s.%(ext)s" "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Selecteer beschikbare stromen met behulp van de standaardpunten van yt-dlp. de container is niet noodzakelijkerwijs MP4.
Lijst van beschikbare formaten
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  -F "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Inspectie codecs en audio-only/video-only rijen. Numerische formatsID's zijn niet portable output beleid.
Voorkeur 1080p
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist -S "res:1080" \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Een voorkeur: als er geen formaten beschikbaar zijn bij of onder het doel, kan de sortering een boven het kiezen.
Het maximale aantal 1080p
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"
Een filter: faalt wanneer geen format overeenkomt. behoudt de source codec keuze.
H.264 video en AAC audio in 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"
Strikte selectie codec. vereist matching formaten en FFmpeg voor afzonderlijke stromen fusie.

AI-dataset: MP4 + capties + metadata

Beste video + audio, MP4, capties en 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 combineert bronstromen. MP4 houdt de bron codecs; controleer de compatibiliteit van de decoder en de afbeelding bedekking afzonderlijk.

Externe downloader: aria2c

Twee verbindingen, inheemse 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"
Vereist het uitvoerbare bestand aria2c. Controleer eerst of één video kan worden gedownload. Verhoog daarna het aantal verbindingen en verlaag het zodra een 403-fout optreedt.

aria2 heeft zijn eigen netwerkimplementatie. yt-dlp's curl-cffi-impersoonlijn configureert aria2's vingerdruk niet. Als alleen de externe downloader mislukt, gebruik --downloader native en vergelijk dezelfde bron en proxy route.

Audio en MP3

Speel de originele audio stream
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"
Geen MP3 conversie. handig wanneer uw transcription of playback pipeline de oorspronkelijke codec accepteert.
Convert naar MP3 bij een doelbitrate
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"
Gebruik FFmpeg. 192K beheert de output codering; het herstelt niet de bronkwaliteit.
Prefereren M4A zonder transcoding
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist -f "ba[ext=m4a]" -P audio \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Fout als er geen M4A audio-only format beschikbaar is. Add /ba alleen als uw applicatie andere broncontainers accepteert.
MP3 met ingebouwde metadata en dekking
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"
De metadata/thumbnail stappen zijn extra post-verwerking. Check de laatste bestand, niet alleen de overdracht hook.

Capties en subtitels

Lijst van beschikbare tracks
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  --list-subs "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Lees de taal tags die door deze bron worden aangeboden voordat u --sub-langs kiest.
Download aangeboden Engelse subtitels alleen
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"
Het valt niet terug naar automatische capties en downloadt de media niet.
Ook automatisch Engelse capties toegestaan
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.* kan meerdere Engelse varianten overeenkomen. dit herstelt beschikbare tracks; het voert geen spreekrecognition.
Convert geselecteerde tracks naar SRT
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"
Vereist FFmpeg. Kies zo nodig een andere taalcode uit de uitvoer van --list-subs.
Invoeren van de geleverde ondertitels in 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"
Download media, verzoeken geleverd Engels ondertitels en voegt de beschikbare track in. Check of die track bestaat eerst.

Het aanvragen van alle opname talen kan het aantal verzoeken en bestanden aanzienlijk verhogen. Houd de aangevraagde talen uitdrukkelijk voor routinewerk. Bewaar de bron-ID en taal in uw dataset-inventory zodat transcripten niet worden afgescheiden van de media die ze beschrijven.

Metadata en outputpaden

Metadata van een video gedrukt als JSON
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  --dump-json "https://www.youtube.com/watch?v=jNQXAC9IVRw" > video.json
Simuleert de download door standaard, maar uitvoert extractie. De redirect vervangt video.json.
Een volledige metadata sidecar schrijven zonder media
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"
Creëert een .info.json zijdek. dit is operationele extractorgegevens; projectvelden voordat ze openbaar worden blootgesteld.
Download de miniatuur alleen
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"
Het bespaart de beschikbare miniatuur in het bronnenformaat. --convert-thumbnails jpg voegt een conversie-stap toe wanneer JPEG nodig is.
De laatste media route na verwerking
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"
In tegenstelling tot een standaardstap --print wacht een after_move-print op een echte download en de laatste beweging.
Aanvullende paden naar een manifest
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"
Append, dus retries kunnen herhaalde inzichten produceren. behandel het als een voltooiingslog, niet een geduplicate inventaris.

Tijd Rangen en hoofdstukken

Download seconden 5 door 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"
Requires FFmpeg. Een clipgrens kan aanpassen met beschikbare toetsen; controleer de uitkomst wanneer de exacte timing is belangrijk.
Re-encoderen rond verzochte snijden
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"
Adds re-encoding werk om het snijden te verbeteren bij de aangevraagde grenzen. Inspecteer de resulterende duur en audio/video aanpassing.
Split een kapitein video in bestanden
python -m yt_dlp --split-chapters -o "chapter:%(id)s-%(section_number)03d.%(ext)s" \
  "https://www.youtube.com/watch?v=YOUR_VIDEO_ID"
Gebruik een video met hoofdstuk metadata. hoofdstuk output zijn gescheiden van de oorspronkelijke volledige download; budget disk space voor beide.

Gebruik een andere output- of archief voor clips en volledige video's. Een bron-niveau archief invoer codert niet de geselecteerde start/end tijden, dus één gedeelde archief kan een later clip die u bedoeld is om te maken te verwijderen.

Playlisten en URL's

Download een bekende URL-lijst
python -m yt_dlp --no-playlist --batch-file urls.txt -P collection -o "%(id)s.%(ext)s"
Creëer een UTF-8 bestand met één watch URL per lijn. --no-playlist geldt voor het bekijken van URL's die de playlist context bevatten.
Controleer een YouTube-spellist zonder volledige video-extractie
python -m yt_dlp --flat-playlist \
  --dump-json "https://www.youtube.com/playlist?list=YOUR_PLAYLIST_ID" > playlist.jsonl
Een JSON object per invoer.Flat-invoeringen kunnen de duur en format details vermijden.
Download de eerste vijf playlist-inputten
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"
De indices van de playlist zijn order, niet identiteit. Houd de video-ID in de filename.
Beperk de in aanmerking komende video's per datum en duur
python -m yt_dlp --dateafter 20260101 --match-filters "!is_live & duration <= 1800" \
  --batch-file urls.txt
Verplicht niet-live items met een bekende duur tot 30 minuten, dateren op of na januari 1, 2026.
Stop na 10 nieuwe downloads
python -m yt_dlp --download-archive archive.txt --max-downloads 10 --batch-file urls.txt
De limit controleert de nieuw gedownload bestanden, niet hoeveel listing/extraction verzoeken zich voordoen.

Archief en herstel

Een collectie opnieuw maken met dezelfde beleid
python -m yt_dlp --download-archive archive.txt --continue --no-abort-on-error -P collection \
  -o "%(id)s.%(ext)s" --batch-file urls.txt
Volledige ID's worden verplaatst. partiële downloads herleven waar ondersteund. Gebruik dezelfde archief en uitgangspuiten als de oorspronkelijke baan.
1 Vrede een werknemer en verbind zijn pensioenen
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
Voeg een werknemergrens toe wanneer meerdere processen een route of sessie delen.
Cap transfer bandbreedte
python -m yt_dlp --js-runtimes deno --impersonate="" --limit-rate 2M \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Controleert de media overdracht tarieven. Het regelt niet het aantal extractieplaatsen.
Vermindering van de inheemse fragment concurrentie
python -m yt_dlp --js-runtimes deno --impersonate="" --concurrent-fragments 1 \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Begin met één fragment op een gegeven moment bij het onderzoeken 403s. Andere werknemersprocessen voegen nog steeds hun eigen concurrerende verzoeken toe.

Configuratie en filenamen

Laden alleen uw uitdrukkelijke collectie config
python -m yt_dlp --ignore-config --config-locations yt-dlp-work.conf --batch-file urls.txt
De uitdrukkelijk genoemde configuratie wordt zelfs geladen met --ignore-config. Gebruik volledige paden voor geplande banen.
Leesbare namen met stabiele identiteit
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"
De titel wordt in 150 byten in dit template gedroogd. ID's onderscheiden duplicate of wijzend titels.
Gebruik een afzonderlijke tijdelijke directory
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"
Zorg ervoor dat beide directories voldoende ruimte hebben; verschillende bestandsystemen kunnen een kopie vereisen.

Voor langdurige collecties, beslissen of filenamen menselijk leesbaar of stabiele applicatie sleutels moeten zijn. De naam en titel kan veranderen. Channel/video ID's zijn betere sleutels voor de deduplicatie, met beschrijvende velden bewaard in metadata.

Cookies en runtime paden

Gebruik het browserprofiel dat toegang heeft
python -m yt_dlp --js-runtimes deno --impersonate="" \
  --cookies-from-browser "chrome:Profile 1" \
  --no-playlist "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Vervang Profile 1 met uw werkelijke browserprofiel. Gebruik sessiescookies alleen wanneer nodig, en houd ze privé.
Lees een bestaande privé-cookie
python -m yt_dlp --js-runtimes deno --impersonate="" --cookies private/youtube-cookies.txt \
  --no-playlist "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Het vereist het Netscape cookie-bestandformaat. een JSON export is niet gelijkwaardig.
Gebruik een Deno uitvoerbaar buiten de werknemer PATH
python -m yt_dlp --js-runtimes "deno:/opt/deno/bin/deno" --impersonate="" \
  --no-playlist "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Vervang de route met de Deno binaire geïnstalleerd voor uw werknemer.

Diagnose en verificatie

Controleer een schone extractie
python -m yt_dlp --js-runtimes deno --impersonate="" --ignore-config --verbose --simulate \
  --no-playlist "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Het verwijdert implicit config en slaat geen media. het maakt nog steeds extractiebedragen en bewijst niet dat een overdracht zal slagen.
Een privé diagnostisch log opnemen
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
De redirect vervangt de log. Redact cookie/header waarden, proxy-certificaten en gesignaleerde URL's voordat ze delen.
Inspectie van gereserveerde stromen en duur
ffprobe -v error -show_entries format=duration,size:stream=codec_type,codec_name,width,height -of json "YOUR_OUTPUT_FILE"
Gebruik de laatste route, na verwerking. ffprobe leest de header; het decodeert niet elke frame.
Decodeer de opgeslagen bestand zonder een uitgang te creëren
ffmpeg -v error -i "YOUR_OUTPUT_FILE" -f null -
Een dieper check die het hele bestand leest. Check de uitgangsstatus en berichten.
Update het Python-pakket en controleer de versie
python -m pip install -U --pre "yt-dlp[default,curl-cffi]"
python -m yt_dlp --version