Генератор команд yt-dlp для Bilibili

Соберите команду yt-dlp для Bilibili, начиная с притворства браузером, которое снимает большинство ошибок 403.

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

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

Ваша команда

yt-dlp -f 'bv*[height<=1080]+ba/b[height<=1080]' --merge-output-format mp4 --no-playlist --impersonate chrome --cookies-from-browser chrome https://www.bilibili.com/video/BV1xx411c7mD

Основное

Что вам нужно

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

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

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

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

Сбросить

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

Притворяться браузером --impersonate Делает запросы похожими на настоящий браузер. Обычное решение, когда внезапно начинается 403.
Cookies из браузера --cookies-from-browser Читает вашу авторизованную сессию напрямую. Нужно для приватного, возрастного и доступного только участникам содержимого.
Максимальное качество -f Ограничивает высоту. yt-dlp всё равно выберет лучшую дорожку в пределах этого ограничения.

Ещё нет yt-dlp?

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

Ошибки 403 и ограничения по качеству

Bilibili отклоняет запросы, которые не похожи на браузерные, — поэтому простая команда часто возвращает 403. В этом наборе притворство включено сразу, потому что в большинстве случаев именно оно и решает дело.

1080p и выше обычно оставляют для авторизованных, иногда платных аккаунтов, так что здесь cookies влияют на качество, а не только на доступ. Многочастные видео появляются как элементы плейлиста.

Bilibili — платформа, где устаревший yt-dlp ломается быстрее всего — сайт перекраивает свой API чаще любой западной платформы, и обновления extractor приезжают в релизы yt-dlp в считаные дни после каждого изменения. Когда загрузка, работавшая в прошлом месяце, начинает падать, сначала обновитесь: yt-dlp -U. Притворство браузером (в этом наборе включено по умолчанию) закрывает «браузероподобные заголовки» в проблеме 403; остальное — обычно отсутствующая или истёкшая сессия.

Многочастные загрузки — привычная для серий структура P1/P2/P3 — приходят элементами плейлиста, поэтому обработка целого плейлиста забирает каждую часть, а номер плейлиста в шаблоне вывода держит части по порядку. Данмаку (прокручивающиеся комментарии) для yt-dlp — дорожка субтитров: --write-subs сохраняет их файлом .ass, и это единственный формат, в котором они существуют. Не нужны — не делайте ничего: без запроса они не подмешиваются.

Интерактивные качества — «долби» и премиум-ступени — существуют только у аккаунтов, владеющих ими, и без cookies такого аккаунта ни один флаг до них не доберётся. Региональный замок — другая стена: некоторые загрузки видны только из материкового Китая, и когда блок исполняется на CDN, а не на странице, прокси внутри региона — единственная дорога. Geo-обход иногда работает для блока на уровне страницы и никогда — для CDN.

Bilibili отдаёт свои высокие качества как DASH с отдельным аудио, так что ffmpeg объединяет, как и для YouTube, — шаг объединения уже встроен в этот набор. Извлечение только звука через -x работает и является самым быстрым способом взять звук из долгой многочастной загрузки. Повторы live после конца трансляции становятся обычным VOD — скачивайте как любое видео; опции live-записи на этом сайте — для трансляции, пока она идёт.

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

› Почему Bilibili возвращает 403?

Bilibili отклоняет запросы, не похожие на браузерные. --impersonate chrome помогает в большинстве случаев; для содержимого только для участников добавьте cookies.

› Как получить 1080p и выше с Bilibili?

Более высокие разрешения оставляют для авторизованных, иногда платных аккаунтов. Используйте --cookies-from-browser с таким аккаунтом.

› Как забрать все части многочастного видео?

Поставьте обработку плейлиста на «весь плейлист» — части отдаются как элементы плейлиста.