Перейти к содержимому
RU
Ключ 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

Два соединения, родовые 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 имеет собственную сетевую реализацию. 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"
* может соответствовать множеству английских вариантов. это восстанавливает доступные тракты; не выполняет распознавание речи.
Перевести выбранные трассы в 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 объект по входу. плоские входы могут пропустить длительность и форматные детали.
Скачать первые пять записей в плей-лист
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
Добавьте рабочий уровень кровли, когда несколько процессов делится маршрутом или сессией.
Кап трансфер Bandwidth
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 ИД лучше ключи для дедуплирования, с описательными полями, содержащимися в метаданных.

Куки и маршруты Runtime

Используйте браузерный профиль, который имеет доступ
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 не эквивалент.
Используйте Дено-эксклюзивный вне работника PATH
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"
Удаляет имплицитную конфигурацию и не сохраняет никакой медиа. она все еще делает запросы по выделению и не доказывает, что перевод будет успешным.
Запись частного диагностического дневника
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