YoutubePlus для NVDA

YoutubePlus — це додаток для користувачів NVDA, які люблять YouTube, але відчувають труднощі з доступом до багатьох функцій сайту — наприклад, читання коментарів, відстеження каналів або перегляд живого чату.

Ми надаємо ці функції через інтерфейс NVDA у зручному для клавіатурної навігації вигляді з підтримкою гарячих клавіш і повним налаштуванням — без потреби в API-ключах або підключенні облікового запису Google/YouTube.

Ви можете стежити за улюбленими каналами і бути впевнені, що побачите кожне відео з цих каналів — без фільтрації алгоритмом YouTube. Система «Вибране» дозволяє зберігати відео, канали, списки відтворення та список «Переглянути пізніше».

Вбудований пошук відео відображає результати всередині інтерфейсу додатка — не просто відкриває YouTube у браузері. Функція завантаження відео/аудіо надається для зручності — якщо завантаження є вашою основною потребою, рекомендуємо спеціалізовані інструменти.

Цей додаток не вбудовує відеопрогравач. Ми вважаємо, що вебпрогравач YouTube вже достатньо доступний. Якщо ви все ще відчуваєте труднощі, можна скористатися такими додатками, як browserNav.


Зміст


Клавіатурні скорочення

Цей додаток використовує систему шарових команд (Layer Commands), щоб уникнути конфліктів з іншими додатками або командами NVDA.

Як використовувати: 1. Натисніть NVDA+Y, щоб увійти в режим команд YoutubePlus (ви почуєте звуковий сигнал). 2. Натисніть відповідну літеру, щоб активувати потрібну функцію.

Примітка: Якщо NVDA+Y конфліктує з іншим додатком, змінити прив'язку можна в NVDA → Параметри → Жести вводу... у категорії «YoutubePlus».

Визначення URL: Для команд, яким потрібна URL-адреса відео, додаток спочатку перевіряє поточне вікно браузера. Якщо YouTube-посилання там не знайдено — автоматично перевіряє буфер обміну.

Усі клавіші в режимі YoutubePlus

| Клавіша | Функція | |---------|---------| | a | Меню «Додати до...» (Вибране / Підписки) | | f | Відкрити вибрані відео | | c | Відкрити вибрані канали | | p | Відкрити вибрані списки відтворення | | w | Відкрити список «Переглянути пізніше» | | b | Завантажити субтитри | | d | Завантажити відео або аудіо | | e | Пошук на YouTube | | q | Швидкий пошук — шукає на YouTube одразу, використовуючи виділений текст або вміст буфера обміну, без відкриття діалогу пошуку | | Control+H | Відкриває вікно «Вибране» одразу на вкладці «Історія пошуку» | | i | Показати інформацію про відео | | t | Показати розділи / часові мітки | | m | Керування підписками | | s | Відкрити стрічку підписок | | u | Менеджер профілів користувача | | l | Показати коментарі або розпочати моніторинг живого чату | | Shift+L | Зупинити моніторинг живого чату | | r | Перемкнути автоматичне читання живого чату | | v | Повторно відкрити вікно живого чату (поки трансляція активна) | | y | Відкрити налаштування YoutubePlus | | h | Відкрити довідку |


Детальний опис функцій

a: Меню «Додати до...»

Відкриває підменю для вибору місця призначення:

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

Виняток: Для списків відтворення необхідно відкрити сторінку плейліста YouTube або мати коректну URL-адресу плейліста в буфері обміну.


d: Завантаження відео/аудіо

Натисніть NVDA+Y → D, щоб відкрити діалог вибору формату:

Під час завантаження відображається діалог із відсотком прогресу. Кнопка Скасувати доступна в будь-який момент.

Папку призначення можна налаштувати в розділі Налаштування.

Примітка: Ця функція надається для зручності. Для масового завантаження рекомендуються спеціалізовані інструменти.


b: Завантаження субтитрів

Натисніть NVDA+Y → B, щоб отримати список доступних мов субтитрів для поточного відео, після чого оберіть мову в діалозі. Субтитри поділяються на два типи:

Підтримувані формати файлів: SRT, VTT, TTML і TXT (звичайний текст без часових міток). Налаштовується в розділі Налаштування.


e: Пошук на YouTube

Натисніть NVDA+Y → E, щоб відкрити вікно пошуку. Введіть запит і натисніть Enter для негайного пошуку. Натисніть Tab, щоб налаштувати кількість результатів (додаток запам'ятовує це значення для наступного разу).

Поле пошуку — це комбінований список, що зберігає попередні пошукові запити: натисніть стрілку вниз (або Alt+Стрілка вниз), щоб відкрити список попередніх ключових слів і вибрати одне замість повторного введення.

q: Швидкий пошук

Швидша альтернатива діалогу пошуку. Виділіть текст у будь-якій програмі (або скопіюйте запит у буфер обміну, якщо нічого не виділено), а потім натисніть Q у шарі YoutubePlus. Додаток шукає на YouTube одразу, використовуючи цей текст і збережену кількість результатів з останнього пошуку — без діалогу, без зайвих натискань.

Історія пошуку

Кожен виконаний пошук — з діалогу пошуку або швидкого пошуку — зберігається автоматично. Натисніть Control+H у шарі YoutubePlus, щоб перейти безпосередньо на вкладку «Історія пошуку» у вікні «Вибране», де можна:

Результати відображаються у форматі Список відео, що використовується у всьому додатку — не у вигляді сторінки YouTube в браузері. Результати можуть включати відео, канали та списки відтворення.


i: Інформація про відео

Натисніть NVDA+Y → I, щоб переглянути такі відомості про поточне відео:


t: Розділи / Часові мітки

Натисніть NVDA+Y → T, щоб переглянути список розділів або часових міток відео (якщо автор їх додав). Якщо додаток повідомляє «Розділів не знайдено», відео просто не містить цих даних.

Це вікно включає:


l: Коментарі / Живий чат / Запис чату

YoutubePlus підтримує три типи вмісту через цю команду:

1. Коментарі (для звичайних відео)

Натисніть NVDA+Y → L на сторінці відео. Додаток завантажить усі коментарі. Закріплені коментарі відображаються першими, потім усі інші в порядку, налаштованому в Параметрах.

Вікно коментарів включає:

2. Живий чат (для активних трансляцій)

Для відео, що транслюється в прямому ефірі, натисніть L, щоб відкрити вікно отримання повідомлень живого чату. Відображаються лише повідомлення, отримані після активації команди — попередня історія не захоплюється.

Пов'язані параметри: - Автоматично зачитувати живий чат: Читає нові повідомлення вголос одразу при надходженні (аналог команди R, але зберігається як стандартне налаштування). - Інтервал оновлення живого чату: Як часто (у секундах) додаток перевіряє нові повідомлення (за замовчуванням: 5 секунд). - Ліміт історії повідомлень: Максимальна кількість повідомлень, що зберігаються в пам'яті (за замовчуванням: 5 000). Жорстке обмеження становить 200 000 повідомлень для запобігання надмірного використання пам'яті.

3. Запис живого чату (для архівних трансляцій)

Для відео, що раніше транслювалося в прямому ефірі, якщо канал не видалив чат, натискання L відкриє діалог із запитом: переглянути Коментарі чи Запис живого чату. Вікно запису чату має таку саму структуру, як і вікно коментарів, але доповнено:


Вибране (f, c, p, w)

Вікно «Вибране» поділено на 5 вкладок, доступних через окремі команди або всі разом в одному вікні.

| Клавіша | Вкладка | |---------|---------| | F | Збережені відео (Вибрані відео) — підтримує категорії | | C | Збережені канали (Вибрані канали) | | P | Збережені списки відтворення (Вибрані плейлісти) | | W | Відео для перегляду пізніше (Список «Переглянути пізніше») — підтримує категорії | | Control+H | Історія пошуку |

Гарячі клавіші у вікні «Вибране»

Категорії (вкладки «Відео» та «Переглянути пізніше»)

Обидві вкладки дозволяють організовувати елементи у власні категорії за допомогою деревовидного перегляду ліворуч, окремо від списку елементів праворуч. Кожна вкладка має власні незалежні категорії. Завжди є вузол за замовчуванням для елементів без категорії («Відео» у вкладці «Відео», «Переглянути пізніше» у відповідній вкладці).

З фокусом на дереві категорій:

З фокусом на списку елементів (праворуч), правий клік або клавіша Програми/Меню відкриває те саме меню «Дія», що використовується в усьому додатку — окремо від контекстного меню дерева.

Вирізання, копіювання та вставка в списку елементів завжди розміщують елементи в категорії, вибраній у дереві.

Вкладка «Канали» (Вибране)

Ця вкладка має більше можливостей, ніж просто список:

Вкладка «Плейлісти» (Вибране)

s: Стрічка підписок

Вікно з відео від каналів, на які ви підписані через додаток. Це не пов'язано з вашим обліковим записом YouTube — вхід в систему не потрібен.

Стандартний вигляд має 4 вкладки за типом вмісту:

| Вкладка | Вміст | |---------|-------| | Всі | Усі типи вмісту разом | | Відео | Лише звичайні відео | | Shorts | Лише короткі відео | | Live | Прямі трансляції та їх записи |

Ви також можете створювати власні категорії і налаштовувати, які канали відображаються в кожній.

Гарячі клавіші в стрічці підписок

Кнопки у вікні стрічки підписок


m: Керування підписками

Вікно з усіма каналами, на які ви підписані, та параметрами керування кожним:


u: Менеджер профілів користувача

Додаток підтримує кілька профілів користувача на одному комп'ютері. Кожен профіль зберігає свої дані повністю окремо (Вибране, Підписки, Список «Переглянути пізніше»).

У цьому вікні: - F2 — перейменувати вибраний профіль - Delete — видалити вибраний профіль ⚠️ Видалення є незворотним; усі дані в цьому профілі будуть втрачені

Щоб змінити профіль, перейдіть до Налаштування → Активний профіль, потім перезапустіть NVDA.


Список відео

Список відео — стандартний інтерфейс, що використовується у всьому додатку: у результатах пошуку, Вибраному, стрічці підписок і при перегляді відео каналу.

Кнопка «Дія» (Alt+A)

Відкриває меню дій для вибраного відео:

| Пункт меню | Скорочення | |------------|-----------| | Переглянути інформацію про відео | i | | Переглянути коментарі / Запис | c | | Переглянути розділи/часові мітки | t | | Завантажити відео | d | | Завантажити аудіо | a | | Завантажити субтитри | b | | Додати до вибраних відео | f | | Додати до вибраних каналів | f | | Додати до списку «Переглянути пізніше» | w | | Відкрити відео в браузері | o | | Відкрити канал у браузері | h | | Показати відео каналу | v | | Показати Shorts каналу | s | | Показати Live каналу | l |

Кнопка «Копіювати» (Alt+C)

Відкриває меню копіювання:

| Пункт меню | Скорочення | |------------|-----------| | Копіювати назву | t | | Копіювати URL відео | u | | Копіювати назву каналу | c | | Копіювати URL каналу | h | | Копіювати опис | s |


Налаштування

Перейдіть до NVDA → Параметри → Налаштування... і виберіть категорію «YoutubePlus».

| Параметр | Опис | |----------|------| | Активний профіль | Вибір активного профілю (після зміни потрібен перезапуск NVDA) | | Керування профілями | Відкриває менеджер профілів користувача | | Швидка дія (пробіл) | Визначає, що виконує клавіша Space у вікнах списку відео; доступні всі параметри з меню «Дія» | | Режим сповіщень | Як додаток сигналізує про фонову активність: Сигнал (короткі тони), Звук (аудіофайл), Тихий (без аудіо, але голосові повідомлення залишаються) | | Порядок сортування за замовчуванням | Стандартний порядок відображення: Спочатку нові або Спочатку старі — застосовується до коментарів, чату та списків відео каналу | | Елементів для завантаження | Кількість елементів, що завантажуються на тип вмісту при перегляді каналу або оновленні стрічки (за замовчуванням: 20, діапазон: 5–100) | | Типи вмісту за замовчуванням | Типи вмісту для завантаження при додаванні нових підписок: Відео, Shorts, Live | | Інтервал фонового оновлення | Як часто додаток автоматично перевіряє новий вміст від підписаних каналів (вимкнено або від 15 хвилин до 24 годин) | | Автоматично зачитувати живий чат | Читає нові повідомлення живого чату вголос при надходженні | | Інтервал оновлення живого чату | Як часто (у секундах) перевіряються нові повідомлення (за замовчуванням: 5 секунд) | | Ліміт історії повідомлень | Максимальна кількість повідомлень чату в пам'яті під час сесії (за замовчуванням: 5 000) | | Метод Cookie (Експериментально) | Виберіть браузер, в якому ви авторизовані на YouTube. Додаток витягне Cookie з цього браузера для автентифікації запитів, що може допомогти вирішити помилку «Sign in to confirm you're not a bot». Зверніть увагу: ця функція є експериментальною, і результати залежать від браузера та конфігурації системи. | | Формат субтитрів за замовчуванням | Формат файлу субтитрів: SRT, VTT, TTML або TXT (звичайний текст без часових міток) | | Папка завантажень та експорту | Папка призначення для завантажених відео, аудіо та експортованих файлів | | Зробити резервну копію зараз | Негайно створює резервну копію всіх даних активного профілю (додаток також виконує автоматичне щоденне резервне копіювання) | | Відновити дані з резервної копії | Показує доступні резервні копії (до останніх 5 днів) для вибору та відновлення |


Додаткова інформація

Цей додаток використовує дві основні бібліотеки: pytchat для моніторингу живого чату та yt-dlp для доступу до всіх інших даних YouTube. Висловлюємо щиру подяку розробникам обох бібліотек.

Про yt-dlp

yt-dlp — один із найпотужніших інструментів з відкритим вихідним кодом для завантаження відео та аудіо з вебсайтів по всьому світу — підтримує понад 1 000 сайтів, а не лише YouTube. Він безкоштовний, з відкритим вихідним кодом, активно підтримується глобальною спільнотою і не містить реклами чи шкідливого програмного забезпечення.

Рекомендації щодо використання:

  1. Добросовісне використання: Уникайте завантаження великих обсягів даних або частих запитів за короткий час. YouTube може виявити незвичайну активність і тимчасово обмежити доступ з вашої IP-адреси.
  2. Авторські права та конфіденційність: Будь-які отримані дані або вміст слід використовувати лише для особистого перегляду або аналізу. Будь ласка, дотримуйтесь Умов використання кожної платформи і не використовуйте дані у спосіб, що порушує авторські права.
  3. Відповідальність: Ви несете відповідальність за використання цього програмного забезпечення. Розробник додатка надає лише інтерфейс для доступу до даних YouTube через бібліотеку yt-dlp.

Порада: Якщо вам потрібно обробити великі обсяги даних, розподіліть запити в часі для підтримки стабільності з'єднання та уникнення обмежень доступу.