Руководство по использованию дополнения YtDlpDownloader

Общие сведения

Дополнение YtDlpDownloader предназначено для загрузки видео и аудио с различных веб-сайтов с помощью программы yt-dlp. Дополнение интегрируется в NVDA и предоставляет удобный графический интерфейс для настройки параметров загрузки.

Запуск дополнения

Существует два способа открыть окно загрузчика:

Через меню «Сервис» в трее NVDA выберите пункт «Загрузить видео или аудио с помощью yt-dlp...».
Нажмите сочетание клавиш NVDA+Shift+Y.

Интерфейс дополнения

Окно загрузчика содержит следующие элементы управления:

Поле ввода адреса

В это поле необходимо вставить ссылку на видео или плейлист. Поддерживаются все сайты, которые совместимы с программой yt-dlp.

Выбор типа загрузки

«Загрузить как видео» — загрузка видеофайла с сохранением видеоряда и звуковой дорожки.
«Загрузить как аудио» — извлечение и загрузка только звуковой дорожки.

Настройка форматов

При выборе загрузки видео доступны следующие форматы:

Лучшее видео (предпочтительно mp4) — автоматический выбор наилучшего качества в формате mp4.
Лучшее видео (оригинал) — загрузка видео в оригинальном формате без конвертации.
mp4 — принудительное сохранение в формате MP4.
mkv — принудительное сохранение в формате MKV.
webm — принудительное сохранение в формате WebM.

При выборе загрузки аудио доступны следующие форматы:

Лучшее аудио (кроме webm) — автоматический выбор наилучшего качества, исключая формат WebM.
Лучшее аудио (оригинал) — загрузка аудио в оригинальном формате.
mp3 — конвертация в MP3.
m4a — конвертация в M4A.
flac — конвертация в FLAC (без потерь).
wav — конвертация в WAV (без сжатия).

Параметры аудиофайла

Эти опции доступны только при выборе загрузки аудио:

«Добавить в файл метаданные (название, исполнитель и т.п.)» — внедряет информацию о треке в аудиофайл.
«Вставить миниатюру видео как обложку аудиофайла» — сохраняет превью видео в качестве обложки.

Выбор папки для загрузки

Нажмите кнопку «Выбрать папку...», чтобы указать каталог, куда будет сохранён загруженный файл. Путь к папке отображается в текстовом поле справа от кнопки.

Область вывода лога

В этой области отображается процесс загрузки в реальном времени. Здесь показываются сообщения от yt-dlp, включая прогресс, возможные ошибки и информацию о сохранённом файле.

Кнопки управления

«Начать загрузку» — запускает процесс загрузки после заполнения всех обязательных полей.
«Обновить yt-dlp» — проверяет наличие обновлений для yt-dlp и устанавливает их при необходимости.
«Закрыть» — закрывает окно. Если загрузка активна, программа запросит подтверждение на прерывание операции.

Процесс загрузки

После нажатия кнопки «Начать загрузку» дополнение выполняет следующие действия:

Проверяет наличие всех необходимых исполняемых файлов: yt-dlp.exe, ffmpeg.exe, deno.exe.
Проверяет существование указанной целевой папки.
Формирует команду с выбранными параметрами.
Запускает процесс загрузки в отдельном потоке.
Выводит все сообщения от yt-dlp в область лога.
По завершении загрузки отображает диалоговое окно с подтверждением и закрывает окно.

Обновление yt-dlp

Программа yt-dlp часто обновляется для поддержки изменений на сайтах. Рекомендуется периодически использовать кнопку «Обновить yt-dlp». Процесс обновления:

Дополнение проверяет, не выполняется ли активная загрузка.
Запрашивает подтверждение пользователя.
Запускает процесс обновления с выводом результатов в лог.
Обновление не влияет на уже загруженные файлы.

Возможные ошибки и их решение

«Пожалуйста, введите адрес видео для загрузки»

Не заполнено поле адреса. Вставьте ссылку на видео.

«Пожалуйста, выберите целевую папку с помощью кнопки «Выбрать папку»»

Не указана папка для сохранения. Нажмите «Выбрать папку...» и укажите существующий каталог.

«Выбранная целевая папка не найдена»

Указанная папка была удалена или перемещена после выбора. Выберите папку заново.

«yt-dlp.exe не найден в папке дополнения»

Исполняемый файл yt-dlp.exe отсутствует в папке bin внутри дополнения. Убедитесь, что дополнение установлено корректно.

«ffmpeg.exe не найден в папке дополнения»

Отсутствует ffmpeg.exe, необходимый для объединения видео и аудио или конвертации форматов. Требуется переустановка дополнения.

«deno.exe не найден в папке дополнения»

Отсутствует deno.exe — среда выполнения, необходимая для некоторых функций yt-dlp. Требуется переустановка дополнения.

«Невозможно выполнить обновление во время загрузки»

Попытка обновить yt-dlp во время активной загрузки. Дождитесь завершения загрузки или прервите её, затем повторите обновление.

«Загрузка не удалась. Подробности в выводе выше»

В процессе загрузки произошла ошибка. Просмотрите лог выше этого сообщения для выяснения причины. Возможные причины:

Ссылка недействительна или видео удалено.
Сайт требует авторизации.
Проблемы с сетевым подключением.
Устаревшая версия yt-dlp (попробуйте обновить).