# YouTubeDL Скачивайте видео и Shorts с YouTube прямо из Edge или Chrome. Выберите качество, формат и папку один раз: **загрузчик** использует сохранённые настройки, а **⚙ рядом** открывает меню. Обработка и объединение дорожек выполняются на вашем компьютере. **[Сайт проекта](https://git.lonarpgproxy.space/extention/youtubedl/)** · **[Скачать расширение и помощник](https://git.lonarpgproxy.space/OwnerLink/YouTubeDL/releases/latest)** · **[Инструкция](INSTALL.md)** · **[Обработка данных](PRIVACY.md)** · **[Сообщить об ошибке](https://git.lonarpgproxy.space/OwnerLink/YouTubeDL/issues)** 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. Откройте [последний релиз](https://git.lonarpgproxy.space/OwnerLink/YouTubeDL/releases/latest), скачайте **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](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](https://developer.nvidia.com/video-encode-decode-support-matrix). Для 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](PRIVACY.md)**. ## Обновления и удаление **Обновление компонентов** скачивает совместимые обновления Python, yt-dlp и его библиотек, EJS, Node.js и FFmpeg/FFprobe с официальных источников. Проверяются хеши, новый runtime проверяется до переключения; при ошибке остаётся прежний комплект. Автоматическая проверка включена по умолчанию: раз в сутки, пока помощник запущен, между операциями. Переключатель находится в меню помощника. Python остаётся в ветке 3.13, Node.js — в 24 LTS. Новую версию расширения установите из ZIP вручную. Новый код помощника — из отдельного EXE в Releases. Автообновление компонентов не заменяет эти два обновления. «Запустить» и «Проверить подключение» восстанавливают связь без перезагрузки страницы; открытое меню также проверяет её раз в 10 секунд. Удалить помощник можно в меню расширения или в приложениях Windows. Скачанные файлы и история сохраняются; при желании историю можно удалить отдельно. ## Лицензии и разработка Новые поставки собственного кода — по **[ограниченной пользовательской лицензии](LICENSE)**: разрешены установка и использование по назначению. Изменение, самостоятельные форки, производные версии и распространение без письменного разрешения правообладателя запрещены, с учётом исключений лицензии. Это распространяется и на само расширение. Публичный репозиторий Gitea доступен для просмотра. Встроенные компоненты имеют собственные лицензии, включая **GPL v3 or later** у поставляемой сборки FFmpeg. Состав, источники и материалы релиза — **[THIRD_PARTY.md](THIRD_PARTY.md)**. Это независимый проект, не связанный с YouTube/Google, NVIDIA или AMD. Сборка, тесты и публикация сайта описаны в **[CONTRIBUTING.md](CONTRIBUTING.md)**. Используйте скачивание для контента, который вы вправе сохранять, с учётом правил источника.