2026.07.27: переход на версионирование по дате. Добавлено поле «url» в манифест (отсутствовало — теперь указывает на публичный репозиторий исходного кода). Синхронизирована информация о статусе тестирования в live_tuner.py с init.py и mic_capture.py (теперь все три файла корректно указывают, что настройка через микрофон в реальном времени прошла сквозное ручное тестирование на реальном компьютере с NVDA и Windows). Добавлена ссылка на исходный код в readme.html. Функциональных изменений в коде нет. Ранее протестировано сквозным образом на реальном компьютере с NVDA и Windows в предыдущем релизе (интерфейс диалога, эталонные тоны, настройка через микрофон в реальном времени, хроматический режим, переключение устройств/обнаружение отключения микрофона, сохранение настроек, объявления на тайском и английском языках).

Universal Tuner для NVDA

Universal Tuner — это дополнение-тюнер для NVDA, позволяющее настраивать музыкальные инструменты. Оно воспроизводит эталонные ноты для более чем двух десятков инструментов и строев, а также может прослушивать звук через микрофон в реальном времени и сообщать, соответствует ли сыгранная нота эталону, выше она или ниже.

Открытие тюнера

Нажмите NVDA+Shift+G, чтобы открыть окно Universal Tuner из любого места в Windows.

Воспроизведение эталонного тона

• Выберите Инструмент и Строй, затем перемещайтесь по списку Выбор, чтобы выбрать струну, пару струн или ноту.
• Пробел воспроизводит или останавливает звук выбранного элемента.
• Клавиши с цифрами 1–9 воспроизводят струны по порядку. На инструментах со спаренными струнами (12-струнная гитара, семейство мандолин, ирландский бузуки) повторное нажатие той же клавиши переключает звучание между струнами в паре.
• Home / End увеличивают или уменьшают громкость.
• Page Up / Page Down увеличивают или уменьшают длительность эталонного тона.

Настройка через микрофон в реальном времени

Нажмите L, чтобы начать или остановить прослушивание через микрофон во время игры на струне. Примерно каждые две секунды Universal Tuner выдаёт одно чёткое показание: нота в строе, выше на определённый процент или ниже на определённый процент (100% соответствует одному полутону).

• C переключает хроматический режим, в котором определяется ближайшая нота автоматически, вместо привязки к конкретной выбранной струне.
• Когда нота точно соответствует эталону, Universal Tuner воспроизводит короткий подтверждающий сигнал на высоте целевой ноты, а затем объявляет её название.
• O включает или выключает подтверждающий сигнал для тех, кто предпочитает только голосовое оповещение.
• R повторяет последнее показание настройки по запросу, если вы не расслышали его чётко.
• Во время прослушивания нажатие Пробел немедленно отменяет воспроизведение подтверждающего сигнала и голосовое объявление.

Другие сочетания внутри окна тюнера

• I переводит фокус в список Инструментов, T — в список Строев.
• F1 (один раз) озвучивает полное руководство по сочетаниям клавиш на тайском языке; повторное нажатие F1 в течение секунды озвучивает то же руководство на английском языке.
• Escape закрывает окно.
• Кнопка Расширенные настройки открывает диалог с параметрами частоты дискретизации, эталонной высоты A4, паузы между повторениями, длительности сигнала, длительности тона и выбора микрофонного устройства, а также кнопкой сброса к значениям по умолчанию.

Сохраняемые настройки

Эталонная высота A4, громкость, длительность тона, пауза между повторениями, частота дискретизации, хроматический режим, длительность сигнала, включение/отключение сигнала, микрофонное устройство, а также последние выбранные инструмент и строй сохраняются и автоматически восстанавливаются при следующем запуске NVDA.

Статус тестирования

По состоянию на версию 2.5.2 это дополнение прошло сквозное ручное тестирование на реальном компьютере с NVDA и Windows, включая настройку через микрофон в реальном времени, хроматический режим, переключение микрофонных устройств, обработку отключений, диалог расширенных настроек, сохранение настроек между перезапусками, а также объявления на тайском и английском языках. Тестирование охватывает аппаратное обеспечение и микрофонную конфигурацию одного тестировщика, а не всё разнообразие аудиоустройств. Если вы заметите неожиданное поведение с конкретным микрофоном или аудиоустройством, пожалуйста, сообщите о проблеме.

Автор

Peem Narkkhwan sharetoyouaccess@gmail.com

Исходный код

https://github.com/sharetoyouaccess/UniversalTuner-