Скачивание плейлистов — генератор команд yt-dlp

Соберите команду yt-dlp для целого плейлиста: с нумерацией, с возможностью продолжить и так, чтобы один сломанный элемент не остановил всё.

URL видео, плейлиста или канала

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

Ваша команда

yt-dlp -f 'bv*[height<=1080]+ba/b[height<=1080]' --merge-output-format mp4 --yes-playlist -I 1-10 --download-archive archive.txt -o '%(playlist_index)02d - %(title)s.%(ext)s' -i 'https://www.youtube.com/playlist?list=PLxxxxxxxx'

Основное

Что вам нужно

Видео Только звук

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

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

Максимальное качество -f

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

Container --merge-output-format нужен ffmpeg

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

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

Свой format selector -f

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

Remux в --remux-video нужен ffmpeg

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

Перекодировать в --recode-video нужен ffmpeg

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

Аудио

Формат аудио --audio-format нужен ffmpeg

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

Качество звука --audio-quality нужен ffmpeg

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

Субтитры

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

Языки субтитров --sub-langs

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

Автоматические субтитры --write-auto-subs Включать машинные субтитры, когда человеческих нет.

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

Обработка плейлиста

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

Какие элементы -I

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

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

Файл учёта --download-archive

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

Фрагменты и главы

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

Скачать только часть --download-sections нужен ffmpeg

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

Разбить по главам --split-chapters нужен ffmpeg Пишет по файлу на главу вместо одного длинного.

Метаданные и обложка

Встроить обложку --embed-thumbnail нужен ffmpeg Использует превью видео как обложку.

Встроить метаданные --embed-metadata нужен ffmpeg Записывает название, автора и дату внутрь самого файла.

Встроить главы --embed-chapters нужен ffmpeg Добавляет метки глав, по которым плеер умеет перескакивать.

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

Сохранить файл обложки --write-thumbnail Пишет картинку обложки рядом с видео.

Сохранить описание --write-description Пишет описание в файл .description.

Сохранить метаданные в JSON --write-info-json Пишет всё, что yt-dlp знает о видео, в файл .info.json.

SponsorBlock

Удалить фрагменты --sponsorblock-remove нужен ffmpeg

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

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

Отметить фрагменты главами --sponsorblock-mark

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

Файлы и папки

Шаблон имени файла -o

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

Безопасные имена (только ASCII) --restrict-filenames Убирает диакритику, пробелы и любые символы, которые может отвергнуть придирчивая файловая система.

Перезаписывать существующие файлы --force-overwrites Заменяет файлы, которые уже есть.

Продолжать незавершённые загрузки -c Продолжает с того места, где загрузка прервалась.

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

Папка для загрузки -P

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

Имена, безопасные для Windows --windows-filenames Убирает символы, которые Windows не принимает, даже если вы работаете в другой системе.

Обрезать имена до --trim-filenames

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

Никогда не перезаписывать -w Пропускает всё, что уже скачано.

Фильтры

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

Загружено после --dateafter

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

Загружено до --datebefore

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

Минимальный размер --min-filesize

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

Максимальный размер --max-filesize

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

Остановиться после --max-downloads

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

Сеть

Ограничение скорости -r

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

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

Параллельных fragment -N

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

Повторные попытки -R

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

Proxy --proxy

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

Обход региональной блокировки --geo-bypass Подменяет источник запроса. На части сайтов работает, но не на всех.

Притворяться браузером --impersonate

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

Вход и cookies

Cookies из браузера --cookies-from-browser

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

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

Файл cookies --cookies

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

Прямые трансляции

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

Записывать с начала --live-from-start Начинает запись трансляции с начала, а не с текущего момента.

Ждать начала трансляции --wait-for-video

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

Обходные пути

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

User agent --user-agent устарело

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

Referer --referer устарело

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

Аргументы extractor --extractor-args

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

Вывод и отладка

Только показать форматы -F Печатает доступные форматы и завершает работу без скачивания.

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

Продолжать при ошибках -i Пропускает неудавшиеся элементы вместо остановки. Для больших плейлистов это обязательно.

Пробный прогон -s Делает всё, кроме записи файла.

Сбросить

Опции, которые здесь важны

Обработка плейлиста Что делать, когда URL относится и к видео, и к плейлисту.
Какие элементы -I Работают и диапазоны, и списки — например 1-10,15 или -5::2, чтобы брать каждый второй с конца.
Шаблон имени файла -o Названия полей пишутся внутри %(...)s. Слэши создают папки.
Файл учёта --download-archive Записывает уже скачанное, поэтому повторный запуск это пропустит. Именно так канал держат синхронизированным.

Две опции, которые действительно важны

Файл учёта записывает каждый завершённый элемент, поэтому повторный запуск той же команды скачивает только недостающее. На длинном плейлисте и медленном канале это разница между «продолжить» и «начать заново».

Вторая — продолжать при ошибках. Плейлисты со временем набирают удалённые, приватные и заблокированные по региону элементы, и без этой опции первый такой элемент прерывает весь запуск. Нумерованный шаблон сохраняет порядок плейлиста.

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

› Как скачать только часть плейлиста?

Используйте выбор элементов: 1-10 для первых десяти, 1,3,7-10 для смешанного набора, -5::2 — каждый второй с конца.

› Как продолжить прерванное скачивание плейлиста?

С файлом учёта. Он записывает каждый завершённый элемент, поэтому повторный запуск той же команды скачивает только недостающее.

› Одно видео не скачалось — и всё остановилось.

Включите «продолжать при ошибках». Удалённые, приватные и заблокированные по региону элементы будут пропускаться, а не прерывать весь запуск.

› Как сохранить порядок плейлиста в именах файлов?

Добавьте в шаблон номер в плейлисте: %(playlist_index)02d - %(title)s.%(ext)s. Часть 02d дописывает ноль до двух знаков, чтобы файлы сортировались правильно.