Metadata-Version: 2.4
Name: whisper-ptt
Version: 1.0.0
Summary: Push-to-talk speech-to-text input using OpenAI Whisper
Project-URL: Homepage, https://github.com/xloc/whisper-ptt
Project-URL: Source, https://github.com/xloc/whisper-ptt
Requires-Python: >=3.14
Description-Content-Type: text/markdown
Requires-Dist: openai-whisper
Requires-Dist: sounddevice
Requires-Dist: soundfile
Requires-Dist: pynput

# whisper-ptt

Push-to-talk speech-to-text. Hold a key to record, release to transcribe and type.

## Usage

```
uvx whisper-ptt
uvx whisper-ptt --model base --key alt_r
```

## Options

- `--model` — Whisper model (tiny, base, small, medium, large). Default: `base`
- `--key` — Hotkey name from `pynput.keyboard.Key`. Default: `alt_r`

## macOS permissions

This tool needs two macOS permissions to work:

- **Accessibility** — to listen for hotkey presses and type transcribed text into the active window.
- **Microphone** — to record audio.

To grant accessibility access:

1. Open System Settings > Privacy & Security > Accessibility
2. Click the + button and add your terminal app (Terminal, iTerm2, VS Code, etc.)
3. If already listed, toggle it off and back on

Microphone access is prompted automatically on first use.
