FreeRadio — додаток для NVDA

<h1>FreeRadio — додаток для NVDA</h1>
<p>FreeRadio — це додаток для прослуховування інтернет-радіо, призначений для екранного зчитувача NVDA. Його головна мета — надати користувачам простий доступ до тисяч інтернет-радіостанцій. Весь інтерфейс та всі функції розроблені з урахуванням повної доступності для NVDA.</p>
<h2>Каталог Браузер радіостанцій</h2>
<p>FreeRadio використовує відкриту базу даних <a href="https://www.radio-browser.info/">Браузер радіостанцій</a> для свого каталогу станцій. Браузер радіостанцій — це безкоштовний каталог, яким керує спільнота і який містить понад 50 000 інтернет-радіостанцій з усього світу. Реєстрація чи обліковий запис не потрібні, а його API відкритий для всіх. Кожна станція містить інформацію про адресу, країну, жанр, мову та бітрейт; станції сортуються за вподобаннями користувачів. FreeRadio підключається до цього API через дзеркальні сервери, розташовані в Німеччині, Нідерландах та Австрії; якщо один сервер недоступний, він автоматично перемикається на наступний.</p>
<h2>Додавання станції до Браузера радіостанцій</h2>
<p>Якщо станція, яку ви шукаєте, відсутня в каталозі Браузера радіостанцій, ви можете додати її самостійно за адресою <a href="https://www.radio-browser.info/add">https://www.radio-browser.info/add</a>. Обліковий запис чи реєстрація не потрібні.</p>
<p>Заповніть форму на цій сторінці:</p>
<ul>
<li><strong>URL потоку</strong> <em>(обов'язково)</em> — прямий URL аудіопотоку, що закінчується на <code>.mp3</code>, <code>.aac</code>, <code>.ogg</code> або подібне. Це не адреса веб-сайту станції; це адреса самого потоку, яку ви вставляєте в медіаплеєр. Більшість станцій публікують URL свого потоку на своєму веб-сайті або в розділі «Слухати в прямому ефірі».</li>
<li><strong>Назва станції</strong> <em>(обов'язково)</em> — назва станції, як вона має з'являтися в каталозі.</li>
<li><strong>Головна сторінка</strong> — адреса веб-сайту станції.</li>
<li><strong>Країна та мова</strong> — виберіть країну та мову з комбінованих списків.</li>
<li><strong>Теги</strong> — ключові слова жанру або теми, розділені комами, наприклад <code>новини</code>, <code>джаз</code>, <code>класика</code>. Вони використовуються для пошуку та фільтрування.</li>
<li><strong>URL логотипу</strong> — пряме посилання на зображення логотипу станції, якщо воно є.</li>
</ul>
<p>Після надсилання станція проходить перевірку та додається до публічного каталогу. Після затвердження вона автоматично з’явиться у пошуку FreeRadio та списках країн, оскільки каталог оновлюється з API в режимі реального часу.</p>
<h2>Вимоги</h2>
<ul>
<li>NVDA 2024.1 або пізніша версія</li>
<li>Windows 10 або пізніша версія</li>
<li>Підключення до Інтернету</li>
</ul>
<h2>Встановлення</h2>
<p>Завантажте файл <code>.nvda-addon</code>, натисніть на ньому Enter і перезапустіть NVDA, коли буде запропоновано.</p>
<h2>Комбінації клавіш</h2>
<p>Усі комбінації можна перепризначити в меню NVDA → Параметри → Жести вводу → FreeRadio. Ці комбінації працюють будь-де, незалежно від того, який діалог сфокусований.</p>
<table>
<thead>
<tr>
<th>Комбінація</th>
<th>Функція</th>
<th>Опис</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>Ctrl+Win+R</code></td>
<td>Відкрити браузер радіостанцій</td>
<td>Відкриває діалог браузера радіостанцій, якщо він закритий, або виводить його на передній план, якщо він вже відкритий.</td>
</tr>
<tr>
<td><code>Ctrl+Win+P</code></td>
<td>Пауза / відновлення</td>
<td>Зупиняє поточну станцію, якщо вона відтворюється; відновлює, якщо була призупинена. Якщо нічого не відтворюється, запускає останню станцію або відкриває список улюблених залежно від ваших налаштувань. Подвійне натискання одразу переходить до вибраної вкладки. Триразове натискання виконує окрему дію залежно від вашого налаштування.</td>
</tr>
<tr>
<td><code>Ctrl+Win+S</code></td>
<td>Зупинити</td>
<td>Повністю зупиняє поточну станцію та скидає плеєр.</td>
</tr>
<tr>
<td><code>Ctrl+Win+→</code></td>
<td>Наступна улюблена</td>
<td>Переходить до наступної станції у списку улюблених. У кінці списку переходить на початок.</td>
</tr>
<tr>
<td><code>Ctrl+Win+←</code></td>
<td>Попередня улюблена</td>
<td>Переходить до попередньої станції у списку улюблених. На початку списку переходить у кінець.</td>
</tr>
<tr>
<td><code>Ctrl+Win+↑</code></td>
<td>Збільшити гучність</td>
<td>Збільшує гучність на 5; максимум 200.</td>
</tr>
<tr>
<td><code>Ctrl+Win+↓</code></td>
<td>Зменшити гучність</td>
<td>Зменшує гучність на 5; мінімум 0.</td>
</tr>
<tr>
<td><code>Ctrl+Win+V</code></td>
<td>Додати до улюблених</td>
<td>Додає станцію, що зараз відтворюється, до списку улюблених. Повідомляє, якщо станція вже є у списку.</td>
</tr>
<tr>
<td><code>Ctrl+Win+I</code></td>
<td>Інформація про станцію</td>
<td>Повідомляє назву станції, що зараз відтворюється. Натисніть двічі, щоб у діалозі показати деталі, такі як країна, жанр та бітрейт. Натисніть тричі, щоб скопіювати інформацію про поточний трек (метадані ICY) до буфера обміну, якщо вона доступна; якщо метадані відсутні, замість цього запускається розпізнавання музики Shazam. Натисніть чотири рази, щоб примусово запустити розпізнавання музики у разі неправильних метаданих ICY.</td>
</tr>
<tr>
<td><code>Ctrl+Win+M</code></td>
<td>Дзеркальний показ аудіо</td>
<td>Одночасно дзеркально показує потік на додатковий пристрій виведення аудіо. Натисніть ще раз, щоб зупинити дзеркальний показ.</td>
</tr>
<tr>
<td><code>Ctrl+Win+E</code></td>
<td>Миттєвий запис</td>
<td>Натисніть один раз, щоб почати запис поточної станції; натисніть ще раз, щоб зупинити. Натисніть <strong>двічі</strong>, щоб почати <strong>запис треку</strong> — файл отримає назву поточного треку, а запис автоматично зупиниться, коли трек зміниться. Натисніть двічі, поки запис треку активний, щоб зупинити його достроково. Відтворення продовжується без перерв у всіх режимах запису. Доступно лише для станцій, що транслюють метадані ICY.</td>
</tr>
<tr>
<td><code>Ctrl+Win+W</code></td>
<td>Відкрити папку записів</td>
<td>Відкриває папку із записаними файлами у Провіднику файлів.</td>
</tr>
<tr>
<td><code>Ctrl+Win+J</code></td>
<td>Тайм-шифт — перемотування назад</td>
<td>Перемотує живе радіо на 15 секунд назад. Перше натискання активує режим тайм-шифту; кожне наступне перемотує ще на 15 секунд назад, до межі буфера (~10 хвилин). Потребує увімкненого буфера тайм-шифту в Налаштуваннях.</td>
</tr>
<tr>
<td><code>Ctrl+Win+K</code></td>
<td>Тайм-шифт — перемотування вперед</td>
<td>Перемотує на 15 секунд вперед у режимі тайм-шифту. Досягнувши краю прямого ефіру, відтворення автоматично повертається до прямого ефіру, і команда не має ефекту до наступного перемотування назад.</td>
</tr>
<tr>
<td><code>Ctrl+Win+T</code></td>
<td>Увімкнути/вимкнути буфер тайм-шифту</td>
<td>Миттєво вмикає або вимикає буфер тайм-шифту, відображаючи стан прапорця в Налаштуваннях. При вимкненні негайно повертає до прямого ефіру (якщо активний тайм-шифт) та зупиняє фонове захоплення.</td>
</tr>
<tr>
<td><em>(непризначено)</em></td>
<td>Увімкнути/вимкнути сповіщення про вимкнення звуку</td>
<td>Увімкнути або вимкнути налаштування «Сповіщення про вимкнення звуку» миттєво. Призначте комбінацію клавіш через меню NVDA → Параметри → Жести вводу → FreeRadio.</td>
</tr>
</tbody>
</table>
<p>Клавіші «Наступний» та «Попередній» призначені лише для навігації по списку улюблених станцій; вони не працюють зі списком усіх станцій. Коли у діалозі браузера радіостанцій виділено список, клавіші зі стрілками вліво та вправо виконують одну й ту саму функцію — див. «Клавіші швидкого доступу в діалогах».</p>
<h2>Браузер радіостанцій</h2>
<p>FreeRadio також додає підменю <strong>FreeRadio</strong> до меню «Інструменти» NVDA. Звідти ви можете безпосередньо відкрити браузер станцій та налаштування FreeRadio.</p>
<p>Діалог, що відкривається за допомогою комбінації клавіш <code>Ctrl+Win+R</code>, містить п’ять вкладок: «Усі станції», «Улюблене», «Запис», «Таймер» та «Улюблені треки». Переміщатися між вкладками можна за допомогою комбінації клавіш <code>Ctrl+Tab</code>.</p>
<p>Коли відкривається вкладка «Усі станції», 1000 станцій, що набрали найбільшу кількість вподобань, автоматично завантажуються з браузера радіостанцій. Вибір країни зі списку оновлює список, показуючи станції цієї країни. Введення тексту в поле пошуку миттєво  виконує повний пошук по всій базі даних браузера радіостанцій одночасно за назвою, країною та жанром.</p>
<p>Комбінований список <strong>Пристрій виводу</strong> у нижній частині діалога браузера радіостанцій — поза вкладками — містить список усіх аудіопристроїв, розпізнаних BASS. Вибір пристрою негайно перенаправляє аудіовивід на нього та зберігає вибір назавжди; той самий пристрій автоматично використовується в наступній сесії. Якщо вибраний пристрій не підключено, додаток автоматично повертається до системного значення. Цей елемент керування працює лише тоді, коли активний бекенд BASS.</p>
<p>Елементи керування <strong>Гучність</strong> (0–200) та <strong>Ефекти</strong> у цій же області можна налаштовувати в будь-який час, поки діалог відкритий. У списку ефектів можна одночасно ввімкнути хор, компресор, спотворення, ехо, фленджер, булькання, реверберацію, еквалайзер: підсилення низьких частот, еквалайзер: підсилення високих частот та еквалайзер: підсилення вокалу; зміни миттєво застосовуються до активного потоку. Ці елементи керування повністю функціонують лише тоді, коли активний бекенд BASS.</p>
<p>Коли ввімкнено один або кілька ефектів еквалайзера, для кожної активної смуги з’являється <strong>регулятор підсилення</strong>. Рівень посилення можна встановити в діапазоні від −15 дБ до +15 дБ; початкове значення — «Баси» +9 дБ, «Високі частоти» +9 дБ та «Вокал» +6 дБ. Регулятори посилення відображаються лише для тих смуг еквалайзера, які наразі позначені, і автоматично приховуються, коли ефекти еквалайзера знімаються. Значення посилення зберігаються глобально та відновлюються під час наступної сесії.</p>
<p>Кнопка <strong>Відтворення/Пауза</strong> також розташована внизу діалога. Якщо жодна станція не відтворюється, вона запускає вибрану станцію; якщо станція вже відтворюється, вона призупиняє відтворення.</p>
<p>Коли станція вибрана у списку, кнопка <strong>Інформація про станцію</strong> показує таку інформацію, як країна, мова, жанр, формат, бітрейт, веб-сайт та URL потоку в окремому діалозі. Кожне поле показується у власному текстовому полі, доступному лише для читання; ви можете переходити між полями за допомогою клавіші Tab та скопіювати всю інформацію до буфера обміну одночасно за допомогою кнопки <strong>Копіювати все до буфера обміну</strong>. Ця кнопка доступна як на вкладці «Усі станції», так і на вкладці «Улюблене».</p>
<h3>Комбінації клавіш у діалозі</h3>
<p>Наступні клавіші працюють лише тоді, коли діалог Браузера радіостанцій активний.</p>
<h3>Клавіші F</h3>
<table>
<thead>
<tr>
<th>Комбінація</th>
<th>Функція</th>
<th>Опис</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>F1</code></td>
<td>Довідка</td>
<td>Відкриває файл довідки додатка у браузері. Спочатку здійснюється пошук довідки для мови, яка використовується в NVDA; якщо її не знайдено, відкривається довідка початковою мовою.</td>
</tr>
<tr>
<td><code>F2</code></td>
<td>Що зараз відтворюється</td>
<td>Оголошує назву станції та треку, що зараз відтворюються. Натисніть двічі, щоб у діалозі показати детальну інформацію, таку як країна, жанр та бітрейт. Натисніть тричі, щоб скопіювати інформацію про поточний трек (метадані ICY) до буфера обміну, якщо вона доступна; якщо метадані відсутні, замість цього запускається розпізнавання треків Shazam. Натисніть чотири рази, щоб примусово запустити розпізнавання музики у разі неправильних метаданих ICY.</td>
</tr>
<tr>
<td><code>F3</code></td>
<td>Попередня станція</td>
<td>Переходить до попередньої станції на вкладці «Усі станції» або «Улюблене» та негайно починає відтворення. Переходить до кінця, якщо знаходиться на початку списку.</td>
</tr>
<tr>
<td><code>F4</code></td>
<td>Наступна станція</td>
<td>Переходить до наступної станції у вкладці «Усі станції» або «Улюблене» та негайно починає відтворення. Переходить до початку, якщо знаходиться в кінці списку.</td>
</tr>
<tr>
<td><code>F5</code></td>
<td>Зменшити гучність</td>
<td>Зменшує гучність на 5 (мінімум 0).</td>
</tr>
<tr>
<td><code>F6</code></td>
<td>Збільшити гучність</td>
<td>Збільшує гучність на 5 (максимум 200).</td>
</tr>
<tr>
<td><code>F7</code></td>
<td>Пауза / продовження</td>
<td>Призупиняє відтворення, якщо станція відтворюється; продовжує відтворення, якщо вона була призупинена і медіа завантажено.</td>
</tr>
<tr>
<td><code>F8</code></td>
<td>Зупинка</td>
<td>Повністю зупиняє поточну станцію та скидає плеєр.</td>
</tr>
<tr>
<td><code>F9</code></td>
<td>Перейменувати</td>
<td>Відкриває діалог перейменування для станції, що знаходиться у фокусі на вкладці «Улюблене».</td>
</tr>
</tbody>
</table>
<h3>Список комбінацій клавіш для навігації</h3>
<table>
<thead>
<tr>
<th>Комбінація</th>
<th>Функція</th>
<th>Опис</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>→</code></td>
<td>Наступна станція</td>
<td>Якщо активним є список «Усі станції» або «Улюблене», переходить до наступної станції та негайно починає її відтворення. У разі досягнення кінця списку переходить до початку.</td>
</tr>
<tr>
<td><code>←</code></td>
<td>Попередня станція</td>
<td>Якщо активним є список «Усі станції» або «Улюблене», переходить до попередньої станції та негайно починає її відтворення. У разі досягнення початку списку переходить до кінця.</td>
</tr>
<tr>
<td><code>Enter</code></td>
<td>Відтворити</td>
<td>Коли активним є список «Усі станції» або «Улюблене», негайно починає відтворення вибраної станції. Перемикається на вибрану станцію, навіть якщо вже відтворюється інша станція.</td>
</tr>
<tr>
<td><code>Пробіл</code></td>
<td>Відтворити / Пауза</td>
<td>Призупиняє відтворення, якщо станція вже відтворюється; в іншому випадку починає відтворення вибраної станції.</td>
</tr>
<tr>
<td><code>Ctrl+Tab</code></td>
<td>Наступна вкладка</td>
<td>Переходить до наступної вкладки (Усі станції → Улюблене → Запис → Таймер → Улюблені треки).</td>
</tr>
<tr>
<td><code>Ctrl+Shift+Tab</code></td>
<td>Попередня вкладка</td>
<td>Переходить до попередньої вкладки.</td>
</tr>
<tr>
<td><code>Escape</code></td>
<td>Сховати</td>
<td>Сховає діалог; додаток продовжує відтворення у фоновому режимі.</td>
</tr>
</tbody>
</table>
<h3>Комбінації гучності</h3>
<table>
<thead>
<tr>
<th>Комбінація</th>
<th>Функція</th>
<th>Опис</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>Ctrl+↑</code></td>
<td>Збільшити гучність</td>
<td>Збільшує гучність на 5 одиниць. Працює лише тоді, коли діалог браузера радіостанцій відкритий.</td>
</tr>
<tr>
<td><code>Ctrl+↓</code></td>
<td>Зменшити гучність</td>
<td>Зменшує гучність на 5 одиниць. Працює лише тоді, коли діалог браузера радіостанцій відкритий.</td>
</tr>
</tbody>
</table>
<h3>Комбінації клавіш Alt</h3>
<table>
<thead>
<tr>
<th>Комбінація</th>
<th>Функція</th>
<th>Опис</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>Alt+R</code></td>
<td>Перейти до поля пошуку</td>
<td>Переміщує фокус у поле введення тексту для пошуку. Здійснює пошук у Браузері радіостанцій за текстом у полі пошуку; одночасно шукаються назва, країна та жанр.</td>
</tr>
<tr>
<td><code>Alt+V</code></td>
<td>Додати / видалити з улюблених</td>
<td>Додає вибрану станцію до улюблених; видаляє її, якщо вона вже є у списку.</td>
</tr>
<tr>
<td><code>Alt+1</code></td>
<td>Усі станції</td>
<td>Переходить на вкладку «Усі станції».</td>
</tr>
<tr>
<td><code>Alt+2</code></td>
<td>Улюблене</td>
<td>Переходить на вкладку «Улюблене».</td>
</tr>
<tr>
<td><code>Alt+3</code></td>
<td>Запис</td>
<td>Переходить на вкладку «Запис».</td>
</tr>
<tr>
<td><code>Alt+4</code></td>
<td>Таймер</td>
<td>Перехід на вкладку «Таймер».</td>
</tr>
<tr>
<td><code>Alt+5</code></td>
<td>Улюблені треки</td>
<td>Перехід на вкладку «Улюблені треки».</td>
</tr>
<tr>
<td><code>Alt+K</code></td>
<td>Закрити</td>
<td>Закриває діалог; додаток продовжує відтворення у фоновому режимі.</td>
</tr>
</tbody>
</table>
<h2>Улюблене</h2>
<p>Список улюблених — це особиста колекція радіостанцій, яка зберігається постійно. Щоб додати радіостанцію, виберіть її у списку та натисніть кнопку «Додати до улюблених» або скористайтеся комбінацією клавіш <code>Alt+V</code>. Ця ж комбінація клавіш видаляє радіостанцію, яка вже є у списку, після її вибору.</p>
<p>До улюбленого можна перейти за допомогою комбінацій клавіш <code>Ctrl+Win+→</code> та <code>Ctrl+Win+←</code>; ці комбінації працюють навіть тоді, коли діалог браузера радіостанцій закритий.</p>
<p>Щоб видалити станцію зі списку улюблених, виберіть її та натисніть кнопку <strong>Видалити станцію</strong> або клавішу <code>Delete</code>. Після видалення фокус та вибір автоматично переходять до наступної станції у списку. Якщо видалена станція була останньою, фокус переходить до попередньої станції. Якщо список стає порожнім, фокус переходить до кнопки «Відтворити».</p>
<h3>Експорт та імпорт улюблених</h3>
<p>Вкладка «Улюблене» містить дві кнопки для резервного копіювання та відновлення списку станцій:</p>
<p><strong>Експортувати улюблені…</strong> — зберігає весь список улюблених у файл. У діалозі збереження можна вибрати один із двох форматів:
- <strong>JSON</strong> (<code>.json</code>) — повна резервна копія, що зберігає назви станцій, URL-адреси потоків і всі метадані. Рекомендується для подальшого відновлення списку або його перенесення на інший комп'ютер.
- <strong>Плейлист M3U</strong> (<code>.m3u</code>) — стандартний формат плейлиста, сумісний із більшістю медіаплеєрів і радіододатків. Зверніть увагу, що M3U не зберігає всі метадані станцій, тому відновлення з M3U може містити менше деталей, ніж резервна копія JSON.</p>
<p><strong>Імпортувати улюблені…</strong> — завантажує станції з раніше експортованого файлу JSON або M3U. Після вибору файлу пропонується вибрати спосіб додавання станцій:
- <strong>Так (Об'єднати)</strong> — додає імпортовані станції до наявного списку, не видаляючи поточні улюблені. Дублікати не додаються повторно.
- <strong>Ні (Замінити)</strong> — повністю очищає поточний список улюблених і замінює його вмістом імпортованого файлу.
- <strong>Скасувати</strong> — повертається до браузера без внесення жодних змін.</p>
<p>Після успішного імпорту список улюблених, список станцій для запланованих записів і список станцій таймера оновлюються автоматично.</p>
<h3>Зміна порядку в списку улюблених</h3>
<p>Вибравши станцію на вкладці «Улюблене», натисніть клавішу «кома», щоб увійти в режим переміщення — пролунає звуковий сигнал. Перейдіть до потрібної позиції за допомогою клавіш зі стрілками, а потім знову натисніть клавішу «кома». Станція буде розміщена у вибраній позиції, а нове розташування одразу збережеться. Повторне натискання клавіші «кома» у цій же позиції скасує переміщення.</p>
<h3>Додавання користувацької станції</h3>
<p>Щоб додати станцію, якої немає в Браузері радіостанцій, скористайтеся кнопкою «Додати користувацьку станцію». У діалозі, що з’явиться, введіть назву станції та URL потоку, щоб додати її безпосередньо до списку улюблених. Власні станції можна відтворювати та змінювати їхній порядок так само, як і будь-які інші улюблені станції.</p>
<h3>Аудіопрофіль станції</h3>
<p>На вкладці «Улюблені» є дві кнопки для керування налаштуваннями звуку для кожної станції:</p>
<p><strong>Зберегти аудіопрофіль для цієї станції</strong> — зберігає поточний рівень гучності, активні ефекти (хор, еквалайзер тощо) та значення підсилення еквалайзера як профіль, прив’язаний до цієї конкретної станції. Щоразу, коли починається відтворення цієї станції, її збережені налаштування гучності, ефектів та підсилення автоматично застосовуються, замінюючи загальні початкові налаштування .</p>
<p><strong>Очистити аудіопрофіль</strong> — видаляє збережений аудіопрофіль з вибраної станції. Після очищення станція повертається до загальних налаштувань гучності, ефектів та підсилення еквалайзера. Ця кнопка активна лише тоді, коли вибрана станція вже має збережений профіль.</p>
<p>Обидві кнопки розташовані під списком улюблених і стають активними лише тоді, коли у списку вибрано станцію.</p>
<h2>Розпізнавання треків</h2>
<p>Тричі натиснувши <code>Ctrl+Win+I</code>, запускається розпізнавання треків на основі Shazam для потоку, що відтворюється. Розпізнавання починається лише тоді, коли метадані ICY (інформація про трек, що транслюється станцією) недоступні; якщо метадані присутні, вони копіюються в буфер обміну.</p>
<p>Розпізнавання працює наступним чином: за допомогою ffmpeg із потоку витягується короткий аудіофрагмент, до нього застосовується алгоритм Shazam для визначення «відбитка», а результат надсилається на сервери Shazam. Якщо розпізнавання проходить успішно, назва треку, виконавець, альбом та рік випуску оголошуються NVDA та автоматично копіюються до буфера обміну. Якщо увімкнено опцію <strong>Зберегти вподобані пісні у текстовий файл</strong>, результат розпізнавання також додається до файлу <code>likedSongs.txt</code>.</p>
<p><strong>Аудіосигнали:</strong> Два висхідних звукових сигнали лунають, коли розпізнавання починається, і два низхідних — коли воно закінчується. Короткий звуковий сигнал відтворюється кожні 2 секунди, доки процес триває.</p>
<p><strong>Вимога:</strong> Потрібна наявність ffmpeg.exe. Якщо ffmpeg.exe знаходиться у папці додатка, він використовуватиметься автоматично; якщо в іншому місці — шлях можна вказати в Налаштуваннях. Завантажити ffmpeg можна з <a href="https://ffmpeg.org/download.html">ffmpeg.org</a>.</p>
<h2>Дзеркало аудіо</h2>
<p>Комбінація клавіш <code>Ctrl+Win+M</code> дозволяє одночасно відтворювати потокове аудіо на другому пристрої відтворення. Це зручно, коли потрібно слухати аудіо одночасно на двох різних пристроях, наприклад на колонках і навушниках.</p>
<p>Після першого натискання з’являється діалог з переліком доступних пристроїв виведення. Як тільки пристрій обрано, починається дзеркальне відтворення, при цьому основне відтворення не переривається. Повторне натискання зупиняє дзеркалювання.</p>
<p><strong>Приклади використання:</strong>
- <strong>Динаміки + навушники</strong> — Гість може слухати той самий потік в навушниках, поки ви слухаєте його через динаміки комп’ютера.
- <strong>Налаштування запису</strong> — Направте сигнал головного виходу на колонки, а сигнал другого виходу — на зовнішній записний пристрій або аудіоінтерфейс для зовнішнього запису.
- <strong>Multi-room</strong> — Відтворюйте треки одночасно через Bluetooth-колонку та вбудований динамік; для передачі звуку в іншу кімнату не потрібно додаткового програмного забезпечення.
- <strong>Дистанційний моніторинг</strong> — під час сеансу спільного використання екрана або віддаленого доступу до робочого столу як локальний, так і віддалений користувач можуть одночасно слухати один і той самий аудіопотік.</p>
<blockquote>
<p><strong>Примітка:</strong> Функція дзеркального аудіо доступна лише тоді, коли активний бекенд BASS. Якщо під час дзеркального відтворення змінити гучність, обидва виходи оновлюються одночасно.</p>
</blockquote>
<h2>Запис</h2>
<p>Записи початково зберігаються у папці <code>Documents\FreeRadio Recordings\</code>. Назва файлу містить назву станції (або назву трека у режимі запису трека) та час початку запису. Папку для записів можна змінити у будь-який час: Меню NVDA → Налаштування → FreeRadio → <strong>Папка для записів</strong>. Оскільки механізм запису підключається безпосередньо до потоку, аудіо записується на диск у тому вигляді, у якому його отримано — обробка або повторне кодування не застосовується; якість запису ідентична якості трансляції.</p>
<p><strong>Миттєвий запис:</strong> під час відтворення станції натисніть Ctrl+Win+E один раз. Натисніть знову, щоб зупинити. Відтворення при цьому не переривається.</p>
<p><strong>Запис трека:</strong> Натисніть комбінацію клавіш <code>Ctrl+Win+E</code> <strong>двічі</strong> під час відтворення станції, яка транслює метадані ICY. Запис розпочнеться негайно, а його назва буде відповідати назві поточного треку. Коли трек зміниться, запис автоматично зупиниться, і NVDA оголосить назву збереженого файлу. Якщо ви хочете завершити запис до закінчення треку, знову натисніть <code>Ctrl+Win+E</code> двічі. Якщо поточна станція не транслює метадані ICY, запис трека недоступний, і NVDA повідомить вас про це.</p>
<p><strong>Запланований запис:</strong> Відкрийте вкладку Запис у браузері радіостанцій. Виберіть станцію з улюблених, введіть час початку у форматі ГГ:ХХ і тривалість у хвилинах, виберіть один або кілька активних днів, потім оберіть режим повторення та режим запису:</p>
<p><strong>Активні дні:</strong> Позначте один або кілька днів тижня. У режимі одноразового запису для кожного вибраного дня створюється окремий запис, встановлений на найближче настання цього дня. У режимі повторення запис виконується лише у позначені дні. Якщо жодного дня не вибрано, запис не обмежується конкретними днями.</p>
<p><strong>Режим повторення:</strong>
- <strong>Записати один раз</strong> — створює одноразовий запис для кожного вибраного дня. Кожен запис встановлюється на найближче настання цього дня; якщо сьогоднішній час вже минув, запис автоматично переноситься на наступний тиждень.
- <strong>Повторювати щотижня</strong> — повторюється щотижня у вибрані активні дні до видалення зі списку розкладу.</p>
<p><strong>Режим запису:</strong>
- <strong>Запис під час прослуховування</strong> — одночасне відтворення та запис. Для відтворення використовується один із програвачів у порядку пріоритетності: BASS → VLC → PotPlayer → Windows Media Player.
- <strong>Тільки запис</strong> — запис у фоновому режимі без відтворення звуку; механізм запису підключається безпосередньо до потоку.</p>
<p>NVDA сповіщає про початок і завершення запису. Якщо NVDA перезапускається під час активного запланованого запису, запис автоматично відновлюється під час запуску.</p>
<h2>Тайм-шифт (перемотування живого радіо)</h2>
<p>Тайм-шифт дозволяє перемотувати станцію, яку ви слухаєте, як DVR або касета — зупиніть момент, поверніться на кілька хвилин назад і доженіть прямий ефір, коли захочете. Відтворення при цьому не зупиняється: перемотування назад і вперед відбувається миттєво на тому ж аудіопотоці.</p>
<p>Функція <strong>вимкнена за замовчуванням</strong>. Увімкніть її в меню NVDA → Налаштування → Параметри → FreeRadio → <strong>Увімкнути буфер тайм-шифту (перемотування прямого радіо, ~10 хвилин)</strong>, або миттєво перемикайте будь-коли за допомогою <code>Ctrl+Win+T</code>.</p>
<h3>Як це працює</h3>
<p>Після увімкнення FreeRadio безперервно захоплює відтворювану станцію у плаваючий локальний буфер у фоновому режимі. Буфер містить приблизно <strong>останні 10 хвилин</strong> звуку; старий звук автоматично видаляється з початку в міру надходження нового, тому буфер завжди представляє «недавнє минуле» відносно краю прямого ефіру.</p>
<ul>
<li><strong><code>Ctrl+Win+J</code></strong> — Перемотати на 15 секунд назад. Перше натискання переключає вас з живого відтворення у режим тайм-шифту, починаючи з 15 секунд позаду краю прямого ефіру. Кожне наступне натискання перемотує ще на 15 секунд назад.</li>
<li><strong><code>Ctrl+Win+K</code></strong> — Перемотати на 15 секунд вперед у режимі тайм-шифту. Досягнувши краю прямого ефіру, відтворення автоматично переключається назад до прямого потоку, і NVDA оголошує «Повернутися до прямого ефіру».</li>
<li><strong><code>Ctrl+Win+T</code></strong> — Вмикає або вимикає всю функцію. Вимкнення в режимі тайм-шифту негайно повертає до прямого ефіру та зупиняє фонове захоплення для поточної станції.</li>
</ul>
<p>Фонове захоплення продовжується весь час, поки активний тайм-шифт, тому край прямого ефіру продовжує рухатися вперед, навіть коли ви слухаєте щось кількахвилинної давнини — точно як справжній DVR.</p>
<h3>Увімкнення та прогрів буфера</h3>
<p>Буфер починає заповнюватися, щойно станція починає грати (при увімкненій функції) або в момент, коли ви вмикаєте функцію під час прослуховування станції. Тому перемотування можливе лише після того, як реально накопичено кілька секунд звуку — якщо натиснути <code>Ctrl+Win+J</code> одразу після переключення станцій, NVDA повідомить, що в буфері поки недостатньо звуку. Просто зачекайте кілька секунд і спробуйте знову.</p>
<p>Переключення на іншу станцію завжди перезапускає буфер для нової станції; буферизований звук попередньої станції видаляється.</p>
<h3>Підтримувані потоки</h3>
<p>Тайм-шифт працює з тим самим діапазоном потоків, які вже підтримує FreeRadio:</p>
<ul>
<li>Звичайні HTTP/HTTPS-потоки (MP3, AAC, OGG тощо), включаючи сервери у стилі Shoutcast/Icecast.</li>
<li><strong>HLS-потоки (<code>.m3u8</code>)</strong> — FreeRadio вирішує основний плейлист станції, відстежує медіаплейлист і завантажує сегменти у фоні, щоб буфер залишався заповненим.</li>
</ul>
<p>У рідкісному випадку, коли плейлист станції взагалі неможливо прочитати (наприклад, пошкоджений або недоступний маніфест <code>.m3u8</code>), NVDA повідомить, що перемотування недоступне для цієї конкретної станції.</p>
<h3>Вимоги та обмеження</h3>
<ul>
<li><strong>Потребує бекенду BASS.</strong> Тайм-шифт недоступний, коли BASS вимкнено.</li>
<li>Буфер розрахований приблизно на 10 хвилин; перемотати далі неможливо.</li>
<li>Буфер прив'язаний до станції: зміна станції, зупинка відтворення або перезапуск NVDA очищають його й починають заново.</li>
<li>Відтворення з тайм-шифтом використовує власний локальний файл буфера і не створює збереженого запису — якщо хочете зберегти звук назавжди, використовуйте також Миттєвий запис (<code>Ctrl+Win+E</code>).</li>
</ul>
<h2>Таймер</h2>
<p>Відкрийте вкладку «Таймер» у браузері радіостанцій (Alt+4). Можна додати два типи таймерів:</p>
<p><strong>Сигнал — увімкнути радіо:</strong> Автоматично починає відтворення обраної станції з ваших улюблених у вказаний час. Оберіть станцію та введіть час у форматі ГГ:ХХ.</p>
<p><strong>Сон — зупинка радіо:</strong> Зупиняє відтворення у вказаний час. Коли спрацьовує таймер, гучність поступово зменшується протягом 60 секунд, перш ніж відтворення зупиниться. Вибір станції не потрібен; просто введіть час.</p>
<p>Для обох типів, якщо вказаний час уже минув, дія планується на наступний день. Якщо на той самий час вже існує таймер (незалежно від типу), додавання нового заблоковано; користувач отримує повідомлення про конфлікт і пропозицію спочатку видалити наявний запис. Таймери, що очікують на виконання, перелічені у вкладці; виберіть один і натисніть кнопку «Видалити вибраний таймер», щоб скасувати його.</p>
<h2>Налаштування</h2>
<p>Наступні параметри можна налаштувати в меню NVDA → Параметри → Налаштування → FreeRadio:</p>
<table>
<thead>
<tr>
<th>Параметр</th>
<th>Опис</th>
</tr>
</thead>
<tbody>
<tr>
<td>Пристрій виведення звуку (модуль BASS)</td>
<td>Встановлює пристрій виведення звуку для відтворення радіо. Список містить усі пристрої, сумісні з BASS, що є в системі, а також параметр «Стандартно, як у системі». Зміни застосовуються одразу після збереження; якщо вибраний пристрій відключено, додаток автоматично переходить на системний і повідомляє про це. Функціонує лише під час використання модуля BASS.</td>
</tr>
<tr>
<td>Гучність</td>
<td>Встановлює початкову гучність додатка (0–200). Зміни, внесені під час відтворення за допомогою клавіш <code>Ctrl+Win+↑</code> / <code>Ctrl+Win+↓</code>, також показуються тут.</td>
</tr>
<tr>
<td>Початковий Аудіоефект</td>
<td>Встановлює аудіоефект, що застосовується під час запуску NVDA або початку відтворення станції. Вибраний ефект відповідає списку «Ефекти» у браузері радіостанцій. Працює лише у разі використання бекенду BASS.</td>
</tr>
<tr>
<td>Посилення еквалайзера (низькі частоти / високі частоти / вокал)</td>
<td>Встановлює рівень посилення в дБ для кожної смуги еквалайзера (від -15 до +15). Ці значення застосовуються, коли активний відповідний ефект еквалайзера, і зберігаються глобально. Перевизначення для кожної станції можна зберегти за допомогою кнопки <strong>Зберегти аудіопрофіль</strong> на вкладці «Улюблене». Функція активна лише під час використання бекенду BASS.</td>
</tr>
<tr>
<td>Перехід між станціями (бэкенд BASS)</td>
<td>Керує поведінкою переходу під час перемикання між станціями. <strong>Миттєве вимикання</strong> (початково) зупиняє попередню станцію одразу перед початком наступної. <strong>Коротке перехресне згасання (1 секунда)</strong> та <strong>Звичайне перехресне згасання (2 секунди)</strong> запускають наступну станцію негайно без паузи, а потім поступово приглушує попередню станцію у фоновому режимі, щойно новий потік підтверджується як активний. Не має ефекту та не впливає на продуктивність, якщо встановлено Миттєве перемикання. Доступно лише під час використання бекенду BASS.</td>
</tr>
<tr>
<td>Відновлювати останню станцію під час запуску NVDA</td>
<td>Якщо увімкнено, остання відтворювана станція автоматично відновлюється щоразу при запуску NVDA.</td>
</tr>
<tr>
<td>Автоматичне оголошення змін трека (метадані ICY)</td>
<td>Якщо цей параметр увімкнений, NVDA автоматично оголошує назву нового трека щоразу, коли він змінюється на станції, яка транслює метадані ICY. Назва першого трека також оголошується одразу після перемикання на нову станцію. Початково вимкнено.</td>
</tr>
<tr>
<td>Вимкнути сповіщення</td>
<td>Якщо увімкнено, NVDA не повідомляє про зміну станцій, зміну стану відтворення (відтворення, пауза, зупинка) або події запису (початок, зупинка, завершення). Повідомлення про помилки, відгуки про улюблене, результати розпізнавання треків та повідомлення про оновлення залишаються активними. Також можна перемикати миттєво за допомогою непризначеного жесту вводу. Початково вимкнено.</td>
</tr>
<tr>
<td>Увімкнути буфер тайм-шифту (перемотування прямого радіо, ~10 хвилин)</td>
<td>Вмикає або вимикає функцію тайм-шифту. При увімкненні відтворювана станція безперервно захоплюється у фоні, щоб її можна було перемотувати назад за допомогою <code>Ctrl+Win+J</code> та вперед за допомогою <code>Ctrl+Win+K</code>. Також можна миттєво перемикати за допомогою <code>Ctrl+Win+T</code>. Потребує бекенду BASS. Вимкнено за замовчуванням.</td>
</tr>
<tr>
<td>Збереження вподобаних треків у текстовий файл</td>
<td>Якщо цей параметр увімкнений, інформація про трек, скопійована в буфер обміну потрійним натисканням клавіш <code>Ctrl+Win+I</code>, також додається до файлу <code>Documents\FreeRadio Recordings\likedSongs.txt</code>. Якщо метадані ICY відсутні, до цього ж файлу зберігається результат розпізнавання Shazam. Початково цей параметр вимкнений.</td>
</tr>
<tr>
<td>Коли натиснуто Ctrl+Win+P без активного відтворення</td>
<td>Визначає, що відбувається при натисканні цієї комбінації клавіш, якщо нічого не відтворюється: запустити останню станцію або відкрити список улюблених.</td>
</tr>
<tr>
<td>При подвійному натисканні Ctrl+Win+P</td>
<td>Вибирає дію, яка виконується при подвійному натисканні комбінації клавіш з невеликою затримкою: нічого не робити, відкрити список улюблених, відкрити вкладку запису або відкрити вкладку таймера. Якщо вибрано варіант «нічого не робити», перше натискання реагує миттєво, без затримки.</td>
</tr>
<tr>
<td>При потрійному натисканні комбінації клавіш Ctrl+Win+P</td>
<td>Вибирає дію, яка виконується при потрійному швидкому натисканні цієї комбінації: нічого не робити, відкрити список улюблених, відкрити пошук станцій, відкрити вкладку запису або відкрити вкладку таймера.</td>
</tr>
<tr>
<td>Автоматична перевірка оновлень</td>
<td>Якщо цей параметр увімкнений, під час кожного запуску NVDA виконується фонова перевірка оновлень; у разі виявлення нової версії ви отримаєте відповідне повідомлення. Якщо цей параметр вимкнений, автоматична перевірка припиняється, але ручна перевірка залишається доступною.</td>
</tr>
<tr>
<td>Шлях до ffmpeg.exe</td>
<td>Шлях до файлу ffmpeg.exe, який використовується для розпізнавання треків. Якщо поле залишити порожнім, автоматично використовується файл ffmpeg.exe з папки додатка.</td>
</tr>
<tr>
<td>Шлях до VLC</td>
<td>Якщо VLC не встановлено або знаходиться в нестандартному місці, тут можна вказати повний шлях до виконуваного файлу.</td>
</tr>
<tr>
<td>Шлях до wmplayer.exe</td>
<td>За необхідності вкажіть тут шлях до Windows Media Player.</td>
</tr>
<tr>
<td>Шлях до PotPlayer</td>
<td>Якщо PotPlayer знаходиться в нестандартному місці, тут можна вказати повний шлях до виконуваного файлу.</td>
</tr>
<tr>
<td>Папка записів</td>
<td>Встановлює папку, в якій зберігаються записані файли. Якщо залишити поле порожнім, буде використане початкове розташування <code>Documents\FreeRadio Recordings\</code>. Кнопка «Огляд» дозволяє вибрати папку інтерактивно. Зміни набувають чинності одразу після збереження.</td>
</tr>
<tr>
<td>Вимкнути перевірку підключення до Інтернету перед відтворенням</td>
<td>Рекомендується для користувачів, які стикаються із затримкою перед початком відтворення станції. Також корисно, коли DNS заблоковано.</td>
</tr>
</tbody>
</table>
<h2>Вимкнути сповіщення</h2>
<p>Якщо в налаштуваннях увімкнено <strong>Вимкнути сповіщення</strong>, NVDA вимикає наведені нижче автоматичні повідомлення:</p>
<ul>
<li>Назва станції, коли починається відтворення нової станції</li>
<li>Зміни стану відтворення: відтворення, пауза, зупинка</li>
<li>Події запису: початок, зупинка, завершення (миттєвий запис, запис трека та запис за розкладом)</li>
<li>Оголошення про зміну трека в ICY, навіть якщо також увімкнено функцію <strong>Автоматичне оголошення про зміну трека</strong></li>
</ul>
<p>Нижченаведені повідомлення навмисно <strong>не</strong> підпадають під ці зміни: повідомлення про помилки, відгуки щодо улюблених треків (додано / вже є у списку), результати розпізнавання треків та повідомлення про оновлення.</p>
<p>Цей параметр можна увімкнути або вимкнути в меню NVDA → Параметри → Налаштування → FreeRadio, або миттєво в будь-який момент за допомогою жесту вводу, якому не призначено жодної комбінації (призначити такий жест можна в меню NVDA → Параметри → Жести вводу → FreeRadio). Після увімкнення або вимкнення NVDA один раз озвучить повідомлення «Сповіщення вимкнено» або «Сповіщення увімкнено» для підтвердження зміни.</p>
<h2>Автоматичне повідомлення про відстеження змін</h2>
<p>Якщо в налаштуваннях увімкнено параметр <strong>«Автоматичне оголошення зміни треку»</strong>, FreeRadio приблизно кожні 5 секунд у фоновому режимі перевіряє потік метаданих ICY поточної станції. Коли трек змінюється, NVDA автоматично зачитує назву нового трека — натискання клавіш не потрібне.</p>
<p>Під час перемикання на нову станцію інформація про перший трек оголошується одразу після встановлення з'єднання. Якщо ви перемикаєтеся на станцію, яка не транслює метадані ICY, система не видає жодних звукових сигналів, а інформація про трек попередньої станції не повторюється.</p>
<p>Ця функція початково вимкнена, і її можна перемикати в меню NVDA → Параметри → Налаштування → FreeRadio.</p>
<h2>Вподобані треки</h2>
<p>Якщо увімкнений параметр <strong>«Зберегти вподобані пісні у текстовий файл»</strong>, інформація про треки, скопійована в буфер обміну потрійним натисканням клавіш <code>Ctrl+Win+I</code>, також додається по рядках до файлу <code>Documents\FreeRadio Recordings\likedSongs.txt</code>.</p>
<p>На радіостанціях, що транслюють метадані ICY, назва композиції та ім’я виконавця зберігаються безпосередньо. На радіостанціях без метаданих ICY результат розпізнавання Shazam зберігається в тому самому файлі — обидва джерела використовують один і той самий список. Якщо файл не існує, він створюється автоматично; кожен запис додається в кінець файлу, а попередні записи ніколи не видаляються.</p>
<h2>Вкладка «Улюблені треки»</h2>
<p>Вкладка <strong>«Улюблені треки»</strong> в браузері станцій відображає всі треки, збережені у <code>likedSongs.txt</code>. Список автоматично перезавантажується з файлу кожного разу при відкритті вкладки.</p>
<p>Поле <strong>Фільтр</strong> над списком дозволяє звужувати відображувані треки в реальному часі. Введіть будь-яку частину назви пісні або імені виконавця — список миттєво оновлюється після кожного натискання клавіші. NVDA оголошує кількість відповідних результатів після кожної зміни. Натисніть стрілку <code>Вниз</code> у полі фільтра, щоб перемістити фокус безпосередньо до списку.</p>
<p>При виборі треку зі списку стають доступними такі дії:</p>
<ul>
<li><strong>Відтворити у Spotify:</strong> Намагається безпосередньо відкрити настільний застосунок Spotify. Якщо застосунок не встановлено, переходить на сайт Spotify і автоматично починає відтворення першого результату.</li>
<li><strong>Відтворити на YouTube (<code>Alt+O</code>):</strong> Виконує пошук вибраного треку на YouTube і відкриває результати у браузері за замовчуванням.</li>
<li><strong>Показати текст пісні:</strong> Завантажує та відображає текст вибраного треку. Текст пісні завантажується з <a href="https://lrclib.net">lrclib.net</a> (безкоштовно, без облікового запису). Під час пошуку у фоновому режимі оголошується коротке повідомлення «Завантаження тексту…». Якщо текст знайдено, він відкривається у діалозі лише для читання, де його можна читати за допомогою NVDA та копіювати до буфера обміну. Якщо текст не знайдено, NVDA повідомляє про це. Кнопка тимчасово вимикається під час завантаження, щоб запобігти дублюванню запитів.</li>
<li><strong>Видалити (<code>Alt+M</code>):</strong> Видаляє вибраний трек з <code>likedSongs.txt</code> і оновлює список. Клавіша <code>Delete</code> також активує цю кнопку, коли список знаходиться у фокусі.</li>
<li><strong>Оновити (<code>Alt+E</code>):</strong> Перезавантажує список із файлу.</li>
</ul>
<p>Кнопки Spotify, YouTube, «Показати текст пісні» та «Видалити» активні лише тоді, коли у списку вибрано реальний трек.</p>
<h3>Служба текстів пісень</h3>
<p>FreeRadio використовує <a href="https://lrclib.net">lrclib.net</a> для отримання текстів пісень — безкоштовна відкрита база даних, яка не потребує ключа API або облікового запису. Процес пошуку аналізує рядок треку, збережений у <code>likedSongs.txt</code>, і послідовно пробує ширші запити до знаходження тексту:</p>
<ol>
<li>Точний збіг із повним іменем виконавця та очищеною назвою (шумові суфікси, як-от «Remastered», «Live» або теги року, видаляються перед пошуком).</li>
<li>Точний збіг із повним іменем виконавця та оригінальною назвою (якщо очищення її змінило).</li>
<li>Точний збіг лише з іменем першого виконавця та очищеною назвою (для рядків із кількома виконавцями, наприклад «Виконавець A &amp; Виконавець B»).</li>
<li>Нечіткий пошук із іменем першого виконавця та очищеною назвою.</li>
<li>Нечіткий пошук із вихідним рядком треку як крайній засіб.</li>
</ol>
<p>Якщо доступні прості тексти, вони відображаються як є. Якщо доступні лише синхронізовані за часом LRC-тексти, мітки часу видаляються і відображається простий текст. Інструментальні треки повідомляються як не знайдені.</p>
<h2>Відтворення</h2>
<p>Додаток вибирає механізм відтворення, дотримуючись такого порядку пріоритетів:</p>
<ol>
<li><strong>BASS</strong> — стандартний і основний бекенд. Окремого встановлення не потрібно; він входить до складу додатка. BASS надсилає аудіо безпосередньо до аудіостеку Windows і відображається в мікшері гучності Windows як самостійне джерело звуку під назвою «pythonw.exe», окреме від NVDA. Це означає, що аудіо FreeRadio передається по повністю окремому каналі від мовлення NVDA: радіо не переривається, не змішується та не зазнає впливу власних налаштувань аудіо NVDA під час мовлення NVDA. Користувач може регулювати гучність радіо незалежно від NVDA у мікшері гучності Windows. Підтримує HTTP, HTTPS та більшість вбудованих форматів потокового аудіо. Дзеркалення аудіо доступне лише з цим бекендом.</li>
<li><strong>VLC</strong> — бере на себе функції, якщо BASS не працює. Автоматично шукається у типових місцях інсталяції, папках профілів користувачів та системному PATH.</li>
<li><strong>PotPlayer</strong> — використовується, якщо VLC не знайдено. Автоматично шукається у типових місцях інсталяції.</li>
<li><strong>Windows Media Player</strong> — використовується як крайній захід; вимагає інсталяції компонента WMP у системі.</li>
</ol>
<h2>Перевірка оновлень</h2>
<p>FreeRadio автоматично перевіряє наявність нових версій через GitHub.</p>
<p><strong>Автоматична перевірка:</strong> працює тихо у фоновому режимі через 15 секунд після запуску NVDA. Якщо знайдено нову версію, ви отримаєте сповіщення; якщо нічого не знайдено, повідомлення не показується.</p>
<p><strong>Ручна перевірка:</strong> Можна запустити за бажанням у меню NVDA «Інструменти» → «FreeRadio» → <strong>«Перевірити наявність оновлень…»</strong>. При запуску таким чином результат оголошується навіть у тому випадку, якщо версія є актуальною.</p>
<p><strong>Якщо оновлення знайдено:</strong> Відкриється діалог з номером версії та встановленою версією.</p>
<ul>
<li>Якщо у випуску на GitHub доступний файл <code>.nvda-addon</code> для прямого завантаження, з’являється кнопка <strong>Завантажити та встановити</strong>. Після підтвердження файл завантажується у фоновому режимі, NVDA повідомляє про початок завантаження, а потім автоматично відкривається власний діалог встановлення NVDA.</li>
<li>Якщо посилання для прямого завантаження відсутнє, з’являється кнопка <strong>Відкрити сторінку</strong>, і сторінка випуску на GitHub відкривається у браузері.</li>
</ul>
<p><strong>Щоб вимкнути автоматичні перевірки:</strong> Вимкніть параметр <strong>Автоматично перевіряти наявність оновлень</strong> у меню NVDA → Параметри → Налаштування → FreeRadio.</p>
<h2>Ліцензія</h2>
<p>GPL v2</p>
<hr />
<ul>
<li>Переклад: Георгій Галас.</li>
</ul>
Комбінація	Функція	Опис
`Ctrl+Win+R`	Відкрити браузер радіостанцій	Відкриває діалог браузера радіостанцій, якщо він закритий, або виводить його на передній план, якщо він вже відкритий.
`Ctrl+Win+P`	Пауза / відновлення	Зупиняє поточну станцію, якщо вона відтворюється; відновлює, якщо була призупинена. Якщо нічого не відтворюється, запускає останню станцію або відкриває список улюблених залежно від ваших налаштувань. Подвійне натискання одразу переходить до вибраної вкладки. Триразове натискання виконує окрему дію залежно від вашого налаштування.
`Ctrl+Win+S`	Зупинити	Повністю зупиняє поточну станцію та скидає плеєр.
`Ctrl+Win+→`	Наступна улюблена	Переходить до наступної станції у списку улюблених. У кінці списку переходить на початок.
`Ctrl+Win+←`	Попередня улюблена	Переходить до попередньої станції у списку улюблених. На початку списку переходить у кінець.
`Ctrl+Win+↑`	Збільшити гучність	Збільшує гучність на 5; максимум 200.
`Ctrl+Win+↓`	Зменшити гучність	Зменшує гучність на 5; мінімум 0.
`Ctrl+Win+V`	Додати до улюблених	Додає станцію, що зараз відтворюється, до списку улюблених. Повідомляє, якщо станція вже є у списку.
`Ctrl+Win+I`	Інформація про станцію	Повідомляє назву станції, що зараз відтворюється. Натисніть двічі, щоб у діалозі показати деталі, такі як країна, жанр та бітрейт. Натисніть тричі, щоб скопіювати інформацію про поточний трек (метадані ICY) до буфера обміну, якщо вона доступна; якщо метадані відсутні, замість цього запускається розпізнавання музики Shazam. Натисніть чотири рази, щоб примусово запустити розпізнавання музики у разі неправильних метаданих ICY.
`Ctrl+Win+M`	Дзеркальний показ аудіо	Одночасно дзеркально показує потік на додатковий пристрій виведення аудіо. Натисніть ще раз, щоб зупинити дзеркальний показ.
`Ctrl+Win+E`	Миттєвий запис	Натисніть один раз, щоб почати запис поточної станції; натисніть ще раз, щоб зупинити. Натисніть двічі, щоб почати запис треку — файл отримає назву поточного треку, а запис автоматично зупиниться, коли трек зміниться. Натисніть двічі, поки запис треку активний, щоб зупинити його достроково. Відтворення продовжується без перерв у всіх режимах запису. Доступно лише для станцій, що транслюють метадані ICY.
`Ctrl+Win+W`	Відкрити папку записів	Відкриває папку із записаними файлами у Провіднику файлів.
`Ctrl+Win+J`	Тайм-шифт — перемотування назад	Перемотує живе радіо на 15 секунд назад. Перше натискання активує режим тайм-шифту; кожне наступне перемотує ще на 15 секунд назад, до межі буфера (~10 хвилин). Потребує увімкненого буфера тайм-шифту в Налаштуваннях.
`Ctrl+Win+K`	Тайм-шифт — перемотування вперед	Перемотує на 15 секунд вперед у режимі тайм-шифту. Досягнувши краю прямого ефіру, відтворення автоматично повертається до прямого ефіру, і команда не має ефекту до наступного перемотування назад.
`Ctrl+Win+T`	Увімкнути/вимкнути буфер тайм-шифту	Миттєво вмикає або вимикає буфер тайм-шифту, відображаючи стан прапорця в Налаштуваннях. При вимкненні негайно повертає до прямого ефіру (якщо активний тайм-шифт) та зупиняє фонове захоплення.
(непризначено)	Увімкнути/вимкнути сповіщення про вимкнення звуку	Увімкнути або вимкнути налаштування «Сповіщення про вимкнення звуку» миттєво. Призначте комбінацію клавіш через меню NVDA → Параметри → Жести вводу → FreeRadio.
Комбінація	Функція	Опис
`F1`	Довідка	Відкриває файл довідки додатка у браузері. Спочатку здійснюється пошук довідки для мови, яка використовується в NVDA; якщо її не знайдено, відкривається довідка початковою мовою.
`F2`	Що зараз відтворюється	Оголошує назву станції та треку, що зараз відтворюються. Натисніть двічі, щоб у діалозі показати детальну інформацію, таку як країна, жанр та бітрейт. Натисніть тричі, щоб скопіювати інформацію про поточний трек (метадані ICY) до буфера обміну, якщо вона доступна; якщо метадані відсутні, замість цього запускається розпізнавання треків Shazam. Натисніть чотири рази, щоб примусово запустити розпізнавання музики у разі неправильних метаданих ICY.
`F3`	Попередня станція	Переходить до попередньої станції на вкладці «Усі станції» або «Улюблене» та негайно починає відтворення. Переходить до кінця, якщо знаходиться на початку списку.
`F4`	Наступна станція	Переходить до наступної станції у вкладці «Усі станції» або «Улюблене» та негайно починає відтворення. Переходить до початку, якщо знаходиться в кінці списку.
`F5`	Зменшити гучність	Зменшує гучність на 5 (мінімум 0).
`F6`	Збільшити гучність	Збільшує гучність на 5 (максимум 200).
`F7`	Пауза / продовження	Призупиняє відтворення, якщо станція відтворюється; продовжує відтворення, якщо вона була призупинена і медіа завантажено.
`F8`	Зупинка	Повністю зупиняє поточну станцію та скидає плеєр.
`F9`	Перейменувати	Відкриває діалог перейменування для станції, що знаходиться у фокусі на вкладці «Улюблене».
Комбінація	Функція	Опис
`→`	Наступна станція	Якщо активним є список «Усі станції» або «Улюблене», переходить до наступної станції та негайно починає її відтворення. У разі досягнення кінця списку переходить до початку.
`←`	Попередня станція	Якщо активним є список «Усі станції» або «Улюблене», переходить до попередньої станції та негайно починає її відтворення. У разі досягнення початку списку переходить до кінця.
`Enter`	Відтворити	Коли активним є список «Усі станції» або «Улюблене», негайно починає відтворення вибраної станції. Перемикається на вибрану станцію, навіть якщо вже відтворюється інша станція.
`Пробіл`	Відтворити / Пауза	Призупиняє відтворення, якщо станція вже відтворюється; в іншому випадку починає відтворення вибраної станції.
`Ctrl+Tab`	Наступна вкладка	Переходить до наступної вкладки (Усі станції → Улюблене → Запис → Таймер → Улюблені треки).
`Ctrl+Shift+Tab`	Попередня вкладка	Переходить до попередньої вкладки.
`Escape`	Сховати	Сховає діалог; додаток продовжує відтворення у фоновому режимі.
Комбінація	Функція	Опис
`Ctrl+↑`	Збільшити гучність	Збільшує гучність на 5 одиниць. Працює лише тоді, коли діалог браузера радіостанцій відкритий.
`Ctrl+↓`	Зменшити гучність	Зменшує гучність на 5 одиниць. Працює лише тоді, коли діалог браузера радіостанцій відкритий.
Комбінація	Функція	Опис
`Alt+R`	Перейти до поля пошуку	Переміщує фокус у поле введення тексту для пошуку. Здійснює пошук у Браузері радіостанцій за текстом у полі пошуку; одночасно шукаються назва, країна та жанр.
`Alt+V`	Додати / видалити з улюблених	Додає вибрану станцію до улюблених; видаляє її, якщо вона вже є у списку.
`Alt+1`	Усі станції	Переходить на вкладку «Усі станції».
`Alt+2`	Улюблене	Переходить на вкладку «Улюблене».
`Alt+3`	Запис	Переходить на вкладку «Запис».
`Alt+4`	Таймер	Перехід на вкладку «Таймер».
`Alt+5`	Улюблені треки	Перехід на вкладку «Улюблені треки».
`Alt+K`	Закрити	Закриває діалог; додаток продовжує відтворення у фоновому режимі.
Параметр	Опис
Пристрій виведення звуку (модуль BASS)	Встановлює пристрій виведення звуку для відтворення радіо. Список містить усі пристрої, сумісні з BASS, що є в системі, а також параметр «Стандартно, як у системі». Зміни застосовуються одразу після збереження; якщо вибраний пристрій відключено, додаток автоматично переходить на системний і повідомляє про це. Функціонує лише під час використання модуля BASS.
Гучність	Встановлює початкову гучність додатка (0–200). Зміни, внесені під час відтворення за допомогою клавіш `Ctrl+Win+↑` / `Ctrl+Win+↓`, також показуються тут.
Початковий Аудіоефект	Встановлює аудіоефект, що застосовується під час запуску NVDA або початку відтворення станції. Вибраний ефект відповідає списку «Ефекти» у браузері радіостанцій. Працює лише у разі використання бекенду BASS.
Посилення еквалайзера (низькі частоти / високі частоти / вокал)	Встановлює рівень посилення в дБ для кожної смуги еквалайзера (від -15 до +15). Ці значення застосовуються, коли активний відповідний ефект еквалайзера, і зберігаються глобально. Перевизначення для кожної станції можна зберегти за допомогою кнопки Зберегти аудіопрофіль на вкладці «Улюблене». Функція активна лише під час використання бекенду BASS.
Перехід між станціями (бэкенд BASS)	Керує поведінкою переходу під час перемикання між станціями. Миттєве вимикання (початково) зупиняє попередню станцію одразу перед початком наступної. Коротке перехресне згасання (1 секунда) та Звичайне перехресне згасання (2 секунди) запускають наступну станцію негайно без паузи, а потім поступово приглушує попередню станцію у фоновому режимі, щойно новий потік підтверджується як активний. Не має ефекту та не впливає на продуктивність, якщо встановлено Миттєве перемикання. Доступно лише під час використання бекенду BASS.
Відновлювати останню станцію під час запуску NVDA	Якщо увімкнено, остання відтворювана станція автоматично відновлюється щоразу при запуску NVDA.
Автоматичне оголошення змін трека (метадані ICY)	Якщо цей параметр увімкнений, NVDA автоматично оголошує назву нового трека щоразу, коли він змінюється на станції, яка транслює метадані ICY. Назва першого трека також оголошується одразу після перемикання на нову станцію. Початково вимкнено.
Вимкнути сповіщення	Якщо увімкнено, NVDA не повідомляє про зміну станцій, зміну стану відтворення (відтворення, пауза, зупинка) або події запису (початок, зупинка, завершення). Повідомлення про помилки, відгуки про улюблене, результати розпізнавання треків та повідомлення про оновлення залишаються активними. Також можна перемикати миттєво за допомогою непризначеного жесту вводу. Початково вимкнено.
Увімкнути буфер тайм-шифту (перемотування прямого радіо, ~10 хвилин)	Вмикає або вимикає функцію тайм-шифту. При увімкненні відтворювана станція безперервно захоплюється у фоні, щоб її можна було перемотувати назад за допомогою `Ctrl+Win+J` та вперед за допомогою `Ctrl+Win+K`. Також можна миттєво перемикати за допомогою `Ctrl+Win+T`. Потребує бекенду BASS. Вимкнено за замовчуванням.
Збереження вподобаних треків у текстовий файл	Якщо цей параметр увімкнений, інформація про трек, скопійована в буфер обміну потрійним натисканням клавіш `Ctrl+Win+I`, також додається до файлу `Documents\FreeRadio Recordings\likedSongs.txt`. Якщо метадані ICY відсутні, до цього ж файлу зберігається результат розпізнавання Shazam. Початково цей параметр вимкнений.
Коли натиснуто Ctrl+Win+P без активного відтворення	Визначає, що відбувається при натисканні цієї комбінації клавіш, якщо нічого не відтворюється: запустити останню станцію або відкрити список улюблених.
При подвійному натисканні Ctrl+Win+P	Вибирає дію, яка виконується при подвійному натисканні комбінації клавіш з невеликою затримкою: нічого не робити, відкрити список улюблених, відкрити вкладку запису або відкрити вкладку таймера. Якщо вибрано варіант «нічого не робити», перше натискання реагує миттєво, без затримки.
При потрійному натисканні комбінації клавіш Ctrl+Win+P	Вибирає дію, яка виконується при потрійному швидкому натисканні цієї комбінації: нічого не робити, відкрити список улюблених, відкрити пошук станцій, відкрити вкладку запису або відкрити вкладку таймера.
Автоматична перевірка оновлень	Якщо цей параметр увімкнений, під час кожного запуску NVDA виконується фонова перевірка оновлень; у разі виявлення нової версії ви отримаєте відповідне повідомлення. Якщо цей параметр вимкнений, автоматична перевірка припиняється, але ручна перевірка залишається доступною.
Шлях до ffmpeg.exe	Шлях до файлу ffmpeg.exe, який використовується для розпізнавання треків. Якщо поле залишити порожнім, автоматично використовується файл ffmpeg.exe з папки додатка.
Шлях до VLC	Якщо VLC не встановлено або знаходиться в нестандартному місці, тут можна вказати повний шлях до виконуваного файлу.
Шлях до wmplayer.exe	За необхідності вкажіть тут шлях до Windows Media Player.
Шлях до PotPlayer	Якщо PotPlayer знаходиться в нестандартному місці, тут можна вказати повний шлях до виконуваного файлу.
Папка записів	Встановлює папку, в якій зберігаються записані файли. Якщо залишити поле порожнім, буде використане початкове розташування `Documents\FreeRadio Recordings\`. Кнопка «Огляд» дозволяє вибрати папку інтерактивно. Зміни набувають чинності одразу після збереження.
Вимкнути перевірку підключення до Інтернету перед відтворенням	Рекомендується для користувачів, які стикаються із затримкою перед початком відтворення станції. Також корисно, коли DNS заблоковано.