Не найдено

Руководство по использованию дополнения 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 и устанавливает их при необходимости.
• «Закрыть» — закрывает окно. Если загрузка активна, программа запросит подтверждение на прерывание операции.

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

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

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

Обновление 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 (попробуйте обновить).

Рекомендации

• Перед загрузкой крупных видео убедитесь, что на диске достаточно свободного места.
• При выборе формата FLAC или WAV учитывайте, что размер файла будет значительно больше, чем при выборе MP3 или M4A.
• Если загрузка прервалась, можно запустить её заново с теми же параметрами — yt-dlp поддерживает докачку при наличии частично загруженного файла.
• При возникновении проблем с определённым сайтом сначала попробуйте обновить yt-dlp через кнопку «Обновить yt-dlp».