Skip to content

Voice-to-text dictation app with local (Nvidia Parakeet/Whisper) and cloud models (BYOK). Privacy-first and available cross-platform.

chore: bump to 1.30 + docs update

Gabriel Steina35db3a36e40
diff --git a/.env.example b/.env.example
index 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-keys
GEMINI_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 mode
OPENWHISPR_LOG_LEVEL=debug
\ No newline at end of file
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 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-22
diff --git a/README.md b/README.md
index 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) file
cp 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 + Portable
npm 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 Configuration
ANTHROPIC_API_KEY=your_anthropic_api_key_here
-# Optional: Google Gemini API Configuration
+# Optional: Google Gemini API Configuration
GEMINI_API_KEY=your_gemini_api_key_here
+# Optional: Groq API Configuration (ultra-fast inference)
+GROQ_API_KEY=your_groq_api_key_here
+
# Optional: Debug mode
DEBUG=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
## Acknowledgments
diff --git a/package-lock.json b/package-lock.json
index 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.json
index 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,