Audio version — Estimated duration: 1 min 57 sec

Quickstart

Run the Script

python whisper-dictate-v2.py

Once the model loads, you’ll see:

Ready. Hold RIGHTALT to dictate.

Hold Right Alt (default hotkey) to record, release to transcribe and type.

Finding Your Hotkey

To find your keyboard’s key code:

python3 -m evdev.evtest

Press your desired key and note the KEY_* value, then update HOTKEY_CODE in the script.

Usage Tips

1. Focus your target window before releasing the hotkey
2. Speak clearly at a normal pace
3. Watch the terminal for stream previews (>> prefix) as you speak
4. Short utterances (< 0.3s) are filtered out to prevent accidental triggers

Next Steps

• Configuration — Customize model size, hotkey, and more
• Architecture — How it works under the hood
• Troubleshooting — If something goes wrong