118 lines
14 KiB
Markdown
118 lines
14 KiB
Markdown
<p align="center"><img src="site/assets/github-cover.png" alt="YouTubeDL — Видео. Звук. Ваш выбор." width="100%"></p>
|
||
|
||
# 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 в файл.
|
||
|
||
<p align="center"><img src="site/assets/menu-dark.png" alt="Настройки YouTubeDL: качество, звук, формат и папка" width="440"></p>
|
||
|
||
Скриншот показывает настоящий интерфейс с тестовыми метаданными.
|
||
Возможности конкретного ролика определяет 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)**.
|
||
Используйте скачивание для контента, который вы вправе сохранять, с учётом правил источника.
|