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

Соберите команду yt-dlp для видео из Facebook — вместе с опциями cookies, которые нужны большинству из них.

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

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

Ваша команда

yt-dlp -f 'bv*[height<=1080]+ba/b[height<=1080]' --merge-output-format mp4 --no-playlist --cookies-from-browser chrome 'https://www.facebook.com/watch/?v=1234567890'

Основное

Что вам нужно

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

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

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

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

Сбросить

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

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

Что учесть с Facebook

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

Если результат кажется хуже того, что вы видели в браузере, сначала выведите список форматов: набор, доступный вашей сессии, обычно короче того, которым пользуется веб-плеер.

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

› Может ли yt-dlp скачать приватные видео из Facebook?

Только те, которые ваш аккаунт и так может видеть, — через --cookies-from-browser. Обойти отсутствующее у вас право невозможно.

› Без cookies Facebook возвращает ошибку.

Значительная часть Facebook недоступна без входа. Передайте свою сессию через --cookies-from-browser chrome, закрыв при этом браузер.

› Почему качество хуже, чем в браузере?

Facebook отдаёт версии повыше только части сессий. Посмотрите через -F, что доступно по этому адресу, и передайте cookies, если список короткий.