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

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

Канонічне посилання: https://flashdata.dev/uk/docs/guides/yt-dlp-commands
Переглянуто: 2026-11-13 від FlashData

- [Відео й аудіо](https://flashdata.dev/uk/docs/guides/yt-dlp-commands/reference.md#video) — Кваліфікація, кодек і MP3
- [Капції та метадані](https://flashdata.dev/uk/docs/guides/yt-dlp-commands/reference.md#subtitles) — Стрижка та структурований вихід
- [Збірки та відновлення](https://flashdata.dev/uk/docs/guides/yt-dlp-commands/reference.md#archives) — Списки, архіви та конфігурації
- [Діагностика невдачі](https://flashdata.dev/uk/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/uk/docs/guides/how-to-use-yt-dlp/reference.md#install)
- [Створення повторно використовуваної конфігурації колекції](https://flashdata.dev/uk/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/uk/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/uk/docs/guides/how-to-use-yt-dlp/reference.md#dataset)
- [Екваліфіковані Python Dataset](https://flashdata.dev/uk/docs/guides/yt-dlp-python-api/reference.md#dataset)

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

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


**2 Зв'язки, корінні 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"
```

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 і порівнюйте той же джерело і прокси маршрут.

- [Контроль зв'язку та діагноз проходження](https://flashdata.dev/uk/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"
```

en.* може відповідати кількома англійськими варіантами. це отримує доступні сходи; він не виконує розпізнавання мови.

**Перетворення вибраних стовпів на 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/uk/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 об'єкт за вхід. Флатові входи можуть пропустити тривалість і форматні деталі.

**Завантажити перші 5 записів в списку**

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

Додайте обмеження працівника рівня ковбасу, коли кілька процесів ділиться маршрутом або сесією.

**Передача пропускного діапазону**

```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 ідентифікатори після успішних завантажень. Це не каталог вихідних налаштувань або перевірка того, що файл все ще існує. Зберігайте окремі архіви для аудіо, відео та кліп політики, і не вкажіть невдалу роботу завершено з --force-write-archive.

- [Перезавантаження та відновлення процедури](https://flashdata.dev/uk/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>

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


**Використовуйте профіль браузера, який має доступ**

```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 не є еквівалентом.

**Використовуйте дено-ікутувальний за межами робочого патру**

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

Усуває implicit config і не зберігає жодних засобів масової інформації. вона все ще робить запити на видобуток і не доводить, що перехід буде успішним.

**Завантажити приватний діагностичний запис**

```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/uk/docs/guides/yt-dlp-403-forbidden/reference.md)
- [429: метаданни та обмеження запиту](https://flashdata.dev/uk/docs/guides/yt-dlp-429-too-many-requests/reference.md)
- [Діагностика бот-чеку відповіді](https://flashdata.dev/uk/docs/guides/yt-dlp-sign-in-not-a-bot/reference.md)
- [Повний список опціонів Upstream](https://github.com/yt-dlp/yt-dlp#usage-and-options)
