Skip to content
privatekey7Public

About

Offline voice-to-text for Windows. Push right Ctrl, speak, release — text appears at cursor. 5 ML models (Whisper / GigaAM v3 / Vosk / Parakeet / SenseVoice). RU-localized IT dictionary, tray-app, fully offline.

Topics

Resources

Stars

8 stars

Watchers

0 watching

Forks

Repository files navigation

Vox 2.0 — голосовой ввод для Windows

Speak it done. Зажми клавишу, говори, отпусти — текст появится там, где курсор. В любом приложении.

Vox работает полностью офлайн: голос никуда не отправляется, распознавание идёт на вашем компьютере. Без подписок.

📣 Новости и обратная связь — в Telegram-канале @privatekey_ai.


✨ Возможности

  • Push-to-talk в любом окне — браузер, мессенджер, редактор, терминал.
  • Модель под ваш язык:
    • Русский (по умолчанию) — модель GigaAM v3 от Сбера: точно понимает русскую речь, сама ставит знаки препинания и пишет числа цифрами («встреча в 11:30», «500 рублей»).
    • English и другие европейские — Parakeet TDT v3 от NVIDIA, 25 языков.
  • Длинные диктовки — запись любой длины распознаётся целиком: Vox делит её по паузам.
  • Продолжает фразу с того места, где вы остановились — после запятой пишет со строчной, после точки — с заглавной, в начале поля — без лишнего пробела.
  • Словарь понимает падежи — «на гитхабе» → «на GitHub», «с керилом» → «с Кириллом».
  • IT/ИИ-словарь — ~3900 терминов: «клод опус четыре и пять» → Claude Opus 4.5, «дипсик» → DeepSeek, «эн восемь эн» → n8n, «юзстейт» → useState, «гитхаб» → GitHub. Латиницей — только названия, модели, аббревиатуры и код; прижившиеся слова (промпт, токен, деплой) остаются по-русски.
  • Учится на ваших исправлениях: исправили слово после диктовки, и Vox сразу запомнит, как его писать. Если запомнил не то: меню Vox в трее → «Отменить последнее запоминание» или Настройки → Словарь. Vox запоминает исправления в большинстве программ (Блокнот, Word, браузер, Telegram, Notepad++ …). Некоторые программы не дают прочитать свой текст (часть редакторов кода, игры), там слово можно добавить вручную в Настройки → Словарь.
  • Ваш буфер обмена не пропадает — после вставки Vox возвращает то, что вы копировали.
  • Плашка записи — внизу экрана видно: «Слушаю…», «Распознаю…», «Вставлено» или «Не расслышал».
  • История с поиском, светлая и тёмная тема (как в Windows).

🚀 Установка

  1. Скачайте vox-setup.exe со страницы Releases и запустите.
  2. Отметьте по желанию «Запускать Vox при старте Windows» и нажмите Установить.
  3. При первом запуске выберите язык речи — Vox один раз скачает модель (~160 МБ для русского, ~465 МБ для английского).
  4. Попробуйте прямо в окне: зажмите правый Ctrl, скажите «Привет, Vox» и отпустите.

Vox 2.0 ставится поверх версии 1.x: история, словарь, настройки и уже скачанные модели сохраняются.

🇷🇺 Модели лежат на GitHub. Если загрузка не идёт — включите VPN и попробуйте снова.


🎙 Как пользоваться

  1. Поставьте курсор в любое поле ввода.
  2. Зажмите правый Ctrl (клавишу можно сменить в настройках) и говорите.
  3. Отпустите — текст появится у курсора.

Если нажали правый Ctrl как часть сочетания (например, Ctrl+C), Vox это поймёт и ничего не запишет.


🔧 Меню в трее

Пункт Что делает
Скопировать последнюю диктовку Кладёт последнюю диктовку в буфер обмена
История Все диктовки с поиском и кнопкой «Копировать»
Настройки Клавиша, язык речи, микрофон, звуки, автозапуск, буфер обмена, словарь
Выход Закрыть Vox

Клик по значку открывает настройки.


📁 Где хранятся данные

Путь Что там
C:\Program Files\Vox\ Программа
%APPDATA%\vox\models\ Модели распознавания*
%APPDATA%\vox\logs\vox.log Лог
%APPDATA%\vox\vox_data.db История и словарь
%APPDATA%\vox\config.json Настройки

* Если в имени пользователя Windows есть русские буквы, модели хранятся в C:\ProgramData\Vox\models\: движок распознавания не умеет открывать файлы по таким путям. Vox сверяет каждый файл модели с контрольной суммой при скачивании и при каждом запуске, поэтому подменённую модель он не загрузит.

Удаление Vox (Параметры Windows → Приложения): модели удаляются всегда. История, словарь, настройки и логи удаляются, только если ответить «Да» на вопрос «Удалить также историю диктовок, личный словарь и настройки?» (при тихом удалении /SILENT они остаются). Установка новой версии поверх ничего не удаляет.


🔒 Конфиденциальность и подпись


❓ Решение проблем

После записи — «Не расслышал»

Причина записана в логе (Настройки → Помощь → Открыть логи):

  • No audio from microphone — микрофон перестал отдавать звук (занят другой программой, отключилась гарнитура). Vox переоткроет его сам — повторите диктовку.
  • Too quiet — звук слишком тихий: выберите другой микрофон в настройках или говорите ближе.
  • Model returned no text — речь не разобрана; попробуйте ещё раз чётче.
Клавиша не срабатывает в некоторых программах

Windows не даёт обычным программам перехватывать клавиши в окнах, запущенных от имени администратора. В остальных окнах Vox работает как обычно.

Текст не вставился

Некоторые программы блокируют автовставку. Возьмите текст через трей → Скопировать последнюю диктовку и нажмите Ctrl+V. Если окно запущено от имени администратора, Windows не пропускает вставку — текст останется в буфере обмена, просто нажмите Ctrl+V.

SmartScreen предупреждает об установщике

Нажмите «Подробнее» → «Выполнить в любом случае». Установщик пока не подписан сертификатом: его собирает GitHub Actions из открытого кода этого репозитория.

Скачивайте Vox только со страницы Releases. Проверить, что файл не подменили, можно двумя способами:

  • Контрольная сумма. В PowerShell в папке с файлом выполните (Get-FileHash .\vox-setup.exe -Algorithm SHA256).Hash и сравните результат с SHA-256 в описании релиза. Та же сумма есть в отчёте сборки на вкладке Actions.
  • Подтверждение сборки. Если у вас есть GitHub CLI, выполните gh attestation verify vox-setup.exe --repo privatekey7/Vox. Команда проверит, что файл собран из этого репозитория. Работает для релизов начиная с 2.0.

🛠 Для разработчиков

Vox 2.0 написан на C# (.NET 10, WPF). Распознавание — sherpa-onnx.

dotnet test Vox.sln --filter "Category!=Models"        # тесты без моделей (работают и на Linux/macOS)
VOX_TEST_MODELS=/путь/к/моделям dotnet test Vox.sln     # + тесты на настоящих моделях
dotnet publish src/Vox.App -c Release -r win-x64 --self-contained -o publish
# записи диктовок (Настройки → Основное → «Сохранять записи диктовок») через модель и весь постпроцессинг:
dotnet run --project tools/Vox.Replay -- --audio путь/к/recordings --model gigaam --models /путь/к/моделям
dotnet run --project tools/Vox.Replay -- --audio путь/к/recordings --compare --models /путь/к/моделям  # GigaAM, Parakeet, Qwen3-ASR рядом

Установщик (vox-setup.exe) собирает GitHub Actions: .github/workflows/build.yml → Inno Setup (vox.iss).

Версии пакетов NuGet закреплены в packages.lock.json каждого проекта, CI ставит пакеты строго по ним (--locked-mode). Добавили или обновили пакет: выполните dotnet restore и закоммитьте изменённые packages.lock.json.

Проект Что внутри
src/Vox.Core Обработка текста, деление записи по паузам, каталог и загрузка моделей, настройки, история (SQLite)
src/Vox.Engine Распознавание через sherpa-onnx
src/Vox.App Windows-приложение: клавиша, микрофон, вставка, трей, окна

Решения и дизайн: docs/adr/, docs/design/v2/. Версия 1.x (Python) — в истории репозитория.

Сторонние данные и шрифты

Код Vox — MIT. Отдельные файлы — под своими лицензиями:

Файл Что Лицензия
src/Vox.Core/Text/Data/common-words.txt.gz 48 тыс. частых русских словоформ (hermitdave/FrequencyWords), чтобы самообучение не трогало обычные слова CC BY-SA 4.0 (common-words.LICENSE.md)
src/Vox.Core/Text/Data/english.txt.gz 281 тыс. английских словоформ (SCOWL, Kevin Atkinson), чтобы поиск по звучанию не превращал обычные слова в бренды MIT-подобная, части public domain (english.LICENSE.md)
src/Vox.Core/Text/Data/ru_RU.dic.gz, ru_RU.aff.gz русский словарь Hunspell (А. И. Лебедев, из LibreOffice), чтобы названия с экрана не заменяли русские слова BSD (ru_RU.LICENSE.md)
src/Vox.App/Assets/Fonts/GolosText-*.ttf шрифт Golos Text (Paratype) SIL OFL 1.1 (OFL-GolosText.txt)
модели распознавания (скачиваются при первом запуске) GigaAM, Parakeet через sherpa-onnx лицензии авторов моделей

💬 Связь

Новости, обновления, вопросы и предложения — в Telegram: @privatekey_ai.

About

Offline voice-to-text for Windows. Push right Ctrl, speak, release — text appears at cursor. 5 ML models (Whisper / GigaAM v3 / Vosk / Parakeet / SenseVoice). RU-localized IT dictionary, tray-app, fully offline.

Topics

Resources

Stars

8 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages