Yt-dlp на примерах. Бесплатное скачивание видео и аудио.

Если вы когда-то использовали сервисы и приложения для скачивания видео из YouTube, Twitch, TikTok или Vimeo - можете быть уверены, многие из них используют под капотом yt-dlp или его родителя youtube-dl. Эта программа также используется во многих готовых решениях для онлайн кинотеатров, например в KVS, и на сайтах xxx тематики.
yt-dlp - это продвинутый, активно развивающийся форк проекта youtube-dl, позволяющий скачивать видео и аудио из множества ресурсов в сети интернет.

Почему yt-dlp лучше youtube-dl

1. Активная поддержка. Одной из главных причин создания yt-dlp является замедленный темп развития youtube-dl. yt-dlp ведут активное обновление ПО, быстро подстраиваясь под изменения медиа-хостингов;
2. Скорость загрузки. yt-dlp поддерживает параллельную загрузку фрагментов медиафайлов, что позволяет значительно увеличить скорость скачивания по сравнению с youtube-dl;
3. Проработанный выбор форматов. yt-dlp увеличил возможности фильтрации видео и аудио форматов. Мы продемонстрируем это в примерах далее;
4. Работа с YouTube. Утилита заточена для работы с актуальными возможностями и форматами площадки YouTube. Поддерживает работу с Shorts, плейлистами, премьерами, трансляциями и многим другим;
5. Поддержка SponsorBlock. yt-dlp умеет определять рекламные интеграции, вступления, заставки и концовки, а также удалять эти фрагменты видео;
6. Постобработка. Благодаря работе с ffmpeg, после загрузки контента yt-dlp может обработать файл: извлечь аудио, конвертировать, встроить субтитры, изменить метаданные;
7. Работа с cookies. yt-dlp умеет автоматически импортировать cookies напрямую из браузеров;
8. Продвинутая система шаблонов. yt-dlp увеличил возможности работы с шаблонами имен файлов;
9. Новые кодеки. yt-dlp обновляет список поддерживаемых кодеков, вслед за медиапорталами, и поддерживает большинство современных популярных кодеков.

yt-dlp можно рассматривать как современную замену youtube-dl. Проект сохраняет обратную совместимость с большинством команд оригинальной утилиты, но предлагает множество улучшений и оптимизаций.

Установка

В официальной документации рекомендуют использовать команду, которая установит yt-dlp в директорию текущего пользователя:
curl -L https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -o ~/.local/bin/yt-dlp
chmod a+rx ~/.local/bin/yt-dlp
Так как мы работаем на сервере, нам необходимо сделать исполняемый файл доступным для всех программ и пользователей, поэтому выполним команды:
curl -L https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -o /usr/local/bin/yt-dlp
chmod a+rx /usr/local/bin/yt-dlp
Команда curl скачивает исполняемый файл в директорию /usr/local/bin/. chmod устанавливает права на выполнение.

Установка ffmpeg

Для того чтобы раскрыть все возможности yt-dlp необходимо также установить ffmpeg. Сборка ffmpeg - это отдельная тема для статьи. Проще всего сделать это из репозиториев системы.
На Debian/Ubuntu:
apt update
apt install ffmpegНа AlmaLinux/Rocky Linux/CentOS Stream:
dnf install epel-release
dnf install ffmpeg ffmpeg-devel
На Arch Linux:
pacman -S ffmpegНа macOS:
brew install ffmpegУвидеть результат можно выполнив команду:

Обновление

Для обновления yt-dlp используйте команду:
yt-dlp -UЕсли используется актуальная версия, вы получите сообщение:

Основные команды

Возможности yt-dlp обширны. Рассмотрим самые популярные команды yt-dlp на практических примерах.

Скачать видео или аудио

yt-dlp URLСамая простая команда, в результате вы получаете готовый файл:

Это также может быть и аудио:

Выбор формата

Для просмотра всех вариантов доступных к скачиванию видео и аудио дорожек используется команда:
yt-dlp -F URLДля YouTube вывод может быть обширным. Обратите внимание на то, что в выводе доступны как видеодорожки, так и аудио, а также превью (storyboard).

Скачать ролик в выбранном качестве:
yt-dlp -f 401+140 URL

• 401, 140 - ID выбранного видео и аудио формата (в примере mp4 3840x2160 и m4a 44k).

Можно не выбирать конкретные форматы, а скачать ролик в лучшем качестве в формате mp4:
yt-dlp -f "bestvideo[ext=mp4]+bestaudio[ext=m4a]" URL
Либо скачать его с кодеком H.264:
yt-dlp -f "bv[vcodec*=avc]+ba" URL

• bv - короткая запись bestvideo;
• ba - короткая запись bestaudio;
• avc - кодек H.264.

Работа с аудио

Извлечь аудио из видеоролика можно с помощью команды:
yt-dlp -x URLВ случае с YouTube мы получим аудиодорожку в формате, который использует видеохостинг:

Чтобы сразу конвертировать файл в формат mp3 необходимо добавить параметр --audio-format:
yt-dlp -x --audio-format mp3 URL
Усовершенствуем команду, чтобы скачивать аудио с максимально доступным качеством, добавив параметр --audio-quality:
yt-dlp -x --audio-format mp3 --audio-quality 0 URLПоддерживаемые форматы:

• opus
• m4a
• wav
• mp3
• vorbis
• flac
• aac

Плейлисты

Чтобы скачать весь плейлист, команда не отличается от одного видео:
yt-dlp URLУсовершенствуем её, чтобы скачать все видео в максимальном качестве в формате mp4:
yt-dlp -f "bestvideo[ext=mp4]+bestaudio[ext=m4a]" URLУтилита по очереди скачает все видео плейлиста в текущую директорию:

Ограничить скачивание тремя первыми видео из плейлиста:
yt-dlp -f "bestvideo[ext=mp4]+bestaudio[ext=m4a]" --playlist-end 3 URLВывод команд на скриншотах обрезан:

Каналы

Скачать все или некоторые видео канала можно аналогичной командой:
yt-dlp -f "bestvideo[ext=mp4]+bestaudio[ext=m4a]" --playlist-end 30 URLУтилита скачает первые 30 роликов указанного канала в максимальном качестве в формате mp4.

Субтитры

Просмотр списка доступных субтитров к видео:
yt-dlp --list-subs URLВ списке будут как автоматические субтитры (список может быть очень длинным), так и добавленные:

Скачать видео с английскими субтитрами:
yt-dlp --write-subs --sub-langs en URL

• en - язык субтитров.

Результат выполнения команды - два файла: видео и файл субтитров формата .vtt:

Чтобы скачать автоматически созданные субтитры, используйте параметр --write-auto-subs:
yt-dlp --write-auto-subs --sub-langs de URL
Вы можете обратить внимание, что на скриншоте мы используем ещё некоторые параметры, для обхода блокировки ботов от YouTube. --sleep-interval и --max-sleep-interval задают границы времени, которое yt-dlp будет ждать между запросами. В примере - случайное количество секунд от 3 до 7.

Работа с Cookies

Отличительная особенность yt-dlp - это продвинутая работа с cookies. Если вы используете программу на личном устройстве, вы можете автоматически подгрузить куки из используемого браузера:
yt-dlp --cookies-from-browser chrome URL

• chrome - браузер, в котором есть авторизация на запрашиваемом сайте.

На сервере можно использовать заранее подготовленный файл с куки в формате Netscape, как было показано ранее:
yt-dlp --cookies cookies.txt URL

Заключение

yt-dlp является универсальным современным решением для автоматизации загрузки контента из большинства актуальных медиа-хостингов.
Гибкая настройка, поддержка многопоточного скачивания, работа с субтитрами и форматами, интеграция с ffmpeg, простота использования сделали эту утилиту популярным инструментом как среди обычных пользователей, так и среди разработчиков и администраторов.
Если вы регулярно работаете с видео и аудио или создаёте собственный медиапроект, знание основных возможностей yt-dlp поможет автоматизировать рутинные задачи и сэкономить значительное количество времени.