Voice-to-text dictation app with local (Nvidia Parakeet/Whisper) and cloud models (BYOK). Privacy-first and available cross-platform.
JavaScript aianthropiccross-platformgeminigroqlinuxmacosnvidiaopen-sourceopenaiparakeetspeech-to-texttranscribewhisperwindows
chore: bump to 1.30 + docs update
Gabriel Steina35db3a36e40
diff --git a/.env.example b/.env.exampleindex 6424c04e7..73dc43d7b 100644--- a/.env.example+++ b/.env.example@@ -18,5 +18,9 @@ ANTHROPIC_API_KEY=your_anthropic_api_key_here# Get your API key from: https://aistudio.google.com/app/api-keysGEMINI_API_KEY=your_gemini_api_key_here-# Optional: Debug mode+# Groq API Configuration (optional - for ultra-fast cloud inference)+# Get your API key from: https://console.groq.com/keys+GROQ_API_KEY=your_groq_api_key_here++# Optional: Debug modeOPENWHISPR_LOG_LEVEL=debug\ No newline at end of filediff --git a/CHANGELOG.md b/CHANGELOG.mdindex 650b3019c..da8cb7c94 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -5,7 +5,7 @@ All notable changes to this project will be documented in this file.The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).-## [1.2.16] - 2026-01-26+## [1.3.0] - 2026-01-26### Added- **NVIDIA Parakeet Support**: Fast local transcription via sherpa-onnx runtime with INT8 quantized models@@ -24,12 +24,26 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0### Changed- **Download Scripts Refactored**: All download scripts now use shared utilities for consistency- **GitHub API Authentication**: Download scripts support `GITHUB_TOKEN` to avoid API rate limits in CI-- **Dev Server Port Alignment**: Development server port configuration improved for consistency+- **Debug Logging Cleanup**: Extracted common window loading code and cleaned up debug logging### Fixed-- **Whisper Model Path Resolution**: Fixed `large` and `turbo` model lookup failures by using registry-defined filenames (`ggml-large-v3.bin`, `ggml-large-v3-turbo.bin`) instead of hardcoded pattern-- **Windows Production Build**: Fixed Windows production build issues with proper binary bundling-- **Code Quality**: Various code quality improvements in download scripts and dev server management+- **GNOME Wayland Hotkey Improvements**: Improved hotkey handling on GNOME Wayland+- **Hotkey Persistence**: Fixed hotkey selection not persisting correctly+- **Custom Endpoint API Keys**: Fixed custom endpoint API keys not persisting to `.env` file+- **Custom Endpoint State**: Fixed custom endpoint using shared state instead of its own+- **Linux Stale Hotkey Registrations**: Clear stale hotkey registrations on startup on Linux+- **Wayland XWayland Paste**: Try xdotool on Wayland when XWayland is available+- **llama-server Libraries**: Bundle llama-server shared libraries and search from extract root for varying archive structures+- **STT/Reasoning Debug Logging**: Added missing debug logging for STT and reasoning pipelines++## [1.2.16] - 2026-01-24++### Fixed+- **App Startup Hang**: Fixed app initialization timing issues with Electron 36++- **Manager Initialization**: Deferred manager initialization until after `app.whenReady()` to prevent hangs+- **Debug Logger Initialization**: Deferred debugLogger file initialization until `app.whenReady()`+- **Config Bundling**: Fixed missing config files in production builds+- **whisper.cpp Binary Version**: Updated whisper.cpp release names and bumped binary version## [1.2.15] - 2026-01-22diff --git a/README.md b/README.mdindex 47d754cbf..7b905b3c6 100644--- a/README.md+++ b/README.md@@ -67,8 +67,9 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) filecp env.example .env# Edit .env and add your API keys:# OPENAI_API_KEY=your_openai_key- # ANTHROPIC_API_KEY=your_anthropic_key+ # ANTHROPIC_API_KEY=your_anthropic_key# GEMINI_API_KEY=your_gemini_key+ # GROQ_API_KEY=your_groq_key```**Method B - In-app configuration**:@@ -394,6 +395,10 @@ open-whispr/- `npm run build:renderer` - Build the React app only- `npm run download:whisper-cpp` - Download whisper.cpp for the current platform- `npm run download:whisper-cpp:all` - Download whisper.cpp for all platforms+- `npm run download:llama-server` - Download llama.cpp server for local LLM inference+- `npm run download:llama-server:all` - Download llama.cpp server for all platforms+- `npm run download:sherpa-onnx` - Download sherpa-onnx for Parakeet local transcription+- `npm run download:sherpa-onnx:all` - Download sherpa-onnx for all platforms- `npm run compile:native` - Compile native helpers (Globe key listener for macOS, key listener for Windows)- `npm run build` - Full build with signing (requires certificates)- `npm run build:mac` - macOS build with signing@@ -402,6 +407,8 @@ open-whispr/- `npm run pack` - Build without signing (for personal use)- `npm run dist` - Build and package with signing- `npm run lint` - Run ESLint+- `npm run format` - Format code with Prettier+- `npm run clean` - Clean build artifacts- `npm run preview` - Preview production build### Architecture@@ -444,7 +451,7 @@ npm run build:win # Windows NSIS + Portablenpm run build:linux # AppImage + DEB```-Note: build/pack/dist scripts download whisper.cpp for the current platform automatically. For multi-platform packaging from one host, run `npm run download:whisper-cpp:all` first.+Note: build/pack/dist scripts automatically download whisper.cpp, llama-server, and sherpa-onnx for the current platform. For multi-platform packaging from one host, run the `:all` variants first (`npm run download:whisper-cpp:all`, `npm run download:llama-server:all`, `npm run download:sherpa-onnx:all`).## Configuration@@ -465,9 +472,12 @@ LANGUAGE=# Optional: Anthropic API ConfigurationANTHROPIC_API_KEY=your_anthropic_api_key_here-# Optional: Google Gemini API Configuration+# Optional: Google Gemini API ConfigurationGEMINI_API_KEY=your_gemini_api_key_here+# Optional: Groq API Configuration (ultra-fast inference)+GROQ_API_KEY=your_groq_api_key_here+# Optional: Debug modeDEBUG=false```@@ -604,7 +614,7 @@ A: OpenWhispr supports 58 languages including English, Spanish, French, German,## Project Status-OpenWhispr is actively maintained and ready for production use. Current version: 1.2.16+OpenWhispr is actively maintained and ready for production use. Current version: 1.3.0- ✅ Core functionality complete- ✅ Cross-platform support (macOS, Windows, Linux)@@ -613,6 +623,8 @@ OpenWhispr is actively maintained and ready for production use. Current version:- ✅ Compound hotkey support- ✅ Windows Push-to-Talk with native key listener- ✅ Custom dictionary for improved transcription accuracy+- ✅ NVIDIA Parakeet support via sherpa-onnx+- ✅ GNOME Wayland native global shortcuts## Acknowledgmentsdiff --git a/package-lock.json b/package-lock.jsonindex c1c326663..1e1b46fb2 100644--- a/package-lock.json+++ b/package-lock.json@@ -1,12 +1,12 @@{"name": "open-whispr",- "version": "1.2.16",+ "version": "1.3.0","lockfileVersion": 3,"requires": true,"packages": {"": {"name": "open-whispr",- "version": "1.2.16",+ "version": "1.3.0","hasInstallScript": true,"license": "MIT","dependencies": {diff --git a/package.json b/package.jsonindex 1e95c59f2..6476bce39 100644--- a/package.json+++ b/package.json@@ -1,6 +1,6 @@{"name": "open-whispr",- "version": "1.2.16",+ "version": "1.3.0","description": "A desktop dictation application using whisper.cpp for speech-to-text transcription","main": "main.js","private": true,