Перейти к содержимому
yt-dlp

Скачивание 4K-видео — генератор команд yt-dlp

Соберите команду yt-dlp для видео 2160p, сохранив главы и метаданные.

Необязательно. Если оставить пустым, команда закончится словом URL, которое вы подставите сами.

Ваша команда

yt-dlp -f 'bv*[height<=2160]+ba/b[height<=2160]' --merge-output-format mkv --no-playlist --embed-metadata --embed-chapters -N 4 'https://www.youtube.com/watch?v=dQw4w9WgXcQ'
Основное

Только звук извлекает звуковую дорожку и отбрасывает видео.

Видео и качество

Ограничивает высоту. yt-dlp всё равно выберет лучшую дорожку в пределах этого ограничения.

Тип файла, в который объединяются раздельные видео- и аудиодорожки.

Дополнительные опции (3)

Заменяет выбор качества. Для тех, кто уже знает синтаксис форматов.

Перепаковывает дорожки без перекодирования. Быстро и без потерь.

Перекодирует видео. Медленно и с потерями — только если remux не подходит.

Аудио

Файл, в который конвертируется звук.

VBR даёт лучшее соотношение размера и качества; фиксированный bitrate предсказуемее по размеру.

Субтитры

Встраивание помещает субтитры внутрь видео; сохранение пишет рядом отдельный файл .srt.

Через запятую. Если нужны все доступные языки, напишите all.

Плейлисты и каналы

Что делать, когда URL относится и к видео, и к плейлисту.

Работают и диапазоны, и списки — например 1-10,15 или -5::2, чтобы брать каждый второй с конца.

Дополнительные опции (1)

Записывает уже скачанное, поэтому повторный запуск это пропустит. Именно так канал держат синхронизированным.

Фрагменты и главы
Дополнительные опции (2)

Диапазон времени вида *00:01:30-00:03:00 или название главы. Звёздочка в начале означает, что это метка времени.

Метаданные и обложка
Дополнительные опции (3)
SponsorBlock

Вырезает из файла фрагменты, отмеченные сообществом, по данным SponsorBlock.

Дополнительные опции (1)

Оставляет фрагменты, но помечает их, чтобы вы пропускали их сами.

Файлы и папки

Названия полей пишутся внутри %(...)s. Слэши создают папки.

Дополнительные опции (4)

Куда писать файлы. В сочетании с шаблоном выше можно получить подпапки.

Максимальная длина имени файла в символах.

Фильтры
Дополнительные опции (5)

ГГГГММДД или относительная дата вида now-1month.

ГГГГММДД или относительная дата.

Пропускает всё, что меньше. Принимает 5M, 500K и подобное.

Пропускает всё, что больше.

Сколько файлов скачать, прежде чем остановиться.

Сеть

Например 2M или 500K. Полезно, когда остальная полоса нужна для другого.

Дополнительные опции (5)

Ускоряет фрагментированные потоки. Четыре — разумное начало.

Сколько раз повторять неудавшуюся часть. Можно указать infinite.

Адрес HTTP, HTTPS или SOCKS proxy.

Делает запросы похожими на настоящий браузер. Обычное решение, когда внезапно начинается 403.

Вход и cookies

Читает вашу авторизованную сессию напрямую. Нужно для приватного, возрастного и доступного только участникам содержимого.

Дополнительные опции (1)

Файл cookies.txt в формате Netscape, выгруженный из вашего браузера.

Прямые трансляции
Дополнительные опции (2)

Опрашивает, пока запланированная трансляция не начнётся. MIN-MAX — интервал между проверками в секундах.

Обходные пути
Дополнительные опции (3)

Устарело в пользу --add-headers. Оставлено потому, что множество старых руководств всё ещё это используют.

Устарело в пользу --add-headers.

Опции для конкретного сайта, например youtube:player_client=web.

Вывод и отладка
Дополнительные опции (2)
Сбросить

Что на самом деле нужно для 4K

На 2160p видео и звук всегда идут отдельными потоками, поэтому для объединения обязателен ffmpeg. MKV — более надёжный container: MP4 не вмещает часть кодеков, в которых отдают 4K, и попытка его навязать заставляет yt-dlp перекодировать — медленно, с потерями, и именно так обычно теряются метаданные HDR.

Если 4K не появляется, скорее всего видео в таком разрешении никогда и не загружали. Прежде чем решить, что команда неверна, выведите список форматов. Рассчитывайте на несколько гигабайт в час и используйте ограничение размера или диапазон времени, если это проблема.

Выбор контейнера — это решение по HDR. 4K HDR приходит в кодеках — VP9.2, AV1 — которые MP4 не всегда может нести, и принуждение MP4 заставляет yt-dlp перекодировать: часы работы, видимая потеря качества, и метаданные HDR пропали. MKV держит всё как есть; этот набор по умолчанию берёт MKV именно поэтому. SDR-плеер проигрывает HDR-файл выцветшим — это плеер, а не файл, и правильная конвертация HDR в SDR — работа фильтра, а не флага.

Полоса — где 4K перестаёт быть теорией: 2160p при приличном битрейте идёт 40–90 ГБ на час материала, и параллельные fragment выжимают скорость до предела связи — и это ровно то, что триггерит ограничение скорости платформы. Если запуск замедлился до ползания, ополовиньте число fragment и дайте ему идти дольше; 4K-файл достаточно велик, чтобы медленно закончить всё ещё бить перезапуск. Опция лимита размера существует, чтобы остановить сорвавшийся с места запуск раньше, чем это сделает диск.

Главы и метаданные — где архив 4K оправдывает себя: двухчасовой фильм без глав — один файл, с ними — навигируемый. SponsorBlock интегрируется и здесь — спонсорские отрезки размечаются на 4K-контенте так же, как на любом другом, и пропуск их на файле длиной с фильм экономит больше времени, чем на чём-либо покороче. Встройте миниатюру как обложку, иначе медиатека покажет пустую плитку для каждого 4K-файла.

Чего 4K не может: увеличивать. Источник 1080p, ограниченный вверх, остаётся 1080p — ограничение это максимум, и yt-dlp без жалоб выбирает лучший поток на уровне или ниже. Если -F не показывает ничего выше 1080p, это всё, что загрузчик дал платформе. Настоящие 4K-источники на YouTube обычно VP9 или AV1, которые старые GPU декодируют программно — медленный плеер часто вопрос кодека, а не файла, и MKV оставляет исходный кодек нетронутым.

Частые вопросы

Почему для этого видео нет 4K?
Его не загружали в 4K, либо платформа ограничивает эту версию. Прежде чем решить, что команда неверна, посмотрите через -F, что вообще есть.
Какой container использовать для 4K?
MKV вмещает любое сочетание кодеков. MP4 совместимее, но не вмещает часть кодеков 4K, и тогда yt-dlp приходится перекодировать — медленно и с потерями.
Сколько весит скачивание в 4K?
Часто несколько гигабайт в час. Если это важно, задайте максимальный размер или диапазон времени.
HDR сохраняется?
Да, если он есть в источнике. Сохраняйте исходный кодек — перекодирование как раз и уничтожает метаданные HDR.