Локальный загрузчик видео и музыки на Flask и yt-dlp: устройство, защита сервера и замеры
Онлайн-«качалки» видео знакомы всем: поле для ссылки, три баннера, кнопка «Скачать», которая оказывается рекламой, и в итоге файл в плохом качестве или вообще ничего. Для себя я давно использую yt-dlp, но объяснять родственникам, как ставить Python, ffmpeg и набирать команды в консоли, бессмысленно. Поэтому я сделал обёртку: небольшая программа для Windows, которая запускается ярлыком, открывает страницу в браузере и всё скачивает на самом компьютере, без чужих серверов. Ниже не реклама, а заметки о том, как это устроено, от чего пришлось защищаться и, раз сайт железячный, цифры по ресурсам.

Что внутри
Программа состоит из трёх частей:
- yt-dlp достаёт ссылки на потоки с сайтов (их больше тысячи) и качает;
- ffmpeg склеивает видео со звуком, делает MP3 и сжимает;
- Flask, сервер на 127.0.0.1:8765, отдаёт интерфейс и принимает команды. Интерфейс — обычная страница в браузере, поэтому отдельного окна и тяжёлого GUI-фреймворка нет.
Рядом с часами живёт значок (pystray) с меню «Открыть», «Папка загрузок», «Выход». Для YouTube нужен ещё Deno: без него сайт отдаёт не все качества, потому что подпись ссылок считается скриптом на странице плеера.
Установка без системного Python
Самая неприятная часть для обычного пользователя — окружение. Я решил, что системный Python вообще не нужен. Архив с программой весит 225 КБ: в нём только мои файлы. При первом запуске скрипт установки start.ps1 докачивает остальное в папку программы:
- встроенный (embeddable) Python 3.12.10 с python.org;
- pip и пакеты из requirements.txt: yt-dlp, flask, imageio-ffmpeg (оттуда берётся ffmpeg.exe), deno, pystray, pillow.
Раз скрипт тянет исполняемые файлы из сети, я постарался сделать это без доверия «на слово». SHA-256 архива Python и колеса pip зашиты прямо в скрипт, у python.exe и python312.dll проверяется цифровая подпись Python Software Foundation, а сборка идёт во временной папке python.new и переименовывается целиком. Недоделанной установки, которую потом не отличить от рабочей, не бывает: либо всё на месте, либо ничего.
У встроенного Python есть своя особенность: он работает в изолированном режиме, каталог скрипта не попадает в sys.path, а переменные PYTHON* игнорируются. Чтобы он видел мои модули, в файле python312._pth пришлось добавить строку .. и вернуть import site. На этом я потерял целый вечер, потому что ошибка выглядела как «нет модуля sites», хотя файл лежал рядом.
Сервер на localhost — не значит безопасно
Раз сервер слушает свой компьютер, кажется, что бояться нечего. На деле любая страница в вашем браузере может отправить запрос на 127.0.0.1:8765. Чужой сайт мог бы, например, запустить скачивание или поменять папку загрузок. Есть и более изящная атака, DNS rebinding: домен злоумышленника, который указывает на 127.0.0.1, и браузер считает такой запрос «своим». Поэтому перед каждым запросом работает проверка:
@app.before_request
def only_own_page():
if request.host.lower() not in LOCAL_HOSTS: # DNS rebinding
return Response('Forbidden', 403)
if not request.path.startswith('/api/'):
return None
origin = request.headers.get('Origin')
if (origin and origin not in LOCAL_ORIGINS) or \
request.headers.get('Sec-Fetch-Site') in ('cross-site', 'same-site'):
return jsonify(error='Request from another page.'), 403
if request.method == 'POST' and not request.is_json: # форма с чужого сайта JSON не шлёт
return jsonify(error='JSON required.'), 415
return None
Разрешён только свой Host, к /api/ пускают запросы без чужого Origin и без Sec-Fetch-Site: cross-site, а POST принимает только JSON: такой запрос с чужой страницы браузер без разрешения CORS не отправит. Запросы без этих заголовков (curl, тесты, проверка «уже запущено») проходят: браузер заголовки добавляет всегда, а скрипту на чужом сайте их не убрать. Плюс X-Frame-Options, чтобы страницу не встроили в рамку, и Referrer-Policy: no-referrer.
Отдельная мелочь про имена файлов. Название ролика приходит с чужого сайта, и yt-dlp делает из него имя файла. Плейлист, названный «..», сохранялся уровнем выше папки загрузок, а имена вроде CON и NUL в Windows — это устройства. Для этого написан небольшой постобработчик, который правит поля и проверяет, что итоговый путь лежит внутри выбранной папки.
Фоновая работа без мигающих окон
Программа запускается ярлыком без окна консоли. Очевидный путь — pythonw.exe, но я выбрал обычный python.exe со спрятанной консолью. Причина в дочерних процессах: ffmpeg и deno унаследуют скрытую консоль и не будут на каждую загрузку мигать чёрным окном, а от pythonw они получили бы собственное.
Копия на порт запускается одна: в самом начале app.py, до тяжёлых импортов, берётся мьютекс с номером порта. Второй запуск не плодит вкладки, а просит уже работающую программу показать страницу; если страница уже открыта, она мигает заголовком.
Прослушивание перед скачиванием
В программе есть поиск музыки на YouTube, SoundCloud и Rutube и плеер, чтобы послушать песню до скачивания. Это оказалось сложнее, чем я думал. Ссылки googlevideo привязаны к IP и заголовкам, поэтому поток приходится проксировать через собственный Flask с поддержкой Range, иначе в элементе audio не перемотать. Целиком YouTube отдаёт медленно, так что у сайта запрашиваются куски по 10 МБ. Ссылка YouTube первые ~5 секунд отвечает 403, пока не наступит время, с которого формат «доступен»; программа ждёт его, как это делает сам yt-dlp. У SoundCloud и Rutube прямых потоков нет, там только HLS, поэтому песня целиком скачивается во временную папку, и оттуда отдаётся обычным файлом.

Сайты, которые yt-dlp не берёт
Часть сайтов yt-dlp либо не знает, либо его разборщик сломан. Для них в sites.py лежат свои, и они ставятся на место встроенных: одноимённый ключ в реестре экстракторов заменяет оригинал. Так добавлены ЯП файлы и темы yaplakal.com, Одноклассники (формат метаданных поменялся с JSON-строки на объект), видеоэфиры, DTF и vc.ru, d3.ru. Отдельно стоит страховка для общего разборщика: если на странице ничего не нашлось, он заходит в iframe плеера на один уровень, с Referer страницы.
Есть и принципиальный отказ. Некоторые сайты (например, Suno) yt-dlp не поддерживает намеренно, по юридическим причинам, и обходить это я не стал: программа прямо говорит, что здесь скачать нельзя.
Сжатие и вырезка куска
Кнопка «Сжать» у скачанного ролика перекодирует его в H.265 командой ffmpeg с libx265 -preset fast -crf 26 -tag:v hvc1, звук копируется. Процесс запускается с приоритетом ниже обычного, чтобы не мешать работе, очередь строго по одному. Если выигрыш меньше 5%, сжатый файл удаляется, а исходник остаётся в любом случае. Тег hvc1 нужен, чтобы файл нормально воспроизводился в Windows и на телефонах, а CRF 26 при пресете fast даёт приемлемое время на обычном процессоре без выделенного железа.
Вырезка куска «с–до» в интерфейсе убрана по просьбе (API остался), но по пути я нашёл забавную вещь: без force_keyframes_at_cuts MP3 из куска выходил на ~10 секунд длиннее заказанного.
Сколько это стоит в ресурсах
Раз я утверждаю, что программа лёгкая, надо проверить. Стенд: Windows 10 Enterprise LTSC 2021, версия программы 1.5.1, yt-dlp 2026.10.26, встроенный Python 3.12.10. Тестовая копия запущена на отдельном порту без значка в трее и без браузера (вкладка с интерфейсом — это уже ваш браузер, и в таблицу она не входит). Замер памяти через 20 секунд после старта, затем 30 секунд наблюдения за процессорным временем. Загрузка — ролик «Me at the zoo» (19 секунд, 360p) с YouTube.
| Показатель | Значение |
|---|---|
| Старт до ответа API | ≈ 2,9 с (два запуска подряд: 2,95 и 2,95) |
| Процессов в простое | 1 (python.exe) |
| Рабочий набор / приватная память в простое | 74 МБ / 64 МБ |
| Процессорное время за 30 с простоя | 0 с (счётчик не сдвинулся) |
| Загрузка ролика 360p, 19 с | 4–4,7 с, файл 0,6 МБ |
| Пик памяти во время загрузки, все процессы из папки программы | ≈ 300–350 МБ (рабочий набор) |
| Архив программы | 225 КБ |
| Папка программы после установки | ≈ 370 МБ (Python с пакетами 283 МБ, ffmpeg 84 МБ) |
реклама
Выводы. В простое программа — один процесс на 74 МБ и ноль процессорного времени: опросов нет, ждёт запросы от страницы. Пик в три сотни мегабайт во время загрузки набегает из-за запуска ffmpeg и deno рядом с Python; ролик крошечный, поэтому на этом числе нельзя судить о часовом фильме, я такой замер не делал. Подсчёт грубый: рабочий набор включает общие страницы библиотек, а время загрузки на таком коротком ролике в основном уходит на разбор страницы, а не на передачу данных. Главная цена — место на диске: свой Python и ffmpeg дают около 370 МБ против 225 КБ самого архива. Это сознательный размен на «установил и работает», без конфликтов с тем Python, который уже стоит в системе.
Обновления
yt-dlp обновляется раз в сутки в фоне: сайты постоянно меняют защиту, и без этого программа через пару месяцев перестала бы работать. Сама программа раз в три дня смотрит последний релиз на GitHub. Новая версия принимается, только если у архива есть sha256 в метаданных релиза и он совпадает, версия внутри архива равна тегу, а все файлы компилируются. Обновление делает отдельный процесс: старые файлы уходят в update\old, а потом он ждёт, ответит ли новая версия на /api/status (3 минуты). Если не ответила, а порт пуст, старая версия возвращается. Настройки, куки, Python и скачанные файлы обновление не трогает.

Чего программа не умеет
- Если сайт требует входа, нужен файл cookies.txt из браузера, и его нельзя никому передавать.
- Часть плееров с фильмами привязана к Referer и меняет домены; один из популярных плееров (Alloha) не поддержан: ссылка подписывается обфусцированным скриптом.
- Заблокированные в России сайты без VPN не откроются. Расширение VPN в браузере на программу не влияет, ей нужен прокси (v2rayN, Hiddify, NekoBox, Clash и подобные): на вкладке «VPN» она ищет его сама. Есть и защищённый DNS, но подмену ответа провайдером он не лечит.
- Антивирус иногда реагирует на ffmpeg.exe и скрипт установки; тогда папку программы надо добавить в исключения.
Юридически это просто оболочка над yt-dlp для личного использования. Скачивайте только то, на что у вас есть права, и соблюдайте правила сайтов и законы своей страны.
Где взять
Программа бесплатная, исходный код открыт (лицензия MIT). Версия 1.5.1: github.com/OlegChe77/universal-downloader/releases/latest, код: github.com/OlegChe77/universal-downloader. Нужна Windows 10 или 11 (64-бит), интернет при первом запуске и примерно 350–400 МБ на диске. Проверял на Windows 10; на 11 должно работать так же, но замеров я там не делал. Если знаете сайты, где она спотыкается, или идеи, как ещё урезать место на диске, напишите в комментариях.
Лента материалов
Соблюдение Правил конференции строго обязательно!
Флуд, флейм и оффтоп преследуются по всей строгости закона!
Комментарии, содержащие оскорбления, нецензурные выражения (в т.ч. замаскированный мат), экстремистские высказывания, рекламу и спам, удаляются независимо от содержимого, а к их авторам могут применяться меры вплоть до запрета написания комментариев и, в случае написания комментария через социальные сети, жалобы в администрацию данной сети.

