yt-dlp: как установить и скачать видео с YouTube по правилам

Друг прислал название "yt-dlp" и сказал "это качает видео с YouTube", а дальше - тишина: ни с чего начать, ни что можно скачивать по правилам. Ниже - установка на Windows, macOS и Linux, рабочие команды для видео, звука и субтитров, и честная граница между личным использованием инструмента и условиями обслуживания YouTube.

Что такое yt-dlp

По сути yt-dlp - это одна команда в терминале (программе, где вводишь текстовые команды вместо кликов мышью). Устанавливается один раз, после этого скачивание видео сводится к yt-dlp плюс ссылка на страницу.

Официальные источники:

• репозиторий: github.com/yt-dlp/yt-dlp
• пакет на PyPI: pypi.org/project/yt-dlp
• подробная инструкция по установке: github.com/yt-dlp/yt-dlp/wiki/Installation

Как установить yt-dlp на Windows, macOS и Linux

1. Выбрать способ установки

   Если у тебя уже стоит Python 3.10 или новее, самый простой путь - pip. Если не хочешь разбираться с Python вообще, скачай готовый бинарник. На macOS, если установлен Homebrew, можно поставить одной командой через него.

2. Установить через pip (Windows, macOS, Linux)

   В терминале или PowerShell выполни:

   bash

   Скопировать

   python -m pip install -U "yt-dlp[default]"

   Эта команда ставит стабильную версию вместе с дополнительными зависимостями ([default]). Нужен Python 3.10+ (CPython) или PyPy 3.11+. Для более свежей, но менее проверенной nightly-сборки используется флаг --pre: python -m pip install -U --pre "yt-dlp[default]".

3. Установить через Homebrew (macOS)

   Если на компьютере есть Homebrew, выполни:

   bash

   Скопировать

   brew install yt-dlp

4. Скачать бинарник без Python (Windows)

   На странице релизов github.com/yt-dlp/yt-dlp/releases/latest скачай нужный файл:

   • Windows: yt-dlp.exe (отдельный исполняемый файл, Python не нужен)
   • macOS: yt-dlp_macos (отдельный исполняемый файл, Python не нужен)
   • Linux: yt-dlp_linux (отдельный исполняемый файл, Python не нужен) или yt-dlp без расширения, если Python уже есть в системе

   Положи файл в отдельную папку, добавь её в PATH или просто запускай команды из этой папки, указывая полный путь к файлу.

5. Поставить ffmpeg

   Для скачивания аудио отдельно от видео, объединения отдельных видео- и аудио-потоков в один файл и других операций после скачивания нужен ffmpeg. Без него часть команд из следующего раздела работать не будет.

   Готовые сборки ffmpeg от проекта yt-dlp: github.com/yt-dlp/FFmpeg-Builds. Либо через менеджер пакетов системы.

6. Проверить установку

   bash

   Скопировать

   yt-dlp --version

   Если команда не найдена - новый терминал: PATH подхватывается после перезапуска окна.

Шаги выше ставят инструмент. Дальше вопрос в том, как выстроить вокруг таких инструментов весь рабочий процесс - этим занимается практикум СмыслоКода.

Интенсив по Hermes-агентам

Собери свою компанию на ИИ-агентах

Три вечера: от метода одного агента до связки ролей в компании

Старт 6–8 октября  ·  2 000 ₽

Записаться на интенсив по Hermes-агентам →

Какие команды нужны для базовых сценариев

Скачать видео целиком в лучшем доступном качестве:

yt-dlp "ССЫЛКА_НА_ВИДЕО"

Скачать только звук в формате mp3 (нужен ffmpeg):

yt-dlp -x --audio-format mp3 "ССЫЛКА_НА_ВИДЕО"

Посмотреть список доступных форматов и качеств перед скачиванием:

yt-dlp -F "ССЫЛКА_НА_ВИДЕО"

Скачать в конкретном качестве по коду формата из списка -F:

yt-dlp -f 137+140 "ССЫЛКА_НА_ВИДЕО"

Скачать субтитры вместе с видео (здесь - русские):

yt-dlp --write-subs --sub-langs ru "ССЫЛКА_НА_ВИДЕО"

Обновить сам yt-dlp, если он поставлен бинарником с GitHub Releases:

yt-dlp -U

Что можно скачивать с YouTube, а что нарушает условия сервиса

Сам yt-dlp - универсальный инструмент, он технически умеет скачивать с любой страницы, которую поддерживает. Вопрос не в инструменте, а в условиях конкретного сайта. У YouTube они написаны прямо.

Условия обслуживания YouTube запрещают:

Это означает: скачивание чужого защищённого видео без разрешения - нарушение условий соглашения с Google.

Случаи, которые YouTube явно называет разрешёнными:

• Собственные загруженные видео. По справке YouTube, собственные видео можно скачать как MP4 в 720p или 360p - качество зависит от размера видео. Чужие видео так скачать нельзя.
• Видео с лицензией Creative Commons Attribution (CC BY). По справке YouTube, автор может присвоить своему видео такую лицензию, если материалы подходят под условия CC BY: это свои оригинальные материалы, материалы, уже выпущенные под CC BY, или материалы в общественном достоянии (кроме видео с Content ID claim - им такую лицензию присвоить нельзя). Такая лицензия разрешает другим переиспользовать работу на условиях CC BY с указанием авторства.

Если видео не твоё и не имеет лицензии Creative Commons Attribution - по условиям ToS его скачивание требует отдельного разрешения сервиса, письменного согласия YouTube и правообладателей, либо прямого разрешения применимого закона.

Для чего это нужно нетехническому вайб-кодеру

Легальный сценарий для тех, кто строит продукты с помощью ИИ-агентов: скачать собственное видео с демонстрацией продукта для локальной обработки, собрать архив материалов с лицензией CC BY для проекта или вытащить субтитры из своего же выступления, чтобы отдать текст в ИИ-инструмент для конвертации документов. Так получаешь файл на диске, с которым работает любой локальный инструмент - в отличие от ссылки на страницу, которую сервис может закрыть или изменить.

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

Что проверить, если что-то пошло не так

• yt-dlp не найден после установки - открой новое окно терминала: PATH подхватывается после перезапуска.
• Скачивание аудио или объединение видео с отдельным аудиопотоком не работает - проверь, установлен ли ffmpeg: ffmpeg -version.
• yt-dlp ругается на неподдерживаемую версию Python - нужен Python 3.10 или новее (CPython) либо PyPy 3.11+.
• Скачивание идёт медленно или обрывается - сначала попробуй yt-dlp -U (для бинарника с GitHub Releases).

Что дальше

Поставь yt-dlp тем способом, который подходит твоей системе, и попробуй на своём собственном загруженном видео - так сразу увидишь, что команда работает, без риска нарушить условия сервиса. Если интересует, какими платными и бесплатными инструментами пользоваться для других задач вайб-кодинга - разбор есть в статье чем оплатить инструменты вайб-кодинга из России. Дальше, если работаешь с текстом из видео или документов, пригодится разбор MarkItDown: конвертация документов в текст для ИИ, а если присылаешь готовый код в проект - как проверить код от ИИ, не будучи программистом.

Интенсив по Hermes-агентам

Собери свою компанию на ИИ-агентах

Три вечера: от метода одного агента до связки ролей в компании

Старт 6–8 октября  ·  2 000 ₽

Записаться на интенсив по Hermes-агентам →

Новые материалы - дайджестом, без спама

Гайды выходят регулярно. Подпишись, чтобы не пропускать: пришлю подборку в Telegram или на email. Раз в неделю или каждый день - выбираешь сам.

Подписаться в Telegramили на email