feat(windows): add Push-to-Talk support with compound hotkeys#153
Merged
gabrielste1n merged 14 commits intoJan 27, 2026
Conversation
Adds full Push-to-Talk functionality on Windows with support for compound hotkeys like Ctrl+F11, Alt+F8, etc. ## Windows Push-to-Talk - Add native Windows keyboard hook (windows-key-listener.c) using Low-Level Keyboard Hook (WH_KEYBOARD_LL) for reliable KEY_DOWN/KEY_UP detection - Support compound hotkeys with modifiers (Ctrl, Alt, Shift) by tracking modifier key states with GetAsyncKeyState() - Add WindowsKeyManager.js to manage the native binary lifecycle - Emit KEY_UP when modifier keys are released while main key is held ## Hotkey Capture Fix - Stop Windows key listener when entering hotkey capture mode so it doesn't interfere with recording new hotkeys - Temporarily unregister globalShortcut during capture to prevent key event consumption - Restart listener when exiting capture mode if in push mode ## ELECTRON_RUN_AS_NODE Fix - Add run-electron.js wrapper script to unset ELECTRON_RUN_AS_NODE environment variable (inherited from Claude Code and similar tools) - Update dev:main script to use the wrapper ## Additional Improvements - Add auto-start at login feature with UI in Settings - Add debug logging for audio recording and whisper-server - Fix whisper-server PATH to find companion DLLs on Windows - Fix hotkeyManager to check isRegistered before returning success - Change dev server port from 5174 to 5080 Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Add Custom Dictionary feature for improving transcription accuracy - New "Custom Dictionary" section in Settings sidebar - Words are passed as context hints to Whisper via initialPrompt - Supports adding phrases like "The word is Synty" for difficult words - Fix windows-key-listener.exe not bundled in production builds - Add windows-key-listener* to electron-builder extraResources filter Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
…to-talk-compound-hotkeys # Conflicts: # src/helpers/audioManager.js
6 tasks
Resolved conflicts: - CLAUDE.md: Keep both Windows Push-to-Talk and GNOME Wayland sections - README.md: Keep all new features (Push-to-Talk, Custom Dictionary, GNOME Wayland) - windowManager.js: Keep DEV_SERVER_PORT constant over hardcoded port Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
…yland, and hotkey capture
…inject into reasoning system prompts
…d tar.gz format Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
gabrielste1n
deleted the
feature/windows-push-to-talk-compound-hotkeys
branch
January 27, 2026 05:14
charian47
pushed a commit
to charian47/openwhispr
that referenced
this pull request
Apr 25, 2026
…ispr#153) * feat(windows): add Push-to-Talk support with compound hotkeys Adds full Push-to-Talk functionality on Windows with support for compound hotkeys like Ctrl+F11, Alt+F8, etc. ## Windows Push-to-Talk - Add native Windows keyboard hook (windows-key-listener.c) using Low-Level Keyboard Hook (WH_KEYBOARD_LL) for reliable KEY_DOWN/KEY_UP detection - Support compound hotkeys with modifiers (Ctrl, Alt, Shift) by tracking modifier key states with GetAsyncKeyState() - Add WindowsKeyManager.js to manage the native binary lifecycle - Emit KEY_UP when modifier keys are released while main key is held ## Hotkey Capture Fix - Stop Windows key listener when entering hotkey capture mode so it doesn't interfere with recording new hotkeys - Temporarily unregister globalShortcut during capture to prevent key event consumption - Restart listener when exiting capture mode if in push mode ## ELECTRON_RUN_AS_NODE Fix - Add run-electron.js wrapper script to unset ELECTRON_RUN_AS_NODE environment variable (inherited from Claude Code and similar tools) - Update dev:main script to use the wrapper ## Additional Improvements - Add auto-start at login feature with UI in Settings - Add debug logging for audio recording and whisper-server - Fix whisper-server PATH to find companion DLLs on Windows - Fix hotkeyManager to check isRegistered before returning success - Change dev server port from 5174 to 5080 Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com> * feat: add Custom Dictionary and fix Windows production build - Add Custom Dictionary feature for improving transcription accuracy - New "Custom Dictionary" section in Settings sidebar - Words are passed as context hints to Whisper via initialPrompt - Supports adding phrases like "The word is Synty" for difficult words - Fix windows-key-listener.exe not bundled in production builds - Add windows-key-listener* to electron-builder extraResources filter Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com> * fix(windows): add prebuilt binary support and improve Push-to-Talk code quality * refactor: download-nircmd.js to use shared utils * fix: code quality fixes for download scripts and dev server port alignment * fix: add GITHUB_TOKEN auth to avoid API rate limits in CI * chore: updates docs * fix: hotkey capture mode re-registration and platform improvements * feat: add F13-F24 extended function key support for Windows, GNOME Wayland, and hotkey capture * feat: persist custom dictionary to SQLite with localStorage sync and inject into reasoning system prompts * fix: update llama.cpp download script for new release asset naming and tar.gz format Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com> * fix: add gh_token to downlaod scripts to avoid rate limits --------- Co-authored-by: Craig von Chamier <craig@cvcwebsolutions.com> Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Ctrl+Shift+F11) for PTT activation--force/version pinningWindows Push-to-Talk
Enables hold-to-talk dictation on Windows via a native keyboard listener that detects key-up/down events (which Electron's
globalShortcutcannot do).windows-key-listener.exeFallback: If native listener unavailable, Windows falls back to tap-to-toggle mode.
Download Script Improvements
LLAMA_CPP_VERSION,WHISPER_CPP_VERSION,WINDOWS_KEY_LISTENER_VERSIONenv vars--forceflag to update existing binariesdownload-utils.js(removed ~110 lines of duplicate code)fetchJson()to prevent infinite loopsFiles Changed
New:
src/helpers/windowsKeyManager.js- Native listener process managerresources/windows-key-listener.c- Native C keyboard hookscripts/build-windows-key-listener.js- Local compilation fallbackscripts/download-windows-key-listener.js- Prebuilt binary downloadscripts/lib/download-utils.js- Shared download utilitiesModified:
main.js- WindowsKeyManager integrationsrc/helpers/windowManager.js- PTT availability trackingsrc/vite.config.mjs- Port alignment (5174)Test Plan
npm run dev- verify app loads at localhost:5174npm run download:whisper-cpp -- --current --forceCo-Authored-By: Craig von Chamier craig@cvcwebsolutions.com