Как скачать видео с YouTube в Debian 12: полная инструкция с yt-dlp

Если вы когда-нибудь пытались сохранить ролик с YouTube на Debian 12, то наверняка сталкивались с ситуацией: вставляешь ссылку, а в ответ — куча красного текста, ERROR 400 и слова про «Precondition check failed». Знакомо?

Спойлер: дело не в вашем интернете и не в блокировках. Дело в том, что Debian поставляет слишком старую версию yt-dlp. И сейчас я покажу, как это исправить за 5 минут.

Почему перестало работать?

Debian 12 — очень стабильная система. Это хорошо для серверов, но плохо для программ, которые зависят от YouTube. Потому что YouTube меняется каждый месяц, а версия yt-dlp в репозиториях Debian — от 2023 года.

Команда sudo apt install yt-dlp ставит версию 2023.03.04. Она просто не понимает современный YouTube.

Решение: ставим свежую версию с GitHub.

Пошаговая инструкция: как скачать видео с YouTube на Debian 12

Всё делается в терминале. Никаких сложных настроек.

Шаг 1. Удаляем старую версию программы yt-dlp

sudo apt remove --purge yt-dlp
sudo apt autoremove

Шаг 2. Скачиваем актуальный yt-dlp с GitHub

sudo wget https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -O /usr/local/bin/yt-dlp

Шаг 3. Даём права на запуск

sudo chmod a+rx /usr/local/bin/yt-dlp

Шаг 4. Делаем так, чтобы команда yt-dlp работала везде

sudo ln -sf /usr/local/bin/yt-dlp /usr/bin/yt-dlp

Шаг 5. Проверяем

yt-dlp --version

Если вы видите свежую дату (например, 2026.03.03 или новее) — всё готово. Можно качать.

🎥 Как скачать видео с YouTube: примеры команд

Вот самые полезные команды, которые вам точно пригодятся.

🔹 Просто скачать видео

yt-dlp "https://www.youtube.com/watch?v=Xod5C2aIW58"

🔹 Скачать только аудио (MP3)

Хотите сохранить музыку с YouTube? Легко:

yt-dlp -x --audio-format mp3 "https://www.youtube.com/watch?v=Xod5C2aIW58"

🔹 Выбрать качество

Сначала смотрим, какие форматы доступны:

yt-dlp -F "https://www.youtube.com/watch?v=Xod5C2aIW58"

Потом скачиваем, например, видео 1080p и аудио:

yt-dlp -f 137+140 "https://www.youtube.com/watch?v=Xod5C2aIW58"

Примечание: коды форматов (137, 140) вы узнаете из предыдущей команды. У разных видео они могут отличаться.

🔹 Скачать плейлист целиком

yt-dlp "https://www.youtube.com/playlist?list=PL..."

🔹 Скачать с субтитрами

yt-dlp --write-subs --sub-lang ru "https://www.youtube.com/watch?v=Xod5C2aIW58"

🌐 Важно для пользователей из России

Да, YouTube в России заблокирован. yt-dlp — не панацея, он не обходит блокировки сам по себе.

Если хотите скачивать видео:

• Включите VPN на весь компьютер, а не только в браузере
• Или используйте прокси (подробнее — в документации yt-dlp)

Без этого программа будет падать с ошибками соединения.

🔄 А что, если снова перестанет работать?

Такое бывает. YouTube обновляется часто. Если через месяц-два yt-dlp снова начнёт ругаться на ошибки — просто обновите его:

sudo yt-dlp -U

Это скачает свежую версию поверх текущей.

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

Вопрос: После установки команда yt-dlp не находится. Что делать?
Ответ: Выполните hash -r или перезапустите терминал. Или используйте полный путь: /usr/local/bin/yt-dlp

Вопрос: А можно оставить старую версию?
Ответ: Можно, но она не работает с YouTube. Смысла нет.

Вопрос: Это безопасно? Ставить программы с GitHub?
Ответ: yt-dlp — открытый проект с тысячами звёзд. Ссылка выше — официальный релиз.

📌 Коротко: что нужно запомнить

1. Встроенный в Debian 12 yt-dlp слишком старый
2. Свежую версию ставим вручную с GitHub
3. Один раз настроили — забыли про проблемы
4. Если сломается — обновляем через sudo yt-dlp -U

🧠 А нужен ли вам вообще yt-dlp?

Если вы просто смотрите YouTube онлайн — не нужен. Но если вы:

• сохраняете видео на будущее
• делаете подборки музыки
• хотите смотреть ролики офлайн (в метро, на даче без интернета)
• скачиваете лекции или курсы

— тогда эта программа для вас. И теперь вы знаете, как заставить её работать.

Понравилась инструкция? Сохраните себе или поделитесь с теми, кто тоже мучается с ошибками yt-dlp на Linux.