YoutubePlus for NVDA

YoutubePlus — це додаток для людей, які люблять користуватися YouTube, але вважають багато функцій сайту важкодоступними — наприклад, читання коментарів до відео. Ми надаємо ці функції через інтерфейс користувача NVDA у формі, зручній для навігації, з підтримкою клавіатурних скорочень і повністю налаштовуваній — без потреби мати справу з API-ключами чи підключати будь-які особисті облікові записи до додатка. Ви можете стежити за улюбленими каналами й бути впевненими, що побачите кожне відео з цих каналів, без фільтрації алгоритмом YouTube. Ми також надаємо систему «Обраного» для відео, каналів, плейлістів, а також список перегляду для збереження вмісту, який вас цікавить, але на який ще не було часу. Є вбудований пошук відео, який показує результати в тому ж інтерфейсі користувача, що використовується в усьому додатку — а не просто поле пошуку, яке відкриває YouTube у браузері. Функція завантаження включена для збереження відео чи аудіофайлів, хоча вона надається як зручність, а не як основний фокус. Якщо завантаження — ваша основна потреба, є інші додатки, присвячені саме цій функції, які варто розглянути. Єдине, чого цей додаток не робить — це вбудовування відеоплеєра. Ми вважаємо, що веб-плеєр YouTube сам по собі вже достатньо доступний. Якщо вам все ж бракує цього, ви можете скористатися іншими додатками, такими як browserNav, щоб покращити взаємодію.

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

Цей додаток використовує систему скорочень на основі шарів, щоб уникнути конфліктів з іншими додатками чи командами NVDA. Натисніть NVDA+Y, щоб увійти в режим команд YoutubePlus, а потім натисніть одну з наведених нижче клавіш, щоб отримати доступ до відповідної функції чи вікна.

Примітка: Якщо основне скорочення (NVDA+Y) конфліктує з іншим додатком, ви можете змінити його через NVDA -> Налаштування -> Жести введення... у категорії "YoutubePlus".

Клавіші, доступні в шарі YoutubePlus

Примітка: Для команд, що діють безпосередньо на відео, додаток спочатку перевіряє відкрите вікно браузера. Якщо активна сторінка відео YouTube, використовується URL-адреса цього відео. Якщо жодної сторінки відео не відкрито, додаток перевіряє буфер обміну на наявність URL-адреси YouTube.

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

a: (add to...)

Ця команда в шарі YoutubePlus надсилає інформацію про відео чи канал до вибраного місця призначення:

Додаток спочатку перевіряє поточно відкриту сторінку браузера. Якщо це сторінка відео YouTube, він добуває URL-адресу та обробляє її відповідно до вашого вибору. Якщо сторінка не є відео YouTube або жоден браузер не відкрито, додаток перевіряє буфер обміну на наявність URL-адреси YouTube.

Більшість команд працюють з будь-яким типом URL-адреси YouTube, оскільки додаток може самостійно визначити потрібну інформацію. Наприклад, якщо ви перебуваєте на сторінці відео та обираєте «Add to Favorite Channels», додаток може автоматично добути URL-адресу каналу. Те саме стосується підписки на канал.

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

d: (download video/audio)

Ця команда відкриває невелике діалогове вікно із запитанням, чи хочете ви завантажити відео, чи лише аудіо. Місце завантаження, а також докладніше налаштування якості/формату, можна вказати в розділі Налаштувань.

Завантаження відео потребує FFmpeg. YouTube більше не надає більшість відео як єдиний файл із поєднаними відео та аудіо, тож для об'єднання окремих потоків потрібен FFmpeg. YoutubePlus не постачає FFmpeg у комплекті (щоб не роздувати конфігурацію NVDA кожного користувача без потреби) — якщо FFmpeg не знайдено у вашій системі під час завантаження відео, а інструмент Windows winget доступний, YoutubePlus запропонує встановити його автоматично одним простим запитанням «так/ні»; після встановлення завантаження продовжиться автоматично без потреби перезапускати NVDA. Якщо немає ні FFmpeg, ні winget, вас повідомлять про це, і завантаження буде акуратно скасовано.

Завантаження лише аудіо за замовчуванням не потребує FFmpeg. Він потрібен лише тоді, коли ви обрали формат аудіо, відмінний від «Best available (no conversion)» у розширених налаштуваннях формату нижче, оскільки конвертація в інший формат аудіо також відбувається через FFmpeg.

Зверніть увагу, що функція завантаження надається для зручності й може мати обмеження за інтенсивного використання. Якщо вам потрібно завантажувати великі обсяги вмісту YouTube, рекомендуємо інші спеціалізовані інструменти.

e: (search)

Ця команда відкриває вікно пошуку YouTube. Введіть запит у полі пошуку та натисніть Enter, щоб одразу почати пошук. Ви також можете натиснути Tab, щоб налаштувати кількість результатів для показу — додаток запам'ятовує це значення для майбутніх пошуків.

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

Результати відображаються в тому ж форматі списку відео, що використовується в усьому додатку, а не як вебсторінка YouTube. Ви можете отримати доступ до всіх деталей відео так само, як і в будь-якому іншому списку відео додатка.

q: (quick search)

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

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

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

i: (video info)

Показує такі деталі поточного відео:

t: (timestamp / chapter)

Показує список міток часу або розділів відео (якщо творець додав цю інформацію). Якщо додаток повідомляє «No chapters found in this video», відео просто не містить даних про розділи.

Це вікно зручніше за читання розділів у браузері, оскільки має:

g: (get thumbnail description)

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

Додаток завжди обирає зображення з найвищою роздільною здатністю, яку повідомляє yt-dlp, тож файл, надісланий до Be My Eyes, завжди найкращий з доступних.

Ви також можете отримати опис аватара каналу або обкладинки плейліста прямо з вікна «Вибране», не відкриваючи цю сторінку ніде — див. кнопки Describe Avatar та Describe Cover в розділі Обране нижче.

Примітка: Ця функція потребує окремого встановлення застосунку Be My Eyes на вашому пристрої — додаток не встановлює і не постачає його. Якщо застосунок не встановлено, YoutubePlus запропонує відкрити його сторінку в Microsoft Store, щоб ви могли встановити його одразу.

Обране

Вікно, що показує ваше збережене обране, поділене на 5 вкладок за типом:

Команди вікна «Обране»

Категорії (вкладки Video та Watch List)

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

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

Коли фокус на списку елементів (правий бік), клацніть правою кнопкою миші або натисніть клавішу «Застосунок»/«Меню», щоб відкрити те саме меню «Дія», що використовується в усьому додатку (View Info, Comments, Download, Add to... тощо) — окремо від контекстного меню категорій на дереві.

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

Сортування

Кнопка Sort... (Alt+O) доступна на будь-якій вкладці зі списком, який можна сортувати — включно з Video, Watch List, і Search History. Вона відкриває діалог із:

Список відео

На вкладках відео та списку перегляду, а також у будь-якому іншому перегляді, що показує список відео, ви знайдете кнопки Action... та Copy.... Це стандартні елементи керування в усіх переглядах списку відео, причому стрічка підписок додає додаткову опцію «Unsubscribe from this channel».

Натисніть Enter на будь-якому елементі, щоб відкрити відео в браузері, або натисніть пробіл, щоб виконати Швидку дію, яку можна налаштувати в Налаштуваннях.

Кнопка «Дія»

Натисніть Alt+A, щоб відкрити меню «Дія», яке включає:

Кнопка «Копіювати»

Натисніть Alt+C, щоб відкрити меню «Копіювати», яке включає:

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

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

На відміну від вікна «Обране», цей перегляд використовує стандартні вкладки, поділені за типом вмісту:

Окрім цих категорій за замовчуванням, ви можете створювати власні категорії та налаштовувати, які канали з'являються в кожній із них.

Команди стрічки підписок

Додаткові кнопки в цьому вікні:

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

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

Керування профілями користувача

Це вікно керує вашими профілями користувача. Додаток постачається з профілем "default". Ви можете додавати, видаляти чи перейменовувати профілі тут. Щоб перемкнутися між профілями, перейдіть на панель Налаштувань додатка.

У цьому вікні:

Примітка: Видалення профілю остаточно видаляє всі пов'язані з ним дані. Будь-які збережені відео, канали чи підписки в цьому профілі буде втрачено.

l: (show comments)

У відео YouTube є три типи коментарів:

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

Live chat of...

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

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

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

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

Три налаштування безпосередньо впливають на цю функцію:

Коли трансляція завершується — або додаток виявляє, що вона завершилася — автоматично з'явиться діалог із запитанням, чи хочете ви експортувати всі зібрані повідомлення. Натисніть «Так», щоб зберегти історію чату як файл.

Comments / Live chat replay

Для звичайних завантажених відео чи архівованих трансляцій ви можете отримати доступ до коментарів так само. Якщо доступні і повтор чату наживо, і стандартні коментарі, діалог запитає, що ви хочете завантажити.

Немає обмеження на кількість показаних коментарів, хоча завантаження може зайняти час для відео з великою кількістю коментарів.

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

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

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

Отримайте доступ до налаштувань через NVDA -> Налаштування -> Параметри... та виберіть категорію "YoutubePlus".

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

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

Про yt-dlp

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

Тим не менш, майте на увазі такі рекомендації щодо використання:

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

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