Изменения

• Поиск станций, просмотр по странам и тегам, а также список популярных станций теперь используют локальный кэш полного каталога станций вместо каждого запроса к Radio Browser API. Это делает поиск и фильтрацию практически мгновенными и устраняет сетевые задержки, которые ранее могли зависать в интерфейсе во время поиска.


• Локальный кэш автоматически синхронизируется с сервером в фоновом режиме (каждые 12 часов или немедленно, если кэш ещё не создан). Если синхронизация не удаётся, предыдущий кэш сохраняется, поэтому поиск продолжает работать.


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


• Добавлена локализация интерфейса и руководства пользователя на голландский язык.

FreeRadio (Свободное радио)

FreeRadio — дополнение для NVDA

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

Каталог Radio Browser

FreeRadio использует открытую базу данных Radio Browser для своего каталога станций. Radio Browser — это общедоступный каталог, управляемый сообществом, содержащий более 50 000 интернет-радиостанций со всего мира. Регистрация или учётная запись не требуются, а его API открыт для всех. Каждая станция включает адрес, страну, жанр, язык и информацию о битрейте; станции ранжируются по голосам пользователей. FreeRadio подключается к этому API через зеркальные серверы, расположенные в Германии, Нидерландах и Австрии; если один сервер недоступен, он автоматически переключается на следующий.

Добавление станции в Radio Browser

Если нужной вам станции нет в каталоге Radio Browser, вы можете добавить её самостоятельно по адресу https://www.radio-browser.info/add. Учётная запись или регистрация не требуются.

Заполните форму на этой странице:

• Stream URL (обязательно) — прямой URL аудиопотока, заканчивающийся на .mp3, .aac, .ogg или подобное. Это не адрес веб-сайта станции; это «сырой» адрес потока, который вы вставили бы в медиаплеер. Большинство станций публикуют свой URL-адрес потока на своём веб-сайте или в разделе «Слушать в прямом эфире».
• Station name (обязательно) — название станции, как оно должно отображаться в каталоге.
• Homepage — адрес веб-сайта станции.
• Country and language — выберите страну и язык вещания из раскрывающихся списков.
• Tags — ключевые слова жанра или темы, разделённые запятыми, например news, jazz, classical. Они используются для поиска и фильтрации.
• Logo URL — прямая ссылка на логотип станции, если он доступен.

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

Требования

• NVDA 2024.1 или новее
• Windows 10 или новее
• Подключение к интернету

Установка

Загрузите файл .nvda-addon, нажмите на нём Enter и перезапустите NVDA при появлении соответствующего запроса.

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

Все сочетания клавиш можно переназначить в меню NVDA → Параметры → Жесты ввода → FreeRadio. Эти сочетания клавиш работают из любого места, независимо от того, какое окно находится в фокусе.

Сочетания «Следующая / Предыдущая» работают только со списком избранного; они не работают со списком всех станций. Когда в окне обзора фокус находится на списке, клавиши со стрелками влево и вправо служат той же цели — см. раздел «Сочетания внутри диалога».

Обзор станций

FreeRadio также добавляет подменю FreeRadio в меню «Сервис» NVDA. Оттуда можно напрямую открыть обзор станций и настройки FreeRadio.

Окно, открываемое с помощью Ctrl+Win+R, содержит пять вкладок: Все станции, Избранное, Запись, Таймер и Понравившиеся песни. Вы можете переключаться между вкладками с помощью Ctrl+Tab.

При открытии вкладки «Все станции» автоматически загружаются 1000 наиболее популярных станций из Radio Browser. Выбор страны из раскрывающегося списка обновляет список, показывая станции этой страны. Ввод текста в поле поиска мгновенно выполняет полноценный поиск по всей базе Radio Browser одновременно по названию, стране и жанру.

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

Элементы управления Громкость (0–200) и Эффекты в той же области можно регулировать в любое время, пока окно открыто. Из списка эффектов можно одновременно включить Chorus, Compressor, Distortion, Echo, Flanger, Gargle, Reverb, EQ: Bass Boost, EQ: Treble Boost и EQ: Vocal Boost; изменения применяются к активному потоку мгновенно. Эти элементы управления полностью функциональны только при активном бэкенде BASS.

Когда включён один или несколько эквалайзерных эффектов, для каждой активной полосы появляется регулятор усиления. Усиление можно установить в диапазоне от −15 дБ до +15 дБ; значения по умолчанию: Bass +9 дБ, Treble +9 дБ, Vocal +6 дБ. Регуляторы усиления отображаются только для тех полос эквалайзера, которые в данный момент отмечены, и автоматически скрываются при снятии отметки с эффекта. Значения усиления сохраняются глобально и восстанавливаются при следующем сеансе.

Кнопка Воспроизвести/Пауза также находится в нижней части окна. Если ни одна станция не играет, она запускает выбранную станцию; если станция уже играет, она приостанавливает воспроизведение.

Когда станция выбрана в списке, кнопка Сведения о станции отображает информацию, такую как страна, язык, жанр, формат, битрейт, веб-сайт и URL-адрес потока, в отдельном диалоговом окне. Каждое поле отображается в отдельном доступном для чтения поле; вы можете перемещаться между полями с помощью Tab и скопировать всю информацию в буфер обмена сразу с помощью кнопки Скопировать всё в буфер обмена. Эта кнопка доступна как на вкладке «Все станции», так и на вкладке «Избранное».

Сочетания внутри диалога

Следующие клавиши работают только когда окно обзора станций активно.

Клавиши F

Сочетания для списка и навигации

Сочетания для громкости

Сочетания с клавишей Alt

Избранное

Список избранного — это личная коллекция станций, хранящаяся постоянно. Чтобы добавить станцию, выберите её в списке и нажмите кнопку «Добавить в избранное» или используйте сочетание Alt+V. Это же сочетание удаляет станцию, которая уже есть в списке, когда она выбрана.

Избранное можно воспроизводить с помощью Ctrl+Win+→ и Ctrl+Win+←; эти сочетания работают даже когда окно обзора не открыто.

Чтобы удалить станцию из списка избранного, выберите её и нажмите кнопку Удалить станцию или клавишу Delete. После удаления фокус и выделение автоматически перемещаются на следующую станцию в списке. Если удалённая станция была последней, фокус перемещается на предыдущую станцию. Если список становится пустым, фокус перемещается на кнопку «Воспроизвести».

Экспорт и импорт избранного

Вкладка «Избранное» содержит две кнопки для резервного копирования и восстановления вашего списка станций:

Экспорт избранного… — сохраняет весь ваш список избранного в файл. Диалог сохранения позволяет выбрать один из двух форматов:

• JSON (.json) — полная резервная копия, сохраняющая названия станций, URL-адреса потоков и все метаданные. Рекомендуется для последующего восстановления списка или переноса на другой компьютер.
• Плейлист M3U (.m3u) — стандартный формат плейлиста, совместимый с большинством медиаплееров и радио-приложений. Обратите внимание, что M3U не сохраняет все метаданные станций, поэтому восстановление из M3U может привести к меньшей детализации, чем резервная копия JSON.

Импорт избранного… — загружает станции из ранее экспортированного файла JSON или M3U. После выбора файла вам будет задан вопрос о том, как добавить станции:

• Да (Объединить) — добавляет импортированные станции в ваш существующий список, не удаляя текущие станции из избранного. Дубликаты не добавляются дважды.
• Нет (Заменить) — полностью очищает ваш текущий список избранного и заменяет его содержимым импортированного файла.
• Отмена — возвращает в обозреватель без внесения каких-либо изменений.

После успешного импорта список избранного, список станций для запланированной записи и список станций для таймера автоматически обновляются.

Изменение порядка в избранном

Выберите станцию на вкладке «Избранное» и нажмите запятая, чтобы перейти в режим перемещения — вы услышите звуковой сигнал. С помощью клавиш со стрелками перейдите к целевой позиции, затем снова нажмите запятая. Станция будет помещена в выбранную позицию, и новый порядок будет немедленно сохранён. Повторное нажатие запятой на той же позиции отменяет перемещение.

Прямые сочетания клавиш для станций из избранного

Каждая станция в вашем списке избранного регистрируется как отдельный скрипт в диалоге жестов ввода NVDA, в категории FreeRadio Stations. Вы можете назначить любой станции любое сочетание клавиш и нажимать его из любого места — нет необходимости сначала открывать окно обзора.

Чтобы назначить сочетание клавиш:

1. Откройте меню NVDA → Параметры → Жесты ввода.
2. Разверните категорию FreeRadio Stations.
3. Найдите станцию по названию, выберите её и нажмите Добавить.
4. Нажмите желаемую комбинацию клавиш и подтвердите.

Сочетание клавиш немедленно активирует станцию. Если станция впоследствии будет удалена из избранного, её запись исчезнет из категории, и любое назначенное ей сочетание клавиш будет автоматически очищено NVDA. Когда новая станция добавляется в избранное, она сразу же появляется в категории — диалог жестов ввода не нужно переоткрывать.

Добавление пользовательской станции

Чтобы добавить станцию, которой нет в Radio Browser, используйте кнопку «Добавить пользовательскую станцию». В появившемся диалоге введите название станции и URL-адрес потока, чтобы добавить её непосредственно в избранное. Пользовательские станции можно воспроизводить и изменять их порядок так же, как и любое другое избранное.

Аудиопрофиль станции

Вкладка «Избранное» содержит две кнопки для управления аудионастройками для каждой станции:

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

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

Обе кнопки расположены под списком избранного и активны только когда станция в списке выбрана.

Распознавание музыки

Тройное нажатие Ctrl+Win+I запускает распознавание музыки на основе Shazam для текущего воспроизводящегося потока. Распознавание запускается только при отсутствии ICY-метаданных (информации о треке, транслируемой станцией); если метаданные присутствуют, они копируются в буфер обмена.

Распознавание работает следующим образом: короткий аудиосэмпл захватывается из потока с помощью ffmpeg, применяется алгоритм снятия отпечатков пальцев Shazam, и результат отправляется на серверы Shazam. Если распознавание успешно, название трека, исполнитель, альбом и год выпуска объявляются NVDA и автоматически копируются в буфер обмена. Если включена опция Сохранять понравившиеся песни в текстовый файл, результат распознавания также добавляется в likedSongs.txt.

Аудиоотклик: при запуске распознавания звучат два восходящих звуковых сигнала, а при завершении — два нисходящих. Пока процесс выполняется, каждые 2 секунды воспроизводится короткий звуковой сигнал.

Требование: требуется ffmpeg.exe. Файл ffmpeg.exe, помещённый в папку дополнения, используется автоматически; если он находится в другом месте, путь можно указать в настройках. Загрузите ffmpeg с ffmpeg.org.

Аудиозеркало

Сочетание Ctrl+Win+M дублирует текущий воспроизводящийся поток одновременно на второе устройство вывода звука. Это полезно для прослушивания на двух разных устройствах одновременно, например, на колонках и в наушниках.

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

Примеры использования:

• Колонки + наушники — позвольте гостю слушать ту же трансляцию в наушниках, пока вы слушаете через колонки компьютера.
• Настройка записи — направьте основной выход на колонки, а второй выход — на внешний рекордер или аудиоинтерфейс для внешнего захвата.
• Многокомнатное воспроизведение — воспроизводите через Bluetooth-колонку и встроенные динамики одновременно; не требуется дополнительного программного обеспечения для передачи звука в другую комнату.
• Удалённый мониторинг — в сеансе общего доступа к экрану или удалённого рабочего стола и локальная, и удалённая стороны могут слышать один и тот же поток одновременно.

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

Запись

Записи по умолчанию сохраняются в папку Documents\FreeRadio Recordings\. Имя файла включает название станции (или название песни в режиме записи песен) и время начала записи. Папку записей можно изменить в любое время в меню NVDA → Параметры → Настройки → FreeRadio → Папка записей. Поскольку механизм записи подключается непосредственно к потоку, аудио записывается на диск по мере получения — без обработки или перекодирования; качество записи идентично качеству трансляции.

Мгновенная запись: пока станция играет, нажмите Ctrl+Win+E один раз. Нажмите снова, чтобы остановить. Воспроизведение продолжается без перерыва на протяжении всего процесса.

Запись песни: Дважды быстро нажмите Ctrl+Win+E, пока играет станция, транслирующая ICY-метаданные. Запись начинается немедленно и называется по текущему названию трека. Когда трек меняется, запись автоматически останавливается, и NVDA объявляет имя сохранённого файла. Если вы хотите завершить запись досрочно, до окончания трека, снова дважды нажмите Ctrl+Win+E. Если текущая станция не транслирует ICY-метаданные, запись песен недоступна, и NVDA сообщит вам об этом.

Запланированная запись: Откройте вкладку «Запись» в обозревателе. Выберите станцию из избранного, введите время начала в формате ЧЧ:ММ и продолжительность в минутах, выберите один или несколько активных дней, затем выберите режим повторения и режим записи:

Активные дни: Отметьте один или несколько дней недели. В режиме однократной записи для каждого выбранного дня создаётся отдельная запись, каждая из которых помещается на следующее предстоящее наступление этого дня. В режиме повторения запись повторяется только в отмеченные дни. Если дни не отмечены, запись не привязана к конкретным дням.

Повторение:

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

Режим записи:

• Запись во время прослушивания — воспроизводит и записывает одновременно. Запускается бэкенд воспроизведения в порядке приоритета BASS → VLC → PotPlayer → Windows Media Player.
• Только запись — выполняет запись в фоновом режиме без вывода звука; механизм записи подключается непосредственно к потоку.

NVDA объявляет, когда запись начинается и когда заканчивается. Если NVDA перезапускается во время активной запланированной записи, запись автоматически возобновляется при запуске.

Временной сдвиг (перемотка живого радио)

Временной сдвиг позволяет перематывать станцию, которую вы слушаете в данный момент, как видеомагнитофон или DVR — остановитесь в нужный момент, вернитесь на несколько минут назад и снова догоните прямой эфир, когда захотите. Воспроизведение не должно останавливаться для этого: перемотка назад и вперёд выполняются мгновенно в одном и том же аудиопотоке.

Эта функция отключена по умолчанию. Включите её в меню NVDA → Параметры → Настройки → FreeRadio → Включить буфер временного сдвига (перемотка живого радио, ~10 минут) или переключите её мгновенно в любое время с помощью Ctrl+Win+T.

Как это работает

После включения FreeRadio непрерывно захватывает текущую воспроизводящуюся станцию в циклический локальный буфер в фоновом режиме, независимо от обычного воспроизведения. Буфер содержит примерно последние 10 минут аудио; более старая аудио автоматически удаляется из начала по мере поступления нового аудио, поэтому буфер всегда представляет «недавнее прошлое» относительно текущего времени.

• Ctrl+Win+J — Перемотка на 15 секунд назад. Первое нажатие переключает вас с прямого эфира в режим воспроизведения с временным сдвигом, начиная с 15 секунд от текущего времени. Каждое последующее нажатие перемещает ещё на 15 секунд назад, вплоть до предела буфера.
• Ctrl+Win+K — Быстрая перемотка на 15 секунд вперёд в режиме временного сдвига. Как только вы достигаете текущего времени, воспроизведение автоматически переключается обратно на прямой эфир, и NVDA объявляет «Возврат к прямому эфиру» — вам не нужно делать ничего дополнительного, чтобы возобновить обычное прослушивание.
• Ctrl+Win+T — Включает или выключает всю функцию. Отключение во время временного сдвига немедленно возвращает вас к прямому эфиру и останавливает фоновый захват для текущей станции.

Фоновый захват продолжает выполняться всё время, пока вы находитесь в режиме временного сдвига, поэтому текущее время продолжает двигаться вперёд, даже пока вы слушаете то, что было несколько минут назад — точно как настоящий видеомагнитофон.

Включение и прогревание буфера

Буфер начинает заполняться, как только станция начинает воспроизводиться (после включения функции) или в момент включения функции, когда вы уже слушаете станцию. Из-за этого перемотка назад возможна только после того, как было захвачено несколько секунд аудио — если вы нажмёте Ctrl+Win+J сразу после переключения станции, NVDA сообщит, что буферизованного аудио пока недостаточно. Подождите несколько секунд и попробуйте снова.

Переключение на другую станцию всегда перезапускает буфер для новой станции; буферизованное аудио предыдущей станции отбрасывается.

Поддерживаемые потоки

Временной сдвиг работает с тем же диапазоном потоков, который FreeRadio уже поддерживает:

• Обычные потоки HTTP/HTTPS (MP3, AAC, OGG и т.д.), включая серверы в стиле Shoutcast/Icecast.
• Потоки HLS (.m3u8) — FreeRadio разрешает главный плейлист станции, отслеживает медиа-плейлист и загружает сегменты в фоновом режиме, чтобы поддерживать буфер заполненным, так же как это работает для обычных потоков.

В редких случаях, когда плейлист станции вообще не может быть прочитан (например, из-за повреждённого или недоступного манифеста .m3u8), NVDA сообщит, что перемотка для этой конкретной станции недоступна.

Требования и ограничения

• Требуется бэкенд BASS. Временной сдвиг недоступен, когда BASS отключён и воспроизведение переключается на VLC, PotPlayer или Windows Media Player.
• Буфер составляет примерно 10 минут; вы не можете перемотать дальше этого предела.
• Буфер привязан к станции: переключение станций, остановка воспроизведения или перезапуск NVDA очищают его и начинают заново.
• Воспроизведение с временным сдвигом использует собственный локальный буферный файл и не создаёт сохранённую запись — если вы хотите сохранить аудио навсегда, используйте также мгновенную запись (Ctrl+Win+E).

Таймер

Откройте вкладку «Таймер» в обзоре станций (Alt+4). Можно добавить два типа таймеров:

Будильник — запустить радио: Автоматически начинает воспроизведение выбранной станции из избранного в указанное время. Выберите станцию и введите время в формате ЧЧ:ММ.

Таймер сна — остановить радио: Останавливает воспроизведение в указанное время. Когда таймер срабатывает, громкость постепенно уменьшается в течение 60 секунд перед остановкой воспроизведения. Выбор станции не требуется; достаточно ввести время.

Для обоих типов, если введённое время уже прошло, действие планируется на следующий день. Добавление таймера блокируется, если другой таймер — любого типа — уже существует на то же время; появляется сообщение о конфликте с предложением сначала удалить существующую запись. Ожидающие таймеры перечислены на вкладке; выберите один и нажмите кнопку «Удалить выбранный таймер», чтобы отменить его.

Настройки

Следующие параметры можно настроить в меню NVDA → Параметры → Настройки → FreeRadio:

Отключение уведомлений

Когда в настройках включена опция Отключить уведомления, NVDA отключает следующие автоматические объявления:

• Название станции при запуске новой станции
• Изменения состояния воспроизведения: воспроизведение, пауза, остановка
• События записи: начало, остановка, завершение (мгновенная, запись песен и запланированная запись)
• Объявления смены ICY-треков, даже если также включена опция Автоматически объявлять смену треков

Следующие объявления не затрагиваются: сообщения об ошибках, отклики об избранном (добавлено / уже в списке), результаты распознавания музыки и уведомления об обновлениях.

Эту настройку можно переключить в меню NVDA → Параметры → Настройки → FreeRadio или мгновенно в любое время через неназначенный жест ввода (назначьте его в меню NVDA → Параметры → Жесты ввода → FreeRadio). При переключении NVDA один раз объявляет «Уведомления отключены» или «Уведомления включены» для подтверждения изменения.

Автоматическое объявление смены треков

Когда в настройках включена опция Автоматически объявлять смену треков, FreeRadio проверяет поток ICY-метаданных активной станции в фоновом режиме примерно каждые 5 секунд. При смене трека новое название автоматически озвучивается NVDA — нажатие клавиш не требуется.

При переключении на новую станцию информация о первом треке объявляется сразу после установления соединения. Если вы переключаетесь на станцию, которая не транслирует ICY-метаданные, система молчит, и информация о предыдущем треке не повторяется.

Эта функция отключена по умолчанию и может быть включена в меню NVDA → Параметры → Настройки → FreeRadio.

Понравившиеся песни

Когда включена опция Сохранять понравившиеся песни в текстовый файл, информация о треке, скопированная в буфер обмена троекратным нажатием Ctrl+Win+I, также добавляется построчно в Documents\FreeRadio Recordings\likedSongs.txt.

На станциях, транслирующих ICY-метаданные, название трека и исполнитель сохраняются напрямую. На станциях без ICY-метаданных результат распознавания Shazam сохраняется в тот же файл — оба источника используют один и тот же список. Файл создаётся автоматически, если он не существует; каждая запись добавляется в конец файла, и предыдущие записи никогда не удаляются.

Вкладка «Понравившиеся песни»

Вкладка Понравившиеся песни в обзоре станций отображает все треки, сохранённые в likedSongs.txt. Список автоматически перезагружается из файла при каждом открытии вкладки.

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

Выбор трека из списка активирует следующие действия:

• Воспроизвести на Spotify: Пытается открыть приложение Spotify для рабочего стола напрямую. Если приложение не установлено, переключается на веб-сайт Spotify и автоматически начинает воспроизведение первого результата.
• Воспроизвести на YouTube (Alt+O): Выполняет поиск YouTube по выбранному треку и открывает результаты в браузере по умолчанию.
• Показать текст песни: Получает и отображает текст песни для выбранного трека. Текст песен извлекается с lrclib.net (бесплатно, учётная запись не требуется). Пока выполняется фоновый поиск, объявляется короткое сообщение «Получение текста песни…». Если текст найден, он открывается в диалоговом окне только для чтения, где вы можете прочитать его с помощью NVDA и скопировать в буфер обмена. Если текст не найден, NVDA объявляет об этом. Кнопка временно отключается во время выполнения запроса, чтобы предотвратить дублирование запросов.
• Удалить (Alt+M): Удаляет выбранный трек из likedSongs.txt и обновляет список. Клавиша Delete также активирует эту кнопку, когда фокус находится в списке.
• Обновить (Alt+E): Перезагружает список из файла.

Кнопки Spotify, YouTube, Показать текст песни и Удалить активны только тогда, когда в списке выбран реальный трек.

Сервис текстов песен

FreeRadio использует lrclib.net для получения текстов песен — бесплатной открытой базы данных, не требующей ключа API или учётной записи. Процесс поиска анализирует строку трека, сохранённую в likedSongs.txt, и пытается выполнять постепенно менее строгие запросы, пока не будет найден текст:

1. Точное совпадение с использованием полного имени исполнителя и очищенного названия (суффиксы-помехи, такие как «Remastered», «Live» или год, удаляются перед поиском).
2. Точное совпадение с использованием полного имени исполнителя и оригинального названия (если очистка изменила его).
3. Точное совпадение с использованием только первого имени исполнителя и очищенного названия (для строк с несколькими исполнителями, например «Artist A & Artist B»).
4. Нечёткий поиск с использованием первого имени исполнителя и очищенного названия.
5. Нечёткий поиск с использованием исходной строки трека как последнее средство.

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

Воспроизведение

Дополнение выбирает бэкенд воспроизведения в следующем порядке приоритета:

1. BASS — основной бэкенд по умолчанию. Отдельной установки не требуется; он встроен в дополнение. BASS отправляет аудио непосредственно в стек Windows и отображается в микшере громкости Windows как независимый источник звука с именем «pythonw.exe», отдельно от NVDA. Это означает, что аудио FreeRadio проходит по совершенно отдельному каналу от речи NVDA: радио не обрезается, не смешивается и не подвергается влиянию собственных аудионастроек NVDA во время речи NVDA. Пользователь может регулировать громкость радио независимо от NVDA в микшере громкости Windows. Поддерживает HTTP, HTTPS и большинство встроенных форматов потоков. Аудиозеркало доступно только с этим бэкендом.
2. VLC — подключается, если BASS не работает. Автоматически ищется в стандартных местах установки, папках профиля пользователя и системной переменной PATH.
3. PotPlayer — используется, если VLC не найден. Автоматически ищется в стандартных местах установки.
4. Windows Media Player — используется в крайнем случае; требует, чтобы компонент WMP был установлен в системе.

Проверка обновлений

FreeRadio автоматически проверяет наличие новых версий через GitHub.

Автоматическая проверка: Запускается в фоновом режиме через 15 секунд после запуска NVDA. Если найдена новая версия, вы получаете уведомление; если версия не найдена, сообщение не показывается.

Ручная проверка: Может быть запущена по запросу из меню NVDA → Сервис → FreeRadio → Проверить обновления…. При таком запуске результат объявляется, даже если версия актуальна.

Когда найдено обновление: Открывается диалог с номером версии и установленной у вас версией.

• Если на GitHub-релизе доступен непосредственно загружаемый файл .nvda-addon, отображается кнопка Загрузить и установить. После подтверждения файл загружается в фоновом режиме, NVDA объявляет о начале загрузки, и автоматически открывается окно установки NVDA.
• Если прямая ссылка для загрузки недоступна, отображается кнопка Открыть страницу, и страница релиза GitHub открывается в браузере по умолчанию.

Чтобы отключить автоматические проверки: Отключите опцию Проверять обновления автоматически в меню NVDA → Параметры → Настройки → FreeRadio.

Лицензия

GPL v2