Что такое yt-dlp?
yt-dlp — это консольный загрузчик аудио и видео, поддерживающий значительно больше тысячи сайтов. Он начинался как форк youtube-dl (через ныне заброшенный youtube-dlc) и с тех пор стал активно развиваемым проектом из этих двух: с гораздо более мощным выбором форматов, интеграцией SponsorBlock, встроенной поддержкой внедрения субтитров, глав и метаданных, а также системой плагинов для собственных экстракторов.
⚡ Ключевые возможности yt-dlp
🌐 Тысячи сайтов
Более 1700 экстракторов для видеоплатформ, телеканалов, подкаст-хостингов и новостных сайтов, плюс универсальный экстрактор, который находит медиа даже там, где отдельного экстрактора никто не писал.
🎚️ Точный выбор формата
-f и -S дают полноценный язык выражений по разрешению, кодеку, битрейту и контейнеру, так что вы получаете именно нужный поток, а не тот, что идёт по умолчанию.
🎧 Извлечение аудио
-x --audio-format mp3 вытаскивает звуковую дорожку и перекодирует её, а --embed-thumbnail и --embed-metadata дают файлы с тегами, понятные любому плееру.
💬 Субтитры и главы
Скачивайте или внедряйте субтитры на любом доступном языке, сохраняйте автоматические, записывайте метки глав прямо в файл — или режьте файл по ним.
⏭️ SponsorBlock
Помечайте или удаляйте рекламные вставки, интро и самопродвижение прямо при загрузке, опираясь на базу SponsorBlock, — без последующего монтажа.
🍪 Cookies и сессии
--cookies-from-browser читает авторизованную сессию прямо из Firefox или Chromium, поэтому работают приватные, возрастные и доступные только подписчикам материалы.
apt upgrade держит вас на последней версии.
📦 Установка из deb.griffo.io
Шаг 1: Добавить репозиторий
sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | sudo gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | sudo tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
sudo apt updateinstall -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
apt updateШаг 2: Установить yt-dlp
# Установить последнюю версию yt-dlp
sudo apt install yt-dlp
# Проверить установку
yt-dlp --version# Установить последнюю версию yt-dlp
apt install yt-dlp
# Проверить установку
yt-dlp --versionШаг 3: Установить ffmpeg (настоятельно рекомендуется)
# yt-dlp нужен ffmpeg, чтобы объединять отдельные видео- и аудиопотоки,
# извлекать звук и внедрять субтитры или обложки
sudo apt install ffmpeg
# Автодополнения для bash, zsh и fish идут вместе с пакетом —
# настраивать нечего. Откройте новую оболочку и нажмите Tab:
yt-dlp --embed-<Tab>
# Страница руководства тоже устанавливается
man yt-dlp# yt-dlp нужен ffmpeg, чтобы объединять отдельные видео- и аудиопотоки,
# извлекать звук и внедрять субтитры или обложки
apt install ffmpeg
# Автодополнения для bash, zsh и fish идут вместе с пакетом —
# настраивать нечего. Откройте новую оболочку и нажмите Tab:
yt-dlp --embed-<Tab>
# Страница руководства тоже устанавливается
man yt-dlp🎯 Базовые примеры использования
Повседневная загрузка:
# Скачать видео в наилучшем доступном качестве
yt-dlp 'https://example.com/watch?v=...'
# Лучший MP4 вплоть до 1080p
yt-dlp -S 'res:1080,ext:mp4' 'URL'
# Только звук, в виде MP3 с тегами
yt-dlp -x --audio-format mp3 --embed-thumbnail --embed-metadata 'URL'
# Посмотреть все доступные форматы перед выбором
yt-dlp -F 'URL'Субтитры, главы и реклама:
# Внедрить английские субтитры, включая автоматические
yt-dlp --embed-subs --sub-langs en --write-auto-subs 'URL'
# Записать метки глав в файл
yt-dlp --embed-chapters 'URL'
# Убрать рекламные вставки и интро прямо при загрузке
yt-dlp --sponsorblock-remove sponsor,intro 'URL'
# Взять только фрагмент вместо всего видео
yt-dlp --download-sections '*00:01:30-00:04:00' 'URL'Плейлисты, архивы и автоматизация:
# Целый плейлист, в аккуратные папки по авторам
yt-dlp -o '%(uploader)s/%(title)s.%(ext)s' 'PLAYLIST_URL'
# Держать канал в актуальном состоянии, не перекачивая старое
yt-dlp --download-archive seen.txt 'CHANNEL_URL'
# Приватный или возрастной контент через авторизованную сессию браузера
yt-dlp --cookies-from-browser firefox 'URL'
# Более быстрые загрузки через aria2c
yt-dlp --downloader aria2c --downloader-args aria2c:'-x 8 -s 8' 'URL'🔧 Интеграция с другими инструментами
yt-dlp — это тот загрузчик, на который рассчитывает множество другого ПО:
- ffmpeg: объединение, ремукс, извлечение звука и внедрение данных идут через него
- mpv: воспроизводит ссылку напрямую, передавая её yt-dlp на лету
- aria2: необязательный внешний загрузчик для параллельной сегментированной закачки
- Медиасерверы: библиотеки Jellyfin, Kodi и Navidrome часто наполняются по шаблонам вывода yt-dlp
- Файлы конфигурации: положите привычные опции в
~/.config/yt-dlp/configи перестаньте их набирать
🚀 Почему стоит выбрать deb.griffo.io?
- Официальный Debian: доступен, но заморожен на версии, вышедшей вместе с релизом, — на месяцы отстаёт по исправлениям экстракторов
- pip / pipx: свежая версия, но вне apt, а PEP 668 делает системный
pip installв Debian неудобным - deb.griffo.io: последняя версия с автоматическими обновлениями
- ✅ Рабочие экстракторы: самый свежий выпуск — именно от него зависит, продолжат ли загрузки работать
- ✅ Без ручной настройки: ни pip, ни virtualenv, ни самообновления, пишущего в
/usr/local/bin - ✅ Автоматические обновления: пакеты обновляются в течение часов после выхода версии
- ✅ Полный пакет: официальная сборка проекта, страница руководства
yt-dlp.1и автодополнения для bash, zsh и fish - ✅ Любая архитектура: пакет собран как
Architecture: all, поэтому amd64, arm64, armhf, riscv64 и остальные ставят один и тот же пакет - ✅ Много дистрибутивов: работает на Bookworm, Trixie, Forky и Sid
- ✅ Простое обслуживание: обновления обычными командами apt
📦 Репозиторий сборки пакета
Пакеты для Debian собираются и поддерживаются автоматически в этом репозитории GitHub:
- 📺 yt-dlp-debian - Сборки последних выпусков
🔗 Похожие пакеты
Также доступны в deb.griffo.io:
- termusic - Консольный музыкальный плеер для всего, что вы скачали
- lowfi - Минималистичный lofi-радиоплеер
- viu - Просмотр обложек и изображений в терминале
- Yazi - Консольный файловый менеджер для вашей коллекции