Push-to-talk speech-to-text input using OpenAI Whisper
Project description
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. Default:base. Common choices:tiny,base,small,medium,large-v3-turbo.- Run
uvx whisper-ptt --helpfor full list.
- Run
--key— Hotkey name frompynput.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:
- Open System Settings > Privacy & Security > Accessibility
- Click the + button and add your terminal app (Terminal, iTerm2, VS Code, etc.)
- If already listed, toggle it off and back on
Microphone access is prompted automatically on first use.
Release
git tag v1.0.x
git push --tags
CI runs tests and publishes to PyPI automatically.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file whisper_ptt-1.2.0.tar.gz.
File metadata
- Download URL: whisper_ptt-1.2.0.tar.gz
- Upload date:
- Size: 23.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.10.7 {"installer":{"name":"uv","version":"0.10.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
39fe9021684f69609a7854651ed70cefa5c7b1a717f26a3c7c5bf863a58fb525
|
|
| MD5 |
10be872d8f656ecaa6d5a4152d3a8194
|
|
| BLAKE2b-256 |
186e5b7bb2a4acb5f930e57c0542f53d6d94961bd9290ae821cb2d86d794c86c
|
File details
Details for the file whisper_ptt-1.2.0-py3-none-any.whl.
File metadata
- Download URL: whisper_ptt-1.2.0-py3-none-any.whl
- Upload date:
- Size: 3.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.10.7 {"installer":{"name":"uv","version":"0.10.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
5fcea1c1ffcbf35ef5c4942012f8cf0b016f0068c0cc348bcff250683a909120
|
|
| MD5 |
4979924f229ed308004b9869a5ad9098
|
|
| BLAKE2b-256 |
3d2f0bdec858e6a50b90a45a4ba166b93d1fa150a49c067ed9881f34ead2ef84
|
