Files
wisper-key/README.md
T

3.0 KiB

WhisperKey

Нативная глобальная диктовка для macOS:

  • F5 — локальный whisper.cpp с полной несжатой моделью large-v3-turbo;
  • Option+F5 — OpenAI Speech-to-Text API;
  • модель постоянно загружена в фоновом локальном сервере, поэтому не перечитывается с диска после каждого F5;
  • с системным источником ввода черновик появляется через 2–3 секунды и отображается как нативный подчёркнутый marked text;
  • после остановки вся реплика распознаётся целиком и заменяет подчёркнутый черновик финальным текстом;
  • если системный источник не включён, работает прежняя безопасная вставка фрагментами;
  • короткой нарезки по 1,5 секунды нет: ей не хватало контекста, и Whisper начинал домысливать;
  • после 5 секунд тишины запись завершается автоматически, повторное нажатие останавливает её вручную;
  • результат очищается и вставляется в активное текстовое поле;
  • OpenAI API key хранится в macOS Keychain.

Установка

chmod +x scripts/*.sh
./scripts/setup-local-whisper.sh
./scripts/install-app.sh

При первом запуске разрешите:

  1. доступ к микрофону;
  2. управление компьютером в «Конфиденциальность и безопасность → Универсальный доступ».

Установщик регистрирует системный источник WhisperKey. При F5 он выбирается только на время диктовки, а после фиксации текста автоматически возвращается предыдущая раскладка. Если macOS не разрешила автоматическое включение, откройте Системные настройки → Клавиатура → Ввод текста → Изменить… и один раз добавьте WhisperKey вручную.

Отключите штатное действие F5:

Системные настройки → Клавиатура → Диктовка → Сочетание клавиш.

API-ключ добавляется через значок WhisperKey в строке меню → «Настройки».

Данные

Локальный режим не отправляет запись в сеть. Облачный режим отправляет временный WAV-файл в OpenAI API; после ответа временные аудиофайлы удаляются.