# Команды yt-dlp для повседневных задач

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

Каноническая ссылка: https://flashdata.dev/ru/docs/guides/yt-dlp-commands
Разработчик: 2026-11-13 by FlashData

- [Видео и аудио](https://flashdata.dev/ru/docs/guides/yt-dlp-commands/reference.md#video) — Качество, кодек и MP3
- [Капции и метаданные](https://flashdata.dev/ru/docs/guides/yt-dlp-commands/reference.md#subtitles) — Сидекар и структурированный вывод
- [Коллекция и восстановление](https://flashdata.dev/ru/docs/guides/yt-dlp-commands/reference.md#archives) — Списки, архивы и конфигурация
- [Диагностика неудачи](https://flashdata.dev/ru/docs/guides/yt-dlp-commands/reference.md#diagnostics) — Проверка и проверка выхода

<a id="conventions"></a>

## Конвенции по установке и команде


**Начинаем с ночных и полных зависимостей**

```bash
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 и нормальных файлах конфигурации. |

- [Инсталляция инструментов](https://flashdata.dev/ru/docs/guides/how-to-use-yt-dlp/reference.md#install)
- [Создание переиспользоваемой конфигурации коллекции](https://flashdata.dev/ru/docs/guides/how-to-use-yt-dlp/reference.md#repeatable)

<a id="video"></a>

## Качество видео и MP4


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

**Скачать видео с подборным вариантом**

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

**Список доступных форматов**

```bash
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  -F "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

Инспекция кодексов и audio-only/video-only строк. Идентификаторы цифрового формата не являются портативными политиками выхода.

**Прежде всего 1080p**

```bash
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist -S "res:1080" \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

Преференция: если нет формата на или ниже целевой, то ранжирование может выбрать один из выше.

**Выполняйте максимальный уровень 1080p**

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

```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 "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

Строгий выбор кодек. требует соответствия форматиров и FFmpeg для отдельного потока сливания.

> **Контейнер не является кодек**
> --merge-output-format выбирает смешанный контейнер. --remux-video перепакивает совместимые потоки. Не переводится AV1 в H.264. Когда декодер требует конкретного кодек, выберите этот кодек или планируйте отдельный транскод.

- [Понимайте селекторы и фальбаки](https://flashdata.dev/ru/docs/guides/how-to-use-yt-dlp/reference.md#formats)

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

## АИ набор данных: MP4 + капсион + метаданные


**Лучшие видео + аудио, MP4, капси и метаданные**

```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" \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

FFmpeg сливается источник потоков. MP4 хранит источник кодек; проверьте совместимость декодера и отметки покрытия отдельно.

- [Политика выхода Dataset и отсутствующие капситы](https://flashdata.dev/ru/docs/guides/how-to-use-yt-dlp/reference.md#dataset)
- [Эквивалентные Python Dataset опции](https://flashdata.dev/ru/docs/guides/yt-dlp-python-api/reference.md#dataset)

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

## Внешний загрузчик: aria2c


**Два соединения, родовые DASH/HLS**

```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 "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

Нужен исполняемый файл aria2c. Проверьте загрузку одного видео, прежде чем увеличивать число соединений. Если появится ошибка 403, сразу сократите их число.

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

- [Контроль соединения и диагноз проходного](https://flashdata.dev/ru/docs/guides/how-to-use-yt-dlp/reference.md#aria2)

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

## Аудио и MP3


**Защитите оригинальный аудио-превод**

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

Нет MP3 конверсии. полезно, когда ваш транскриптор или реплик-пунтеры принимают оригинальный кодек.

**Конвертировать в MP3 на целевой битрате**

```bash
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 без транскодирования**

```bash
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 с встроенными метаданными и покрытием**

```bash
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 являются дополнительными послепроцессией. проверьте финальный файл, а не только переносный хок.

<a id="subtitles"></a>

## Капции и субтитры


**Список доступных трасс**

```bash
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  --list-subs "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

Прочитайте языковые теги, предлагаемые этим источником, прежде чем выбрать --sub-langs.

**Скачать поставленные английские субтитры только**

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

Не возвращается к автоматическим записям и не загружает медиа.

**Также разрешается автоматическое английское ухо**

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

```bash
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 поставленные субтитры**

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

Скачать медиа, запросы, поставленные на английском языке субтитры и вводить доступную трассу. проверить, существует ли эта трасса сначала.

Заявление на все языки ответа может значительно увеличить количество запросов и файлов. Удержите запрошенные языки для рутинной работы. Сохраняйте источник и язык в запасе сборов данных, чтобы транскрипты не были отключены от описанных им медиа.

<a id="metadata"></a>

## Метаданные и выходной путь


**Напечатать метаданные одного видео как JSON**

```bash
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  --dump-json "https://www.youtube.com/watch?v=jNQXAC9IVRw" > video.json
```

Симулирует загрузку по умолчанию, но выполняет экстракцию. перенаправление заменяет video.json.

**Напишите полный страничный лист метаданных без медиа**

```bash
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 боковой панель. это операционные данные извлечения; полы проекта перед публичным раскрытием.

**Скачать только миниатюрный**

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

**Отпечатать последний медиапут после обработки**

```bash
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 печатает ожидание реального загрузки и его окончательного движения.

**Дополнительные пути к манифесту**

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

Прибавляется, поэтому отходы могут производить повторяющиеся входы. Обратитесь к нему как к записи завершения, а не к дедуплированному инвентаризации.

- [Проекция Python Metadata](https://flashdata.dev/ru/docs/guides/yt-dlp-python-api/reference.md#metadata)

<a id="clips"></a>

## Временные рангы и главы


**Скачать секунды 5 через 10**

```bash
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. граница клипа может соответствовать имеющимся клавиатурам; проверьте выход, когда точное время имеет значение.

**Ре-кодирование вокруг запрошенных сокращений**

```bash
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 сближение.

**Разделение разделного видео в файлы**

```bash
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 часы, поэтому один совместный архив может удалить поздний клип, который вы планируете создать.

<a id="playlists"></a>

## Списки игр и URL-листы


**Скачать известный список URL**

```bash
python -m yt_dlp --no-playlist --batch-file urls.txt -P collection -o "%(id)s.%(ext)s"
```

Создайте файл UTF-8 с одним URL-адресом на строку. --no-playlist применяется для просмотра URL-адресов, которые включают контекст перечня.

**Проверьте перечень просмотров YouTube без полного видеоэкстракции**

```bash
python -m yt_dlp --flat-playlist \
  --dump-json "https://www.youtube.com/playlist?list=YOUR_PLAYLIST_ID" > playlist.jsonl
```

Один JSON объект по входу. плоские входы могут пропустить длительность и форматные детали.

**Скачать первые пять записей в плей-лист**

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

Индексы списка игр отображаются в порядке, а не в идентификации.

**Ограничение разрешенных видео по дате и продолжительности**

```bash
python -m yt_dlp --dateafter 20260101 --match-filters "!is_live & duration <= 1800" \
  --batch-file urls.txt
```

Требуется неживые предметы с известной продолжительностью до 30 минут, датируемых в январе или после 1, 2026.

**Задержка после 10 новых загрузок**

```bash
python -m yt_dlp --download-archive archive.txt --max-downloads 10 --batch-file urls.txt
```

Ограничение контролирует недавно загруженные файлы, не сколько запросов listing/extraction возникает.

<a id="archives"></a>

## Архивы и восстановление


**Рецидивировать сборку с одной и той же политикой**

```bash
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-и пересекаются. Частные загрузки возвращаются там, где поддерживаются. Используйте те же архивы и выходные пути, что и первоначальная работа.

**Оспорить одного работника и связывать его пенсию**

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

```bash
python -m yt_dlp --js-runtimes deno --impersonate="" --limit-rate 2M \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

Контролирует скорость передачи СМИ. не регулирует количество запросов на вывод.

**Снижение конкуренции на коренном фрагменте**

```bash
python -m yt_dlp --js-runtimes deno --impersonate="" --concurrent-fragments 1 \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

Начните с одного фрагмента в то время, когда вы расследуете 403s. Другие рабочие процессы все еще добавляют свои собственные сопутствующие запросы.

> **Архив имеет определенную работу.**
> Он записывает extractor/video ID после успешных загрузок. Это не каталог выходной настройки или проверка того, что файл все еще существует. Сохраняйте отдельные архивы для аудио, видео и клип политики, и не отмечайте неудачную работу завершенной с --force-write-archive.

- [Переиспользование конфигурации и восстановления](https://flashdata.dev/ru/docs/guides/how-to-use-yt-dlp/reference.md#repeatable)

<a id="configuration"></a>

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


**Загрузите только конфигурируйте свою эксплицитную коллекцию**

```bash
python -m yt_dlp --ignore-config --config-locations yt-dlp-work.conf --batch-file urls.txt
```

Конфиг, который прямо именуется, загружен даже с --ignore-config. Используйте полные пути для запланированных работ.

**Читаемые имена с стабильной идентичностью**

```bash
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 байты. ИД различают дублируемые или меняющие названия.

**Используйте отдельный временный каталог**

```bash
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 ИД лучше ключи для дедуплирования, с описательными полями, содержащимися в метаданных.

<a id="session"></a>

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


**Используйте браузерный профиль, который имеет доступ**

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

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

```bash
python -m yt_dlp --js-runtimes "deno:/opt/deno/bin/deno" --impersonate="" \
  --no-playlist "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

Заменить путь с ДЕНО бинарной установки для вашего работника.

- [Загрузка файлов cookie, истечение срока и бот-контроль](https://flashdata.dev/ru/docs/guides/yt-dlp-sign-in-not-a-bot/reference.md)

<a id="diagnostics"></a>

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


**Проверьте чистую экстракцию**

```bash
python -m yt_dlp --js-runtimes deno --impersonate="" --ignore-config --verbose --simulate \
  --no-playlist "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

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

**Запись частного диагностического дневника**

```bash
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 перед делением.

**Проверка спасенных потоков и продолжительности**

```bash
ffprobe -v error -show_entries format=duration,size:stream=codec_type,codec_name,width,height -of json "YOUR_OUTPUT_FILE"
```

Используйте последний путь, после обработки. ffprobe читает заголовки; он не декодирует каждую рамку.

**Декодировать сохранившийся файл без создания выхода**

```bash
ffmpeg -v error -i "YOUR_OUTPUT_FILE" -f null -
```

Глубший контроль, который читает весь файл. Проверьте статус выхода и сообщения.

**Обновление пакета Python и проверка его версии**

```bash
python -m pip install -U --pre "yt-dlp[default,curl-cffi]"
python -m yt_dlp --version
```

- [Диагностика 403 по этапу](https://flashdata.dev/ru/docs/guides/yt-dlp-403-forbidden/reference.md)
- [429: метаданные и ограничения запросов](https://flashdata.dev/ru/docs/guides/yt-dlp-429-too-many-requests/reference.md)
- [Диагностика бот-чека ответа](https://flashdata.dev/ru/docs/guides/yt-dlp-sign-in-not-a-bot/reference.md)
- [Полный upstream опционный референт](https://github.com/yt-dlp/yt-dlp#usage-and-options)
