YoutubePlus для NVDA

YoutubePlus — это дополнение для людей, которые любят использовать YouTube, но находят многие функции на сайте труднодоступными — например, чтение комментариев к видео. Мы предоставляем эти функции через интерфейс NVDA в удобной для навигации форме, поддерживающей сочетания клавиш и полностью настраиваемой — без необходимости иметь дело с ключами API или подключать какие-либо личные аккаунты к дополнению. Вы можете отслеживать любимые каналы и быть уверенными, что увидите все видео с этих каналов, без того чтобы алгоритм YouTube их фильтровал. Мы также предоставляем систему избранного для видео, каналов, плейлистов и список для просмотра, чтобы сохранять контент, который вас заинтересовал, но на который у вас ещё не было времени посмотреть. Встроен поиск видео, который отображает результаты в том же интерфейсе, который используется во всём дополнении — а не просто в поле поиска, открывающем YouTube в браузере. Включена функция загрузки для сохранения видео или аудиофайлов, хотя она предоставлена как дополнительное удобство, а не как основная функция. Если загрузка — ваша главная потребность, существуют другие дополнения, посвящённые именно этой функции, которые вы, возможно, захотите изучить. Единственное, что это дополнение не делает — не встраивает видеоплеер. Мы считаем, что веб-плеер YouTube и так достаточно доступен. Если вы считаете, что его возможностей всё ещё не хватает, вы можете использовать другие дополнения, например browserNav, чтобы улучшить взаимодействие.

Сочетания клавиш и команды

В этом дополнении используется слоёвая система сочетаний клавиш для предотвращения конфликтов с другими дополнениями или командами NVDA. Нажмите NVDA+Y, чтобы войти в режим команд YoutubePlus, затем нажмите одну из следующих клавиш для доступа к каждой функции или окну.

Примечание: Если основное сочетание клавиш (NVDA+Y) конфликтует с другим дополнением, вы можете изменить его через NVDA -> Параметры -> Жесты ввода... в категории «YoutubePlus».

Клавиши, доступные в слое YoutubePlus

Примечание: Для команд, которые действуют непосредственно на видео, дополнение сначала проверяет открытое окно браузера. Если активна страница с видео на YouTube, используется URL этого видео. Если страница с видео не открыта, проверяется буфер обмена на наличие URL YouTube.

Подробности функций и команды

a: (добавить в...)

Эта команда в слое YoutubePlus отправляет информацию о видео или канале в выбранное место назначения:

Дополнение сначала проверяет текущую открытую страницу браузера. Если это страница видео YouTube, оно извлекает URL и обрабатывает его в соответствии с вашим выбором. Если страница не является видео YouTube или браузер не открыт, проверяется буфер обмена на наличие URL YouTube.

Большинство команд работают с любым типом URL YouTube, поскольку дополнение может получить необходимую информацию. Например, если вы находитесь на странице видео и выбираете «Добавить в избранные каналы», дополнение может автоматически извлечь URL канала. То же самое относится и к подписке на канал.

Единственное исключение — плейлисты: у вас должна быть открыта страница плейлиста YouTube или в буфере обмена должен быть действительный URL плейлиста YouTube.

d: (загрузить видео/аудио)

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

Для загрузки видео требуется FFmpeg. YouTube больше не предоставляет большинство видео в виде одного объединённого видео+аудиофайла, поэтому для объединения отдельных потоков необходим FFmpeg. YoutubePlus не включает FFmpeg в свой состав (чтобы не раздувать конфигурацию NVDA каждого пользователя его копией) — если FFmpeg не найден в вашей системе при загрузке видео и доступен инструмент Windows winget, YoutubePlus предложит установить его автоматически с помощью одного запроса «Да/Нет»; после установки загрузка продолжится автоматически без необходимости перезапуска NVDA. Если ни FFmpeg, ни winget недоступны, вы получите соответствующее уведомление, и загрузка будет чисто отменена.

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

Обратите внимание, что функция загрузки предоставляется для удобства и может иметь ограничения при интенсивном использовании. Если вам нужно загружать большие объёмы контента с YouTube, рекомендуются другие специализированные инструменты.

e: (поиск)

Эта команда открывает окно поиска YouTube. Введите запрос в поле поиска и нажмите Enter, чтобы выполнить поиск немедленно. Вы также можете переключиться на настройку количества отображаемых результатов — дополнение запоминает это значение для будущих поисков.

Поле поиска является полем со списком, которое запоминает ваши предыдущие поисковые запросы: нажмите стрелку вниз (или Alt+Вниз), чтобы раскрыть список предыдущих ключевых слов и выбрать одно из них вместо повторного ввода.

Результаты отображаются в том же формате списка видео, который используется во всём дополнении, а не как веб-страница YouTube. Вы можете получить доступ ко всем сведениям о видео так же, как и в любом другом списке видео в дополнении.

q: (быстрый поиск)

Более быстрая альтернатива диалогу поиска выше. Выделите текст в любом приложении (или скопируйте запрос в буфер обмена, если ничего не выделено), затем нажмите Q в слое YoutubePlus. Дополнение немедленно выполняет поиск на YouTube, используя этот текст и сохранённое количество результатов из вашего последнего поиска — без диалогов и дополнительных нажатий клавиш.

История поиска

Каждый выполненный вами поиск — как из диалога поиска, так и через быстрый поиск — автоматически сохраняется. Нажмите Control+H в слое YoutubePlus, чтобы перейти непосредственно на вкладку «История поиска» в окне «Избранное», где вы можете:

i: (информация о видео)

Отображает следующие сведения о текущем видео:

t: (временная метка / глава)

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

Это окно предлагает больше удобства, чем чтение глав из браузера:

g: (получить описание миниатюры)

Загружает изображение миниатюры и отправляет его в приложение Be My Eyes для живого описания, не покидая NVDA. Эта команда учитывает контекст: она описывает миниатюру видео, когда вы находитесь на странице видео, аватар канала, когда вы находитесь на странице канала, и обложку плейлиста, когда вы находитесь на странице плейлиста — используя тот же порядок определения URL, что и все остальные команды (сначала активное окно браузера, затем буфер обмена). Также доступна из меню «Действия» для видео (только миниатюры видео) и как настраиваемое быстрое действие (пробел).

Дополнение всегда выбирает изображение с самым высоким разрешением, сообщаемым yt-dlp, поэтому файл, отправляемый в Be My Eyes, является наилучшим из доступных.

Вы также можете описать аватар канала или обложку плейлиста непосредственно из окна «Избранное», без необходимости открывать эту страницу где-либо ещё — см. кнопки Описать аватар и Описать обложку в разделе Избранное ниже.

Примечание: Для этого требуется, чтобы приложение Be My Eyes было установлено отдельно в вашей системе — дополнение не устанавливает и не включает его. Если оно не установлено, YoutubePlus предложит открыть его страницу в Microsoft Store, чтобы вы могли установить его сразу.

Избранное

Окно, отображающее ваши сохранённые избранные элементы, разделённые на 5 вкладок по типу:

Команды окна «Избранное»

Категории (вкладки «Видео» и «Список для просмотра»)

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

При фокусе на дереве категорий:

При фокусе на списке элементов (правая сторона) щёлкните правой кнопкой мыши или нажмите клавишу Application/Menu для того же меню «Действия», которое используется во всём дополнении (Просмотр информации, Комментарии, Загрузка, Добавить в... и т. д.) — отдельно от контекстного меню категорий на дереве.

Вырезание, копирование и вставка в списке элементов работают, как описано выше, и вставка всегда помещает элементы в ту категорию, которая выбрана в данный момент в дереве.

Сортировка

Кнопка Сортировка... (Alt+O) доступна на любой вкладке с сортируемым списком — включая «Видео», «Список для просмотра» и «Историю поиска». Она открывает диалог с:

Список видео

На вкладках видео и списка для просмотра, а также в любом другом представлении, показывающем список видео, вы найдёте кнопки Действия... и Копировать.... Это стандартные элементы управления для всех представлений списка видео, при этом лента подписок добавляет дополнительный пункт «Отписаться от этого канала».

Нажмите Enter на любом элементе, чтобы открыть видео в браузере, или нажмите пробел, чтобы выполнить быстрое действие, которое можно настроить в настройках.

Кнопка «Действия»

Нажмите Alt+A, чтобы открыть меню «Действия», которое включает:

Кнопка «Копировать»

Нажмите Alt+C, чтобы открыть меню «Копировать», которое включает:

Лента подписок

Окно, отображающее видео с каналов, на которые вы подписаны в дополнении. Это отдельно от ваших подписок в аккаунте YouTube — не требуется привязка аккаунта или передача личных данных.

В отличие от окна «Избранное», это представление использует стандартные вкладки, разделённые по типу контента:

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

Команды ленты подписок

Дополнительные кнопки в этом окне:

Управление подписками

Это окно показывает все каналы, на которые вы подписаны. Первый раздел — это список каналов, за которым следуют параметры управления для каждого канала:

Управление профилями пользователей

Это окно управляет вашими профилями пользователей. Дополнение поставляется с профилем «по умолчанию». Здесь вы можете добавлять, удалять или переименовывать профили. Чтобы переключаться между профилями, перейдите на панель настроек дополнения.

В этом окне:

Примечание: Удаление профиля безвозвратно удаляет все данные, связанные с ним. Все сохранённые видео, каналы или подписки в этом профиле будут потеряны.

l: (показать комментарии)

На видео YouTube существует три типа комментариев:

YoutubePlus поддерживает доступ ко всем трём типам через эту команду.

Живой чат...

Для видео, которые транслируются в данный момент, нажмите L, и дополнение откроет новое окно, отображающее входящие сообщения чата. Отображаются только сообщения, полученные после активации команды — более ранние сообщения не захватываются.

Вы можете закрыть это окно и повторно открыть его позже с помощью команды V в слое YoutubePlus, пока трансляция ещё активна и NVDA не был перезапущен.

Используйте команду R, чтобы переключить, озвучивает ли NVDA новые сообщения вслух по мере их поступления. Это хорошо работает для трансляций с нечастыми сообщениями. Для трансляций с высоким потоком сообщений может быть удобнее отключить автоматическое чтение и прокручивать окно вручную.

Нажмите Shift+L, чтобы остановить мониторинг чата для текущего видео.

Три настройки напрямую влияют на эту функцию:

Когда трансляция заканчивается — или дополнение определяет, что она закончилась — автоматически появится диалог с вопросом, хотите ли вы экспортировать все собранные сообщения. Нажмите «Да», чтобы сохранить историю чата в файл.

Комментарии / Повтор живого чата

Для обычных загруженных видео или архивных трансляций вы можете получить доступ к комментариям таким же образом. Если доступны и повтор живого чата, и стандартные комментарии, появится диалог с вопросом, что вы хотите загрузить.

Лимит на количество отображаемых комментариев отсутствует, хотя загрузка может занять время для видео с большим количеством комментариев.

Комментарии отображаются с закреплёнными комментариями вначале, затем все остальные в порядке сортировки, настроенном в параметрах (сначала новые или сначала старые).

Разделы окна комментариев

Настройки

Доступ к настройкам через NVDA -> Параметры -> Настройки... и выберите категорию «YoutubePlus».

Дополнительная информация

Это дополнение использует две основные библиотеки: pytchat для мониторинга живого чата и yt-dlp для всего остального доступа к данным YouTube. Мы выражаем искреннюю благодарность разработчикам обеих библиотек.

О yt-dlp

yt-dlp — один из самых мощных инструментов с открытым исходным кодом для загрузки видео и аудио с сайтов по всему миру — поддерживает более 1000 сайтов, не только YouTube. Он бесплатен, имеет открытый исходный код и активно поддерживается мировым сообществом, без рекламы и вредоносного ПО, в отличие от многих инструментов загрузки в браузере.

Тем не менее, пожалуйста, имейте в виду следующие рекомендации по использованию:

  1. Добросовестное использование: Избегайте получения больших объёмов данных или отправки повторяющихся запросов за короткое время. YouTube может обнаружить необычную активность и временно ограничить доступ с вашего IP-адреса.
  2. Авторское право и конфиденциальность: Любые полученные данные или контент должны использоваться только для личного просмотра или анализа. Пожалуйста, уважайте условия использования каждой платформы и не используйте данные способами, нарушающими авторские права.
  3. Ответственность: Вы несёте ответственность за то, как вы используете это программное обеспечение. Разработчик дополнения предоставляет только интерфейс для доступа к данным YouTube через библиотеку yt-dlp.

Совет: Если вам нужно обрабатывать большие объёмы данных, распределяйте запросы по времени, чтобы поддерживать стабильность соединения и избегать ограничений доступа.