YouTubeDL/README.md

YouTubeDL

Скачивайте видео и Shorts с YouTube прямо из Edge или Chrome. Выберите качество, формат и папку один раз: загрузчик использует сохранённые настройки, а ⚙ рядом открывает меню. Обработка и объединение дорожек выполняются на вашем компьютере.

Сайт проекта · Скачать расширение и помощник · Инструкция · Обработка данных · Сообщить об ошибке

Windows 10/11 x64 · Microsoft Edge / Google Chrome 120+ · расширение 1.4.5 · помощник 1.3.2. Расширение устанавливается распакованным, через режим разработчика. В магазинах браузеров пока не опубликовано.

Что умеет

• Кнопки там, где вы смотрите: рядом с «Подписаться», на превью обычных видео, в полках Shorts и открытом Shorts-плеере.
• Видео со звуком, только видео или только аудио. Раздельная звуковая дорожка автоматически скачивается и добавляется к видео.
• Выбор дорожек: доступные разрешения, FPS, HDR и языки аудио. 4K/8K доступны, если есть у источника; разрешение искусственно не увеличивается.
• Форматы видео: MP4, MKV, WebM. Аудио: M4A/AAC, MP3, Opus, FLAC, WAV. Исходный кодек или конвертация в H.264, HEVC, AV1, VP9 с учётом совместимости формата.
• Отдельные рабочая папка и папка сохранения, в том числе на разных дисках. В рабочей папке скачиваются дорожки и выполняется обработка; готовый результат сохраняется в выбранную папку.
• Прогресс FFmpeg: процент, обработанное время, записанные мегабайты, скорость и примерный остаток. Отмена завершает процессы только соответствующей задачи.
• Проверка совместимости версий: расширение показывает свою версию и версию помощника. Если нужно обновить один из компонентов, сообщает какой и открывает страницу релизов.
• Своя папка и имя файла. При совпадении имени добавляется (1), (2) и т. д.; готовые файлы не перезаписываются.
• Две операции одновременно, отмена, прогресс подготовки/скачивания/объединения/конвертации и «Показать файл».
• Отдельная страница истории: вкладки «Загрузки» и «Ошибки», дата, имя, размер и путь готового файла. Кнопка в настройках открывает её в новой вкладке; история доступна без помощника и обновляется при завершении операций.
• Настройка при первом запуске, адаптивная светлая/тёмная тема, уведомления с анимациями и поддержкой уменьшения движения.
• Реальная проверка помощника, компонентов и GPU, ручное и автоматическое обновление встроенных компонентов.
• Необязательный вход в YouTube: после отдельного согласия используется сессия текущего профиля браузера, без экспорта cookies в файл.

Скриншот показывает настоящий интерфейс с тестовыми метаданными. Возможности конкретного ролика определяет YouTube. Плейлисты, пакетное скачивание каналов, DRM-контент и гарантированный обход ограничений YouTube не заявляются.

Установка: два отдельных скачивания

1. Откройте последний релиз, скачайте YouTubeDL-1.4.5.zip и распакуйте в постоянную папку.
2. В edge://extensions или chrome://extensions включите Режим разработчика, нажмите Загрузить распакованное расширение и выберите папку extension.
3. Отдельно скачайте YouTubeDL-Helper-Setup.exe из того же релиза и запустите его вручную. EXE не встроен в расширение: кнопка установки открывает страницу релизов.
4. Обновите YouTube, откройте ⚙ и пройдите мастер. Выберите папку и параметры; зелёный статус подтверждает связь с помощником.

Все компоненты уже находятся в EXE: Python, yt-dlp, EJS, Node.js, FFmpeg и FFprobe. Для установки после скачивания интернет не требуется. Администратор не нужен; комплект устанавливается в %LOCALAPPDATA%\YouTubeDL\Helper для текущего пользователя. Системный PATH и глобальные Python/Node.js не меняются.

Контрольные суммы скачанных файлов можно сверить с SHA256SUMS.txt в том же релизе. Подробные шаги, обновление и удаление — в INSTALL.md.

Что даёт видеокарта

YouTubeDL определяет оборудование Windows и проверяет доступность кодировщиков пробным запуском FFmpeg. Поддерживаются NVIDIA NVENC и AMD AMF для H.264, HEVC и AV1, если их поддерживает конкретная карта/драйвер. У GeForce RTX 20/30 аппаратное кодирование доступно для H.264 и HEVC; у RTX 40/50 — также для AV1. Возможности конкретной модели приведены в матрице NVIDIA. Для AMD отдельно проверяется 10-битное кодирование HEVC/AV1. В «Авто» при необходимости используется CPU; принудительный режим сообщает об ошибке GPU.

GPU ускоряет перекодирование видео, а не интернет. Совместимые дорожки копируются без перекодирования — это обычно самый быстрый вариант. Аудио и VP9 обрабатываются на CPU. Уведомление отдельно показывает слияние дорожек, подготовку файла без перекодирования, кодирование через NVIDIA NVENC/AMD AMF или CPU и финализацию файла. При проверке нагрузки в диспетчере задач откройте «Производительность» → GPU и выберите график Video Encode / Кодирование видео. HDR → H.264 без тонального преобразования отклоняется, чтобы не испортить цвета. FLAC/WAV не восстанавливают качество, уже потерянное в исходном аудио.

NVENC проверен на RTX 5080. Поддержка AMD реализована, но успешное AMF-кодирование на физической AMD-карте пока не проверено: проверены выбор команд, отказ и переход на CPU.

Данные и приватность

Нет аналитики, рекламы, телеметрии и сервера разработчика для обработки роликов. Локально сохраняются настройки и до 30 последних операций в браузере (включая названия, ссылки, статусы, пути файлов и ошибки). Помощник отдельно хранит до 30 успешно завершённых загрузок. Название GPU и версии компонентов проверяются для работы приложения.

Cookies YouTube читаются только после включения необязательного разрешения. Передаются локальному помощнику через Native Messaging и используются в запросах yt-dlp к YouTube; не сохраняются в cookies-файл, настройки или историю. Google cookies, пароли и файлы профиля не читаются. Это чувствительные данные входа: включайте доступ только если он нужен. Его можно отозвать в меню.

Сетевые запросы идут к YouTube/его медиасерверам и, при обновлениях, официальным источникам компонентов. Сайт, репозиторий и файлы релизов размещены на сервере проекта; при обращении к ним ведутся стандартные журналы запросов. Полный список данных, разрешений и способ удаления — PRIVACY.md.

Обновления и удаление

Обновление компонентов скачивает совместимые обновления Python, yt-dlp и его библиотек, EJS, Node.js и FFmpeg/FFprobe с официальных источников. Проверяются хеши, новый runtime проверяется до переключения; при ошибке остаётся прежний комплект. Автоматическая проверка включена по умолчанию: раз в сутки, пока помощник запущен, между операциями. Переключатель находится в меню помощника. Python остаётся в ветке 3.13, Node.js — в 24 LTS.

Новую версию расширения установите из ZIP вручную. Новый код помощника — из отдельного EXE в Releases. Автообновление компонентов не заменяет эти два обновления. «Запустить» и «Проверить подключение» восстанавливают связь без перезагрузки страницы; открытое меню также проверяет её раз в 10 секунд.

Удалить помощник можно в меню расширения или в приложениях Windows. Скачанные файлы и история сохраняются; при желании историю можно удалить отдельно.

Лицензии и разработка

Новые поставки собственного кода — по ограниченной пользовательской лицензии: разрешены установка и использование по назначению. Изменение, самостоятельные форки, производные версии и распространение без письменного разрешения правообладателя запрещены, с учётом исключений лицензии. Это распространяется и на само расширение.

Публичный репозиторий Gitea доступен для просмотра.

Встроенные компоненты имеют собственные лицензии, включая GPL v3 or later у поставляемой сборки FFmpeg. Состав, источники и материалы релиза — THIRD_PARTY.md. Это независимый проект, не связанный с YouTube/Google, NVIDIA или AMD.

Сборка, тесты и публикация сайта описаны в CONTRIBUTING.md. Используйте скачивание для контента, который вы вправе сохранять, с учётом правил источника.