yt-dlp: Сучасний форк youtube-dl для завантаження відео

23 жовтня 2020 року Асоціація звукозаписної індустрії Америки подала на GitHub скаргу на youtube-dl згідно із законом DMCA. Через три дні, 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: ланцюжок fork з 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, явним зобов'язанням щодо публічного надбання, яке не використовують навіть більшість проектів FOSS. Репозиторій має 13 348 форків та 2507 відкритих проблем. Ubuntu 22.04 замінив youtube-dl на yt-dlp як завантажувач відео за замовчуванням, а Debian наслідував його як bookworm. Список supported-sites у `supportedsites.md` наразі містить понад 1500 іменованих записів; сама кодова база постачається з майже 1800 модулями екстрактора з відкладеним завантаженням. Arch, Fedora, NixOS, Homebrew, Chocolatey, Scoop та Winget – всі вони пакують його. Двадцять-тридцять випусків на рік – це те, що запобігало поверненню дистрибутивів до повільнішого апстріму.

Як закриття RIAA у 2020 році зробило yt-dlp неминучим

Повідомлення RIAA від 23 жовтня 2020 року щодо DMCA було подано відповідно до 17 USC § 1201, пункту про заборону обходу. Його теорія полягала в тому, що youtube-dl обійшов механізм підпису YouTube «ковзним шифром», який RIAA окреслила як технологічний захід захисту доступу до творів, захищених авторським правом. GitHub спочатку виконав вимогу та видалив репозиторій разом із сімнадцятьма форками.

Далі відбувався хрестоматійний ефект Стрейзанд. Розробники повторно опублікували вихідний код дедалі винахідливішими способами, зокрема за допомогою зображення з Твіттера, кольори пікселів якого кодували всю кодову базу. Фонд електронних рубежів (Electronic Frontier Foundation) надіслав листа до GitHub 16 листопада 2020 року. Його технічне обґрунтування було простим. Підпис, який може запускати будь-який браузер, що відповідає стандартам, не є «технологічним заходом, що ефективно контролює доступ» у рамках § 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-and-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 роках

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

PoToken — більший. Тепер для кожного відеозапиту потрібен токен підтвердження походження (Proof-of-Origin Token). Токен прив’язаний до відео, його термін дії швидко закінчується та він також прив’язаний до сеансу. Ручне видобування перестало працювати кілька місяців тому. Що працює, так це невеликий помічник під назвою `bgutil-ytdlp-pot-provider`, який працює збоку; він генерує токени на вимогу, а основний виклик yt-dlp автоматично їх отримує. У вікі-версії yt-dlp є посібник під назвою «Посібник з PO Token», який інструкції з налаштування. Без помічника запити повертаються зі зниженим рейтингом або просто блокуються, а yt-dlp може працювати неправильно навіть з відео, які відтворювалися у вашому браузері тридцять секунд тому.

SABR – це друга частина. SABR – це адаптивний бітрейт на стороні сервера YouTube, і до 2025 року `web` extractor почав повертати формати лише SABR, які порушують звичайний шлях завантаження. Виправлення зазвичай полягає в підказці extractor-args плюс файли cookie з браузера, в який увійшов користувач. Варто переглянути теми, поки виправлення дозріває, – це проблеми №12482, №14307, №14390, №16082 та №13968. Кінцевий результат: yt-dlp все ще працює з переважною більшістю публічного контенту YouTube, але у 2026 році команда «just works» часто є командою «постачальник PoToken, нові файли cookie та трохи терпіння».

Правовий статус yt-dlp у 2026 році: США, Німеччина, ЄС

Юридична відповідь — юрисдикційна, а заголовок — що ще нічого остаточно не вирішено.

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

У Німеччині справа стосувалася відповідальності хостингу, а не самого програмного забезпечення. Вищий регіональний суд Гамбурга відхилив апеляцію Uberspace, майнцського хостера `youtube-dl.org`, 27 листопада 2024 року. Це рішення остаточно закріпило рішення суду нижчої інстанції від 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 традиційно позначав `yt-dlp.exe`, упакований з PyInstaller, як `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 за допомогою своєї системи плагінів охоплює нішеві джерела, а 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.