YoutubePlus для NVDA

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

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

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

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

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

• a: (добавить в...) — Открывает подменю, позволяющее выбрать, куда добавить текущее видео или канал
• f: (открыть избранные видео) — Открывает окно избранных видео
• c: (открыть избранные каналы) — Открывает окно избранных каналов
• p: (открыть избранные плейлисты) — Открывает окно избранных плейлистов
• w: (показать список «Посмотреть позже») — Открывает окно списка «Посмотреть позже»
• b: (загрузить субтитры) — Загружает субтитры для текущего видео. Появится диалог выбора языка
• d: (загрузить) — Предлагает подтвердить, загружать видео или только аудио
• e: (поиск) — Открывает окно поиска видео
• i: (информация) — Открывает окно сведений о видео
• t: (показать таймкоды) — Отображает таймкоды или главы, если они доступны
• m: (открыть управление подписками) — Открывает окно управления подписками
• s: (открыть ленту подписок) — Показывает видео с каналов, на которые вы подписаны
• u: (открыть менеджер пользовательских профилей) — Открывает окно управления пользовательскими профилями
• l: (показать комментарии) — Отображает комментарии (подробности объяснены ниже)
• shift+l: (остановить мониторинг живого чата) — Останавливает отслеживание живого чата
• r: (переключить автоматическое чтение живого чата) — Переключает автоматическое озвучивание входящих сообщений живого чата
• v: (показать живой чат) — Повторно открывает окно живого чата, если вы закрыли его, пока трансляция еще активна
• y: (открыть диалог настроек YoutubePlus) быстрое открытие настроек NVDA с фокусом на категории YoutubePlus.
• h: (справка) — Открывает окно со списком всех доступных сочетаний клавиш

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

Детали функций и команды

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

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

• Добавить в избранные видео (v)
• Добавить в избранные каналы (c)
• Добавить в избранные плейлисты (p)
• Подписаться на канал (s)
• Добавить в список «Посмотреть позже» (w)

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

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

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

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

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

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

e: (поиск)

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

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

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

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

• Название
• Канал
• Длительность
• Дата загрузки
• Просмотры
• Лайки
• Комментарии
• Описание

t: (таймкод / глава)

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

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

• Поле поиска для фильтрации списка таймкодов/глав — результаты обновляются мгновенно, без необходимости нажимать Enter
• Полный список отображается с описанием каждой секции вначале, а затем её временной позицией
• Текстовая область только для чтения для чтения длинных описаний глав
• Кнопка «Открыть главу» — или нажмите Space или Enter — чтобы перейти непосредственно к этой главе в видео
• Кнопка Копировать название (Alt+C) для копирования названия главы
• Кнопка Копировать URL (Alt+U) для копирования URL с таймкодом для этой главы
• Кнопка Экспорт (Alt+E) для сохранения всех данных о таймкодах/главах в текстовый файл

Избранное

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

• Видео: Список сохраненных видео. Включает кнопки Действие и Копировать для каждого элемента (описаны ниже).
• Канал: Список сохраненных каналов с панелью описания канала. Включает кнопки для открытия канала и просмотра его контента по типу.
• Плейлист: Список сохраненных плейлистов. Нажмите Space, Enter или Alt+V, чтобы развернуть все видео в плейлисте. Включает кнопку Открыть в вебе (Alt+W), чтобы открыть плейлист в браузере.
• Список «Посмотреть позже»: Список сохраненных видео в той же структуре и макете, что и вкладка Видео.

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

• Нажмите Control+1 по Control+4 для переключения между вкладками
• Нажмите Control+Вверх/Вниз для изменения порядка вкладок
• Нажмите Control+C (копировать), Control+X (вырезать) или Control+V (вставить) для изменения порядка элементов
  • Избранные видео и список «Посмотреть позже» поддерживают копирование и перемещение элементов между собой. Избранные каналы и плейлисты поддерживают перемещение элементов только в пределах своего списка.
• нажмите F2, чтобы вручную переименовать название видео/канала/плейлиста.
• Нажмите Alt+R или Delete для удаления элемента
• Нажмите Alt+N для добавления нового элемента из буфера обмена — для вкладок каналов и плейлистов URL должен соответствовать типу вкладки
• нажмите alt+s для перехода к полю поиска, которое фильтрует результаты мгновенно по мере ввода — не нужно нажимать Enter
• Нажмите кнопку Сортировка... (рядом с полем поиска), чтобы отсортировать список. Вы можете сортировать по Названию, Каналу, Длительности, Дате добавления или Дате загрузки. Выберите порядок сортировки: по возрастанию или убыванию. Если вы отметите «Применить постоянно», порядок будет сохранен в файл. В противном случае сортировка будет временной и сбросится при поиске или обновлении списка. Нажмите «Очистить сортировку», чтобы восстановить исходный порядок.

Список видео

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

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

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

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

• Просмотреть информацию о видео... (i)
• Просмотреть комментарии / повтор... (c)
• Просмотреть главы/таймкоды... (t)
• Загрузить видео (d)
• Загрузить аудио (a)
• Загрузить субтитры (b)
• Добавить в избранные видео (f)
• Добавить в избранные каналы (f)
• Добавить в список «Посмотреть позже» (w)
• Открыть видео в браузере (o)
• Открыть канал в браузере (h)
• Показать видео канала (v)
• Показать короткие видео канала (s)
• Показать прямые эфиры канала (l)

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

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

• Копировать название (t)
• Копировать URL видео (u)
• Копировать название канала (c)
• Копировать URL канала (h)
• Копировать сводку (s)

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

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

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

• Все: Все типы контента вместе
• Видео: Только обычные видео
• Короткие видео: Только видео в формате Shorts
• Прямые эфиры: Только прямые трансляции и их повторы

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

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

• Нажмите Control+1 по Control+0 для перехода к вкладке категории (до 10 категорий)
• Нажмите Control+Вверх/Вниз для изменения порядка категорий, аналогично окну Избранное
• Нажмите F2 для переименования категории (кроме 4 категорий по умолчанию)
• Нажмите Control+= для добавления новой категории
• Нажмите Control+- для удаления категории (кроме 4 категорий по умолчанию)
• Доступ к кнопкам Действие и Копировать для каждого видео, или нажмите Enter, чтобы открыть его в браузере
• Нажмите Delete или Alt+S, чтобы отметить видео как просмотренное — оно будет удалено из списка
• Нажмите Control+Delete, чтобы отметить все видео на текущей вкладке как просмотренные

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

• Отметить как просмотренное (Alt+S) — удаляет видео из списка; клавиша Delete также работает
• Добавить новую подписку из URL в буфере обмена (Alt+N) — подписывается на канал, используя URL, скопированный в буфер обмена
• Обновить ленту (Alt+U) — вручную запускает обновление для всех подписанных каналов; дополнение также автоматически обновляется при запуске NVDA по умолчанию
• Еще... (Alt+M) — открывает подменю с дополнительными опциями:
  • Отметить все на текущей вкладке как просмотренные (Ctrl+Delete) (a)
  • Показать все видео (включая просмотренные) (v) — переключает между режимами «только непросмотренные» и «все видео»; настройка сохраняется автоматически
  • Управление подписками... (m)
  • Добавить новую категорию... Ctrl+= (c)
  • Переименовать текущую категорию... F2 (r)
  • Удалить текущую категорию... Ctrl+-
  • Очистить все видео ленты... — удаляет все видео из базы данных без удаления ваших подписок; полезно, если база данных сильно выросла и влияет на производительность NVDA

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

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

• Фильтр по категории — фильтрует список каналов по категории; по умолчанию «Все»
• Назначить категории — выбирает, в каких категориях должен появляться контент этого канала
• Типы контента для получения — выбирает, какие типы контента обновлять для этого канала (Видео, Короткие видео, Прямые эфиры); полезно для каналов, которые публикуют только определенные типы
• Просмотреть контент... (Alt+C) — просматривает контент канала, аналогично кнопке Действие
• Добавить новый подписанный канал из буфера обмена... (Alt+N) — подписывается на новый канал, используя URL из буфера обмена
• Отписаться от этого канала (Alt+U) — удаляет канал из ваших подписок
• Сохранить изменения — важно: вы должны нажать эту кнопку перед закрытием окна, иначе ваши изменения не будут сохранены

Менеджер пользовательских профилей

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

В этом окне:

• Нажмите F2, чтобы переименовать выбранный профиль
• Нажмите Delete, чтобы удалить выбранный профиль

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

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

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

• Комментарий — стандартные комментарии зрителей на обычных видео
• Живой чат — сообщения, отправленные во время прямой трансляции
• Повтор живого чата — записанный живой чат для ранее транслировавшегося видео, если владелец канала не удалил его

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

Живой чат...

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

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

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

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

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

• Автоматически озвучивать входящие сообщения живого чата: Если отмечено, NVDA немедленно озвучивает новые сообщения — та же функция, что и команда R, но сохраненная как настройка по умолчанию.
• Интервал обновления живого чата: Как часто (в секундах) дополнение проверяет наличие новых сообщений. По умолчанию: 5 секунд.
• Лимит истории сообщений: Максимальное количество сообщений, хранящихся в памяти во время сеанса. Окно живого чата показывает только самые последние сообщения до этого лимита (по умолчанию: 5 000). Дополнение сохраняет все сообщения в фоновом режиме для экспорта, до максимума в 200 000, чтобы предотвратить чрезмерное использование памяти.

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

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

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

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

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

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

• Поле поиска — введите текст для фильтрации комментариев; результаты обновляются мгновенно
• Поле со списком фильтров — выберите параметр фильтра (дополнение автоматически заполняет поле поиска):
  • Без фильтра — по умолчанию; показывает все комментарии
  • Фильтр по выбранному автору — показывает только комментарии от выбранного комментатора
  • Показывать только Super Chats
  • Показывать только Super Stickers
  • Показывать только Super Thanks
• Список комментариев — показывает имя комментатора, а затем его сообщение
• Текстовая область только для чтения — прокрутите полный текст выбранного комментария, полезно, когда комментарий слишком длинный, чтобы полностью отображаться в списке
• Кнопка Копировать (Alt+C или Ctrl+C) — копирует выбранный комментарий
• Кнопка Экспорт (Alt+E) — сохраняет все комментарии в текстовый файл в папку, установленную в Настройках
• Поле общей суммы пожертвований — отображается только для повторов живого чата; показывает общую сумму пожертвований от зрителей во время трансляции

Настройки

Доступ к настройкам осуществляется через NVDA -> Параметры -> Настройки... и выбор категории "YoutubePlus".

• Активный профиль: Выберите профиль для использования. После переключения профиля требуется перезапуск.
• Кнопка Управление профилями: Открывает окно Менеджера пользовательских профилей.
• Быстрое действие (Пробел): Выберите, что делает клавиша Пробел в окнах списка видео. Доступны все пункты из меню Действие.
• Режим уведомлений: Выберите, как дополнение сигнализирует о фоновой активности:
  • Звуковой сигнал: Короткие звуковые сигналы
  • Звук: Аудиоэффект
  • Без звука: Нет звукового уведомления (озвучивание ответов все еще происходит)
• Порядок сортировки по умолчанию: Выберите, сортировать ли списки (комментарии, видео канала) по принципу Сначала новые или Сначала старые.
• Количество элементов для получения: Сколько элементов получать на каждый тип контента при просмотре канала и для обновления ленты подписок. По умолчанию: 20.
• Типы контента по умолчанию: Выберите, какие типы контента получать для вновь подписанных каналов: Видео, Короткие видео и/или Прямые эфиры.
• Интервал фонового обновления: Как часто дополнение проверяет наличие нового контента от подписанных каналов. Можно отключить или установить от 15 минут до 24 часов. Дополнение также автоматически обновляется при каждом запуске NVDA по умолчанию.
• Автоматически озвучивать входящие сообщения живого чата: Если отмечено, NVDA озвучивает новые сообщения чата по мере их поступления.
• Интервал обновления живого чата: Как часто (в секундах) дополнение проверяет наличие новых сообщений. По умолчанию: 5 секунд.
• Лимит истории сообщений: Максимальное количество сообщений чата, хранящихся в памяти во время сеанса.
• Метод Cookie (Экспериментально): Вы можете выбрать браузер, в котором выполнете вход в свой аккаунт YouTube, чтобы исправить ошибку «Войдите, чтобы подтвердить, что вы не бот».
• Формат субтитров по умолчанию: Выберите формат файла субтитров для загрузки: srt, vtt, ttml или txt для субтитров без таймкодов.
• Путь к папке для загрузок и экспорта по умолчанию: Папка назначения для загруженных видео/аудио и экспортированного чата.
• Сделать резервную копию данных сейчас: Вручную создает резервную копию всех данных для активного профиля. Дополнение также выполняет автоматическое ежедневное резервное копирование в фоновом режиме.
• Восстановить данные из резервной копии: Показывает список доступных резервных копий (до последних 5 дней), чтобы вы могли выбрать дату для восстановления.

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

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

О yt-dlp

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

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

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

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