Перейти до вмісту
UK
Отримати ключ API
Переглянути документацію

Посібники

Команди yt-dlp для щоденних завдань

Скопіюйте команди для відео, аудіо, субтитрів, наборів даних і відновлення збирання.

На цій сторінці

Конвенції та конвенції

Починаючи з нинішніх нічних і повних залежності
python -m pip install -U --pre "yt-dlp[default,curl-cffi]"
deno --version
ffmpeg -version
python -m yt_dlp --list-impersonate-targets

Рецепти завантаження використовують Deno і --impersonate="" як базову лінію. Цей останній вимагає curl-cffi і дозволяє йому вибрати доступний відбиток пальців браузера. Linux/macOS наказує використовувати синтакс Баша; для запланованого працівника, також роблять ці залежності доступними в цьому середовищі обслуговування.

Ці термінові приклади використовують установку Python yt-dlp. Використовуйте Python у віртуальному середовищі або замінюйте Python -m yt_dlp за допомогою самостійного командування yt-dlp. Використовуйте Linux в першу чергу, з альтернативами macOS і Windows в інструкції налаштування. Налаштуйте FFmpeg/ffprobe для поєднання і Deno для вирішення виклику YouTube. Замінити URL-адресу з вашим джерелом.

КонвенціяЧому це важливо
URL і шаблониШейл іншим чином інтерпретує персонажі, такі як &, простіри і паралелі.
Зберігати %(ext)s в філенахВибрані засоби масової інформації та післяпроцесування визначають розширення.
Використовуйте --no-playlist для URL-адресу годинникаВідео, пов'язане з переглянутою списком, не повинно неочікувано розширювати вашу роботу.
Перевірте збережену конфігураціюПриклади можуть успадковувати глобальний конфіг. Використовуйте --ignore-config для ізольованого тестування.
Windows .bat: подвійний шаблон відсотка знаківВикористовуйте %(id) в файлі комплекту, а %(id) в інтерактивному PowerShell і нормальних файлах конфігурації.

Качественність відео та MP4

Базовий: останній нічний, Deno і FFmpeg, з --impersonate="". Рецепти використовують Bash; замінити URL-адресу з вашим джерелом.

Завантажити відео з дефолтом
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. контейнер не обов'язково MP4.
Список доступних форматів
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  -F "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Інспекційні кодек і рядки audio-only/video-only. Ідентифікатори цифрового формату не є портативними політиками виходу.
Завантажити 1080p
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist -S "res:1080" \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Переваги: якщо немає формату під цілью або нижче, то рангування може вибрати один над ним.
Використовуйте максимальний показник 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"
Фільтр: не вдається, коли формату не відповідає. зберігає вибір кодек джерела.
H.264 відео і AAC аудіо в 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"
Вибір кодек вимагає відповідних форматів і FFmpeg для окремих потоків поєднання.

АІ дата-сет: MP4 + капсії + метадані

Найкращий відео + аудіо, MP4, капсули та метадані
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 поєднує джерельні потоки. MP4 зберігає джерельні кодек; перевіряти сумісність декодера і відрізняється покриття заголовок.

Завантажити завантаження: aria2c

2 Зв'язки, корінні 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"
Cần có tệp thực thi aria2c. Chỉ tăng số kết nối sau khi tải thử thành công một video. Giảm số kết nối ngay nếu gặp lỗi 403.

aria2 має власне мережеве реалізацію. yt-dlp імперіація curl-cffi не налаштує відбиток пальців aria2. Якщо тільки зовнішній завантажувач провалиться, використовуйте --downloader і порівнюйте той же джерело і прокси маршрут.

Звук і MP3

Зберегти оригінальний аудіо потоку
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"
Без перетворення на MP3. Це зручно, якщо система транскрибування або відтворення підтримує вихідний кодек.
Конвертація в MP3 на цільовій бітраті
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. 192K контролює кодування виходу; він не відновлює якість джерела.
Попередня статтяКто чего не хотів M4A
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist -f "ba[ext=m4a]" -P audio \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Не вдається, якщо немає M4A аудіо-один формат доступний. Додати /ba тільки тоді, коли ваша програма приймає інші контейнери джерела.
MP3 з вбудованими метаданними та покриттям
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 є додатковим післязастосуванням. перевірте кінцеву файл, а не тільки перехідний хід.

Кап'єри та субтитри

Список доступних маршрутів
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  --list-subs "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Прочитайте теги мови, що пропонується цим джерелом, перш ніж вибрати --sub-langs.
Завантажити надані англійські субтитри тільки
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"
Не повертається до автоматичних записів і не завантажує медіа.
Також дозволяється автоматичне англійське введення
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.* може відповідати кількома англійськими варіантами. це отримує доступні сходи; він не виконує розпізнавання мови.
Перетворення вибраних стовпів на 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"
Потрібен FFmpeg. За потреби виберіть інший код мови з результату --list-subs.
Включити в 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"
Завантажує медіа, запити, що надаються англійською мовою підзаголовок і вставляє доступний трас. Перевірте, чи цей трас існує перш за все.

Запит на всі мови завантаження може значно збільшити кількість запитів і файлів. Зберігайте потрібні мови для рутинної роботи. Збережіть джерело і мову в запасі даних, щоб транскрипти не були відхилені від засобів масової інформації, які вони описують.

Метадани та вихідні шляхи

Натисніть метаданни одного відео як JSON
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  --dump-json "https://www.youtube.com/watch?v=jNQXAC9IVRw" > video.json
Симулює за замовчуванням завантаження, але виконує екстракцію. перенапрямлення замінює video.json.
Напишіть повний метаданний боковий стіл без медіа
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"
Створює .info.json боковий стовп. Це операційні дані екстрактора; проектні поля перед публічним виставкою.
Завантажити тільки дрібницю
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"
Збереже доступний мінімум у формі джерела. --convert-thumbnails jpg додає крок конверсії, коли потрібен JPEG.
Видавництво останньої медіа-путеви після обробки
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"
На відміну від стандартного етапу --print, друк after_move чекає на реальне завантаження і його остаточний крок.
Додайте завершені шляхи до демонстрації
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"
Додайте, так що відступні можуть виробляти повторні входи. Зробіть це як завершення, а не дедуплікований інвентар.

Розділи та часи

Завантажити секунду 5 через 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"
Вимоги FFmpeg. Кліп-ографія може збігатися з наявними клавіатурами; перевіряти вихід, коли точний час стосується.
Перезавантаження навколо запитуваних скорочень
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"
Додає роботу перекодування для поліпшення скорочення на затребуваних кордонах. Перевірте результативну тривалість і audio/video збіг.
Розділити розділене відео на файли
python -m yt_dlp --split-chapters -o "chapter:%(id)s-%(section_number)03d.%(ext)s" \
  "https://www.youtube.com/watch?v=YOUR_VIDEO_ID"
Використовуйте відео з метаданими розділу. вихідні розділи відділені від оригінального повного завантаження; бюджетний диск для обох.

Використовуйте іншу політику виходу або архіву для кліпів і повних відео. Вхід архіву на рівні джерела не кодує вибрані start/end часи, тому один спільний архів може усунути пізній кліп, який ви маєте намір створити.

Списки і URL-лісти

Завантажити відомий список URL
python -m yt_dlp --no-playlist --batch-file urls.txt -P collection -o "%(id)s.%(ext)s"
Створіть файл UTF-8 з одним URL-адресом за строком. --no-playlist застосовується до перегляду URL-адресів, які включають контекст перегляду списку.
Перевірка перегляду YouTube без повного відео-екстракції
python -m yt_dlp --flat-playlist \
  --dump-json "https://www.youtube.com/playlist?list=YOUR_PLAYLIST_ID" > playlist.jsonl
Один JSON об'єкт за вхід. Флатові входи можуть пропустити тривалість і форматні деталі.
Завантажити перші 5 записів в списку
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"
Індекси списку переглядів відображаються як замовлення, а не ідентичність. Зберігайте відео-ІД в філеному імені.
Ограничити вигідні відео за датою та тривалістю
python -m yt_dlp --dateafter 20260101 --match-filters "!is_live & duration <= 1800" \
  --batch-file urls.txt
Потрібні неживі предмети з відомою тривалістю до 30 хвилин, що датуються або після січня 1, 2026. Фільтр може все ще вимагати запитів на відео.
Залишився після 10 нових скачок
python -m yt_dlp --download-archive archive.txt --max-downloads 10 --batch-file urls.txt
Ограничення контролює завантажені файли, не кількість запитів listing/extraction, які відбуваються.

Архів та відновлення

Зробити колекцію з однією політикою
python -m yt_dlp --download-archive archive.txt --continue --no-abort-on-error -P collection \
  -o "%(id)s.%(ext)s" --batch-file urls.txt
Повний ID-диски перерваються. часткові завантаження відновлюються там, де підтримується. Використовуйте ті ж архіви і вихідні шляхи, як і оригінальна робота.
Помири одного працівника і об'єднуй його пенсії
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
Додайте обмеження працівника рівня ковбасу, коли кілька процесів ділиться маршрутом або сесією.
Передача пропускного діапазону
python -m yt_dlp --js-runtimes deno --impersonate="" --limit-rate 2M \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Контролює швидкість передачі засобів масової інформації. вона не регулює кількість запитів на видобуток.
Зниження різноманітних різноманітних різноманітних різноманітних
python -m yt_dlp --js-runtimes deno --impersonate="" --concurrent-fragments 1 \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Почніть з одного фрагменту в той же час, коли вивчає 403s. Інші процеси працівників все ще додають свої власні суперечливі запити.

Конфігурація та філеменами

Завантажити тільки ваш експлицитний збірний конфіг
python -m yt_dlp --ignore-config --config-locations yt-dlp-work.conf --batch-file urls.txt
Конфіг, який виражено, завантажений навіть з --ignore-config. Використовуйте повні шляхи для запланованих робочих місць.
Читальні імена з стабільним ідентичністю
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"
Заголовок перекручується на 150 байти в цій шаблоні. ідентифікатори відрізняють подвійні або змінюються заголовки.
Використовуйте окремий тимчасовий каталог
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"
Останній крок відбувається після обробки. переконайтеся, що обидві каталоги мають достатньо місця; різні файлові системи можуть вимагати копії.

Для довготривалого колекції вирішуйте, чи повинні філенови імена бути людським читанням або стабільними ключами до застосування. Назва і назва каналів можуть змінюватися. Channel/video ІД є кращими ключами для дедуплікації, з описовими полями, що зберігаються в метаданах.

Куки та маршрути запуску

Використовуйте профіль браузера, який має доступ
python -m yt_dlp --js-runtimes deno --impersonate="" \
  --cookies-from-browser "chrome:Profile 1" \
  --no-playlist "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Замінити Профіль 1 вашим реальним профілем браузера. використовуйте cookie сесії тільки тоді, коли це необхідно, і зберігайте їх приватними.
Читати існуючий приватний файл cookie
python -m yt_dlp --js-runtimes deno --impersonate="" --cookies private/youtube-cookies.txt \
  --no-playlist "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Вимоги до файлу cookie Netscape. експорт JSON не є еквівалентом.
Використовуйте дено-ікутувальний за межами робочого патру
python -m yt_dlp --js-runtimes "deno:/opt/deno/bin/deno" --impersonate="" \
  --no-playlist "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Замінити шлях з Деніо бінарний встановлений для вашого працівника.

Діагностика та перевірка

Перевірте чистий екстракт
python -m yt_dlp --js-runtimes deno --impersonate="" --ignore-config --verbose --simulate \
  --no-playlist "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Усуває implicit config і не зберігає жодних засобів масової інформації. вона все ще робить запити на видобуток і не доводить, що перехід буде успішним.
Завантажити приватний діагностичний запис
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
Редагувати значення cookie/header, прокси-кредитації та підписані URL-адреси перед поділом.
Перевірка збережених потоків та тривалості
ffprobe -v error -show_entries format=duration,size:stream=codec_type,codec_name,width,height -of json "YOUR_OUTPUT_FILE"
Використовуйте кінцеву дорогу, після обробки. ffprobe читає заголовки; вона не декорує кожну рамку.
Декодувати збережений файл без створення виходу
ffmpeg -v error -i "YOUR_OUTPUT_FILE" -f null -
Глибокий перевірка, яка читає весь файл. Перевірте стан виходу та повідомлення.
Оновлення пакету Python і перевірка його версії
python -m pip install -U --pre "yt-dlp[default,curl-cffi]"
python -m yt_dlp --version