Skip to content

v0.9.0

Choose a tag to compare

@github-actions github-actions released this 06 Dec 11:34
· 137 commits to main since this release
4894fda

WhisperHotkey v0.9.0

macOS voice-to-text app using local Whisper. Hold hotkey, speak, release → text inserted at cursor.

Installation

  1. Download: WhisperHotkey-0.9.0.dmg

  2. Open DMG: Double-click to mount

  3. Install: Drag WhisperHotkey.app to Applications folder

  4. Bypass Gatekeeper (first time only - required because app is ad-hoc signed, not notarized with Apple Developer certificate):

    • Right-click WhisperHotkey.app in Applications
    • Select "Open"
    • Click "Open" in security dialog

    Or via Terminal:

    xattr -d com.apple.quarantine /Applications/WhisperHotkey.app
    open /Applications/WhisperHotkey.app
  5. Permissions: Grant Microphone + Accessibility when prompted

  6. First run: Downloads Whisper model (~466MB)

Usage

  • Default hotkey: Ctrl+Option+Z
  • Press and hold → speak → release
  • Text appears at cursor

Configuration

  • Edit: ~/.whisper-hotkey/config.toml
  • Change hotkey, model, performance settings
  • Restart app after changes

Auto-Start

See documentation for LaunchAgent setup.

Requirements

  • macOS 11.0+ (Big Sur or later)
  • Apple Silicon (M1/M2/M3) or Intel
  • ~500MB disk space (~466MB for model)

Verification

shasum -a 256 -c WhisperHotkey-0.9.0.dmg.sha256

Support