yt-dlp: Современная версия youtube-dl для скачивания видео.

23 октября 2020 года Ассоциация звукозаписывающей индустрии Америки (RIAA) подала иск в соответствии с Законом об авторском праве в цифровую эпоху (DMCA) против проекта youtube-dl на GitHub. Три дня спустя, 26 октября, незаметно появился новый репозиторий по адресу github.com/yt-dlp/yt-dlp. К тому времени, когда GitHub восстановил оригинальный проект 16 ноября — вместе с новым фондом защиты разработчиков в размере 1 миллиона долларов — новый форк уже начал поглощать участников проекта youtube-dl.

Этот форк теперь является основным. По состоянию на май 2026 года yt-dlp регистрирует более 12 миллионов загрузок на PyPI в месяц. Его репозиторий на GitHub имеет 160 766 звезд. Проект выпускает новые релизы примерно каждые две недели. Последний тег на момент написания — `2026.03.17`. Он поддерживает более 1800 видео- и аудиосайтов через свою систему плагинов-экстракторов. Далее следует честный обзор того, что представляет собой yt-dlp и как его использовать. А также его юридическое положение в 2026 году. И почему идеально работающая установка может внезапно перестать работать в середине 2025 года.

Откуда взялся yt-dlp: цепочка ответвлений от youtube-dl

Здесь важна история происхождения, поскольку она объясняет разрыв в поведении. yt-dlp выпускает исправления в течение нескольких часов после сбоя на YouTube; youtube-dl может потребоваться несколько недель. Три проекта находятся на генеалогическом древе, и каждый шаг был обусловлен разочарованием в предыдущем.

youtube-dl был оригинальным проектом. Рикардо Гарсия написал его в августе 2006 года, а Филипп Хагемайстер позже возглавил его в тесной группе под названием `ytdl-org/youtube-dl`. К 2020 году он стал де-факто инструментом архивирования, но запросы на слияние накапливались, и исправления для YouTube поступали с задержкой.

Именно этот пробел и привел к появлению youtube-dlc, где «c» означало «сообщество». `blackjack4494` создал форк репозитория в 2020 году, и очередь слияния была очищена за несколько дней. Сам форк стал полунеактивным в конце того же года — один из сопровождающих находится в уязвимом положении.

yt-dlp — это форк проекта youtube-dlc. Репозиторий был создан 26 октября 2020 года, через три дня после того, как RIAA удалила исходный проект youtube-dl. yt-dlp — это инструмент командной строки, позволяющий загружать видео и аудио с поддерживаемых веб-сайтов. Буква «p» обозначает одного из первых ведущих сопровождающих (`pukkandan`). В настоящее время проектом управляет организация, объединяющая несколько сопровождающих, включая `coletdjnz`, `dirkf`, `Grub4K`, `bashonly` и `seproDev`. К январю 2021 года yt-dlp поглотил базу участников youtube-dlc. Он стал доминирующим форком youtube-dl. Основное внимание было уделено функциям и улучшениям, которые исходный проект не был интегрирован.

Стоит отметить несколько фактов на уровне проекта. yt-dlp использует календарное версионирование, поэтому тег типа `2026.03.17` — это буквально дата релиза. Лицензия — The Unlicense, явное обязательство о передаче в общественное достояние, которое даже большинство проектов с открытым исходным кодом не используют. В репозитории 13 348 форков и 2507 открытых проблем. Ubuntu 22.04 заменила youtube-dl на yt-dlp в качестве загрузчика видео по умолчанию, а Debian последовала её примеру с bookworm. Список поддерживаемых сайтов в `supportedsites.md` в настоящее время содержит более 1500 именованных записей; сам код содержит около 1800 модулей-экстракторов с отложенной загрузкой. Arch, Fedora, NixOS, Homebrew, Chocolatey, Scoop и Winget — все они используют его в своих пакетах. Двадцать-тридцать релизов в год — вот что удерживало дистрибутивы от возвращения к более медленному исходному коду.

Как удаление релиза RIAA в 2020 году сделало yt-dlp неизбежным

Уведомление RIAA от 23 октября 2020 года в соответствии с DMCA было подано согласно статье 1201 раздела 17 Кодекса США, которая запрещает обход авторских прав. Теория заключалась в том, что youtube-dl обошел механизм подписи «скользящего шифра» YouTube, который RIAA представила как технологическую меру защиты доступа к произведениям, защищенным авторским правом. GitHub первоначально выполнил требование и удалил репозиторий вместе с семнадцатью форками.

За этим последовал классический эффект Стрейзанд. Разработчики перепостили исходный код всё более изобретательными способами, включая изображение в Твиттере, цвета пикселей которого кодировали весь код. 16 ноября 2020 года Фонд электронных границ направил GitHub письмо. Его техническое обоснование было простым. Подпись, которую может запустить любой браузер, соответствующий стандартам, не является «технологической мерой, эффективно контролирующей доступ» в соответствии с § 1201. youtube-dl использует эту подпись; он её не взламывает.

В тот же день GitHub восстановил репозиторий. Компания также выделила 1 миллион долларов на защиту разработчиков и обязалась впредь проводить ручную техническую и юридическую проверку каждого случая удаления контента в соответствии со статьей 1201. Этот эпизод послужил толчком к созданию yt-dlp. Репозиторий нового форка появился в истории коммитов через три дня после удаления. Пока никто не знал, отступит ли GitHub. Разработчики хотели подстраховаться.

Установите yt-dlp на Windows, macOS и Linux.

Люди забывают о второй половине установки, а потом удивляются, почему этап слияния завершается с ошибкой. yt-dlp сам по себе может получить один поток с любого из поддерживаемых сайтов, это точно. Но лучшее видео плюс лучшее аудио? Встроенные главы? Ремукс mp4? Всё это незаметно передаётся `ffmpeg` и `ffprobe`. Пропустите эти два инструмента, и ваша первая попытка `bv*+ba/b` выдаст что-то непонятное и завершится ошибкой. Поэтому: устанавливайте оба инструмента каждый раз.

Для Windows я выбираю winget. `winget install yt-dlp.yt-dlp`, затем `winget install Gyan.FFmpeg`. Scoop работает, если вы его уже используете; Chocolatey тоже. Если менеджер пакетов кажется излишним, автономный файл `yt-dlp.exe` находится в GitHub Releases — просто поместите его в папку, добавьте папку в PATH, и готово.

Пользователям Mac доступна простая версия. `brew install yt-dlp ffmpeg`. Одна строка. И всё.

В Linux ситуация различается в зависимости от дистрибутива. В Debian он поставляется из основного архива. Arch хранит его в `extra`. Fedora получает его через стандартные каналы. Проблема в сроках: когда появляется ошибка на YouTube, версии дистрибутивов обычно отстают на несколько дней. Выход из ситуации — установка Python, которая является лучшим способом загрузки видео в тот же день после исправления: `python -m pip install -U yt-dlp` на любой системе с Python 3.9 или новее. Эта строка также обновляет систему на месте. Опция curl и chmod по-прежнему присутствует в документации (`sudo curl -L https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -o /usr/local/bin/yt-dlp && sudo chmod +x /usr/local/bin/yt-dlp`), но используйте её только тогда, когда нет опции в менеджере пакетов.

После установки команда `yt-dlp -U` обновляет копии pip и бинарных файлов; она намеренно пропускает копии, созданные менеджером пакетов. Выберите один метод установки и придерживайтесь его. Сочетание ffmpeg и ffprobe является обязательным.

Основные команды yt-dlp, которые вы будете использовать на практике.

Краткий список команд невелик. Базовая команда `yt-dlp URL` работает только в самых распространенных случаях. Все остальное — это один или два флага.

Прежде чем загрузить видео с YouTube, запустите `yt-dlp -F URL`, чтобы посмотреть, что доступно. В выводе будут перечислены все форматы видео, все аудиопотоки и все предварительно объединенные потоки, найденные экстрактором, а также кодеки и размеры файлов. Большинство пользователей затем сразу переходят к `yt-dlp -f "bv*+ba/b" URL`. Этот селектор означает «лучшее видео плюс лучшее аудио, в случае, если они не разделены, используется лучший объединенный поток». Это флагманский синтаксис выбора формата в yt-dlp, и его стоит запомнить. Добавьте `--merge-output-format mp4`, чтобы принудительно выбрать контейнер; добавьте `-x --audio-format mp3` для выбора только аудио. Для субтитров `--write-subs --sub-langs en` использует официальные субтитры, а `--write-auto-subs` использует автоматически сгенерированную дорожку, если нет подсказок от человека.

Для списков `-a urls.txt` считывает один URL-адрес на строку и является стандартным способом загрузки нескольких видео за один раз. Флаг `--playlist-items 1-10,15,20-` разделяет плейлист. А `--download-archive seen.txt` хранит запись о завершенных загрузках, поэтому при повторных запусках пропускаются уже загруженные файлы. Архив загрузок — это самый удобный способ загрузки целых плейлистов и каналов пошагово без повторной загрузки. Именование выходных файлов осуществляется по шаблону. Строка `-o "%(channel)s/%(upload_date>%Y-%m-%d)s — %(title)s.%(ext)s"` создает файлы с датированными именами, сгруппированными по каналам, в выбранной вами папке. Результат удобен для библиотек Plex и Jellyfin. Флаг `-P` изменяет целевой каталог. Флаг `--restrict-filenames` сохраняет имена файлов в формате ASCII для обеспечения безопасности при работе с различными файловыми системами. А параметр `--print filename` позволяет предварительно просмотреть текст, который yt-dlp выведет на экран перед началом процесса загрузки.

Если при загрузке происходит "воспроизведение вместо скачивания", это означает, что ваш браузер открывает ссылку до того, как её увидит yt-dlp. Передайте URL-адрес в качестве прямого аргумента или заключите его в кавычки и запустите yt-dlp из терминала.

Функции для опытных пользователей: постпроцессоры, SponsorBlock, cookie.

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

Интеграция со SponsorBlock полезна. Эта опция использует базу данных сообщества SponsorBlock. Она либо отмечает маркеры глав, либо полностью удаляет разделы со спонсорами из видео на YouTube. Опция `--cookies-from-browser` считывает файлы cookie из профилей браузеров, включая контейнеры Firefox, что является самым чистым способом загрузки чего-либо, находящегося за платным доступом или авторизацией. Для терабайтов длительно хранящихся архивов передача внешнего загрузчика в aria2c заметно повышает скорость загрузки в сетях, где узким местом является оконная обработка TCP. А опция `--split-chapters` разделяет видеоконтент по главам на отдельные файлы, что удобно, когда одна загрузка объединяет несколько докладов. yt-dlp также поддерживает `--video-multistreams` для объединения видеодорожек, если сайт предоставляет несколько, хотя это редко встречается в реальных условиях.

Система плагинов заслуживает отдельной строки. yt-dlp автоматически обнаружит модули Python, расположенные в `~/.yt-dlp/plugins/` (или установленные через `pip` с точкой входа `yt-dlp-plugins`), и загрузит их в качестве экстракторов или постпроцессоров. Таким образом обеспечивается поддержка нестандартных сайтов без ожидания патча от разработчика. Также таким образом подключаются плагины PoToken-провайдеров, описанные ниже.

Ситуация с PoToken и SABR в 2025-2026 годах

В 2025 году YouTube усложнил работу yt-dlp. Два изменения стали причиной того, что даже идеально работающая установка внезапно начала давать сбои в 2026 году.

PoToken — более крупная технология. Теперь для каждого запроса видео требуется токен подтверждения происхождения (Proof-of-Origin Token). Токен привязан к видео, быстро истекает и также привязан к сессии. Ручное извлечение перестало работать несколько месяцев назад. Работает небольшой вспомогательный модуль под названием `bgutil-ytdlp-pot-provider`; он генерирует токены по запросу, и основной вызов yt-dlp автоматически их получает. В вики yt-dlp есть руководство под названием PO Token Guide, которое описывает настройку. Без этого вспомогательного модуля запросы возвращаются с пониженным уровнем или просто блокируются, и yt-dlp может работать некорректно даже с видео, которые воспроизводились в вашем браузере тридцать секунд назад.

SABR — это вторая составляющая. SABR — это адаптивный битрейт на стороне сервера YouTube, и до 2025 года веб-экстрактор начал возвращать форматы, поддерживающие только SABR, что нарушает обычный путь загрузки. Решение обычно заключается в подсказке в параметрах экстрактора плюс cookie-файлы из браузера, в котором выполнен вход в систему. Стоит следить за обсуждениями по мере разработки решения: #12482, #14307, #14390, #16082 и #13968. В итоге: yt-dlp по-прежнему работает с подавляющим большинством общедоступного контента YouTube, но в 2026 году команда, которая "просто работает", часто будет означать "поставщик PoToken, новые cookie-файлы и немного терпения".

Правовой статус yt-dlp в 2026 году: США, Германия, ЕС.

Юридический ответ кроется в юрисдикции, и суть в том, что окончательного решения по этому вопросу пока нет.

В Соединенных Штатах ни один суд не вынес конкретного решения по делу yt-dlp. Ближайшим прецедентом является инцидент с RIAA в 2020 году, который завершился внесудебным решением. Окончательное правило 9-го трехгодичного периода, принятое Бюро по авторским правам США в соответствии с разделом 1201, вступило в силу 28 октября 2024 года и будет действовать до 28 октября 2027 года. Оно продлило действие ранее действовавших исключений и добавило одно для исследований надежности ИИ, но не создало общего исключения для обхода защиты при личном архивировании видео. Структурная проблема раздела 1201, заключающаяся в том, что он криминализирует инструменты, затрагивающие DRM, независимо от намерений, остается.

В Германии дело касалось ответственности хостинг-провайдеров, а не самого программного обеспечения. 27 ноября 2024 года Высший региональный суд Гамбурга отклонил апелляцию Uberspace, хостинг-провайдера сайта `youtube-dl.org` из Майнца. Это решение завершило постановление суда низшей инстанции от 2023 года, согласно которому хостинг-провайдеры могут нести ответственность за сайты, рекламирующие инструменты обхода защиты. Эта доктрина напрямую не запрещает yt-dlp, но делает немецкий хостинг рискованным для любого проекта, который открыто рекламирует возможности обхода защиты.

На уровне ЕС Закон о цифровых услугах стандартизирует процедуры уведомления и принятия мер по удалению контента (статьи 16–17), но не регулирует программное обеспечение для скачивания. В ЕС нет общеевропейского постановления, обязывающего хостинг-провайдеров блокировать yt-dlp. Личное использование yt-dlp для собственного контента не является юридическим основанием для применения закона ни в одной из этих юрисдикций. То же самое относится к контенту, на который создатель дал разрешение. Проблемы возникают при распространении и взаимодействии с системами защиты потокового вещания.

Графические интерфейсы пользователей и более широкая экосистема загрузчиков.

Не всем нужен терминал, и командная строка yt-dlp не является его сильной стороной в маркетинге. yt-dlp — один из многих загрузчиков видео, но он работает как основной движок большинства современных графических интерфейсов для загрузки видео. Stacher — наиболее отполированный кроссплатформенный графический интерфейс. Tartube — альтернатива на Python/GTK. yt-dlg — это форк, созданный специально для yt-dlp. Tube-Archivist — это саморазмещаемый Docker-сервер для архивирования каналов; он может загружать видео с различных веб-сайтов по расписанию. YTDL-Material — это саморазмещаемый веб-интерфейс. ytdl-sub — это декларативный инструмент конфигурации YAML, популярный среди пользователей Plex и Jellyfin. JDownloader 2 интегрирует yt-dlp через плагин. Каждый инструмент предоставляет свой собственный интерфейс выбора видео и панель параметров загрузки, но основная работа выполняется yt-dlp.

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

Безопасность: где скачать yt-dlp и как распознать подделки.

Единственными безопасными источниками являются релизы GitHub, PyPI (`pip install yt-dlp`), официальные дистрибутивы и основные менеджеры пакетов Windows (Winget, Scoop, Chocolatey). Сторонние сайты, распространяющие «загрузчики yt-dlp», содержат рекламное ПО, майнеры или модифицированные бинарные файлы. Windows Defender исторически помечал упакованный с помощью PyInstaller файл `yt-dlp.exe` как `Trojan:Win32/Wacatac.B!ml` (проблемы #7532 и #15415). Это эвристические ложные срабатывания. Базы данных сигнатур обычно очищаются в течение нескольких дней. Небольшие проекты с открытым исходным кодом, такие как yt-dlp, существуют благодаря волонтерам-разработчикам. Криптовалютные пожертвования через платежные шлюзы, такие как Plisio, являются одним из способов получения поддержки для международных участников, устойчивых к дебанковским операциям.

Один из примеров. Допустим, вы хотите загрузить видео с YouTube на свой компьютер для презентации. Команда выглядит так: `yt-dlp -f "bv*+ba/b" --merge-output-format mp4 URL`, которая выдает правильный формат для загрузки. yt-dlp — это форк с большим количеством экстракторов, чем youtube-dl, и в yt-dlp есть множество инструментов, позволяющих загрузить видео, если оригинал не работает. yt-dlp, используя свою систему плагинов, охватывает нишевые источники, и позволяет использовать `-a urls.txt`, когда вам нужно загрузить видео с различных веб-сайтов. Все, что поддерживается yt-dlp, указано в файле `supportedsites.md`.

Elisabeth McGowan

A freelance writer passionate about celebrities, net worth stories, athletes, and political figures. She transforms facts into engaging narratives. A true cheese lover and cycling enthusiast, she finds inspiration in motion and flavor.