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

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

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

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

Ваша команда

yt-dlp -f 'bv*[height<=1080]+ba/b[height<=1080]' --merge-output-format mp4 --yes-playlist --download-archive archive.txt -o '%(uploader)s/%(upload_date>%Y-%m-%d)s - %(title)s.%(ext)s' --dateafter 20240101 -i https://www.youtube.com/@channel/videos

Основное

Что вам нужно

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

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

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

Максимальное качество -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 Делает всё, кроме записи файла.

Сбросить

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

Файл учёта --download-archive Записывает уже скачанное, поэтому повторный запуск это пропустит. Именно так канал держат синхронизированным.
Загружено после --dateafter ГГГГММДД или относительная дата вида now-1month.
Шаблон имени файла -o Названия полей пишутся внутри %(...)s. Слэши создают папки.
Продолжать при ошибках -i Пропускает неудавшиеся элементы вместо остановки. Для больших плейлистов это обязательно.

Ещё нет yt-dlp?

Это бесплатная программа, которая работает на вашем компьютере. Установка занимает около минуты.

Как правильно архивировать канал

Указывайте вкладку /videos канала, а не его корень: в корне есть Shorts и вкладки трансляций, которые вы, вероятно, не имели в виду. Когда файл учёта на месте, регулярный запуск той же команды забирает только новые загрузки.

Фильтры по дате не дают первому запуску разрастись на канале с десятилетним архивом. Если начинается ограничение скорости — добавьте лимит и уменьшите число параллельных fragment: скачивание сотен видео на максимальной скорости и есть причина такого ограничения.

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

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

Возьмите адрес videos канала в режиме «весь плейлист». Добавьте файл учёта и «продолжать при ошибках» — на большом канале необходимы оба.

› Как держать канал в актуальном состоянии?

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

› Как пропустить Shorts?

Указывайте вкладку /videos, а не корень канала — тогда вкладки Shorts и трансляций в список не попадут.

› На больших каналах меня ограничивают по скорости.

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