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: doc update + worfklow var injection
Gabriel Steindc6e6c7fc2c6
diff --git a/.github/workflows/build-and-notarize.yml b/.github/workflows/build-and-notarize.ymlindex 0467140a8..720d6486d 100644--- a/.github/workflows/build-and-notarize.yml+++ b/.github/workflows/build-and-notarize.yml@@ -41,6 +41,9 @@ jobs:- name: Build Applicationrun: npm run build:linux -- --publish never+ env:+ VITE_NEON_AUTH_URL: ${{ vars.VITE_NEON_AUTH_URL }}+ VITE_OPENWHISPR_API_URL: ${{ vars.VITE_OPENWHISPR_API_URL }}- name: Upload Artifactsuses: actions/upload-artifact@v4@@ -84,6 +87,8 @@ jobs:run: npm run build:win -- --publish neverenv:GH_TOKEN: ${{ secrets.GH_TOKEN }}+ VITE_NEON_AUTH_URL: ${{ vars.VITE_NEON_AUTH_URL }}+ VITE_OPENWHISPR_API_URL: ${{ vars.VITE_OPENWHISPR_API_URL }}- name: Upload Artifactsuses: actions/upload-artifact@v4@@ -151,6 +156,8 @@ jobs:run: npm run build:mac -- --${{ matrix.arch }} --publish neverenv:GH_TOKEN: ${{ secrets.GH_TOKEN }}+ VITE_NEON_AUTH_URL: ${{ vars.VITE_NEON_AUTH_URL }}+ VITE_OPENWHISPR_API_URL: ${{ vars.VITE_OPENWHISPR_API_URL }}CSC_IDENTITY_AUTO_DISCOVERY: ${{ github.event_name != 'pull_request' && 'true' || 'false' }}CSC_KEY_PASSWORD: ${{ secrets.APPLE_CERTIFICATE_PASSWORD }}APPLE_API_KEY_ID: ${{ secrets.APPLE_API_KEY_ID }}diff --git a/.github/workflows/release.yml b/.github/workflows/release.ymlindex 6df1aadd6..c786e26d2 100644--- a/.github/workflows/release.yml+++ b/.github/workflows/release.yml@@ -50,6 +50,8 @@ jobs:run: npm run build:linux -- --publish alwaysenv:GH_TOKEN: ${{ secrets.GH_TOKEN }}+ VITE_NEON_AUTH_URL: ${{ vars.VITE_NEON_AUTH_URL }}+ VITE_OPENWHISPR_API_URL: ${{ vars.VITE_OPENWHISPR_API_URL }}build-windows:runs-on: windows-latest@@ -86,6 +88,8 @@ jobs:run: npm run build:win -- --publish alwaysenv:GH_TOKEN: ${{ secrets.GH_TOKEN }}+ VITE_NEON_AUTH_URL: ${{ vars.VITE_NEON_AUTH_URL }}+ VITE_OPENWHISPR_API_URL: ${{ vars.VITE_OPENWHISPR_API_URL }}build-macos:runs-on: macos-latest@@ -145,6 +149,8 @@ jobs:run: npm run build:mac -- --${{ matrix.arch }} --publish alwaysenv:GH_TOKEN: ${{ secrets.GH_TOKEN }}+ VITE_NEON_AUTH_URL: ${{ vars.VITE_NEON_AUTH_URL }}+ VITE_OPENWHISPR_API_URL: ${{ vars.VITE_OPENWHISPR_API_URL }}CSC_IDENTITY_AUTO_DISCOVERY: trueCSC_KEY_PASSWORD: ${{ secrets.APPLE_CERTIFICATE_PASSWORD }}APPLE_API_KEY_ID: ${{ secrets.APPLE_API_KEY_ID }}diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 02c9d48a4..906604805 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -7,22 +7,41 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0## [Unreleased]+## [1.4.0] - 2026-02-06+### Added-- **Cancel Processing Button**: Added ability to cancel ongoing transcription processing-- **Dark Mode Icon Inversion**: Monochrome provider icons now automatically invert in dark mode for better visibility+- **OpenWhispr Cloud**: Cloud-native transcription service — sign in and transcribe without managing API keys+ - Google OAuth and email/password authentication via Neon Auth+ - Email verification flow with polling and resend support+ - Password reset via email magic links+- **Subscription & Billing**: Free and Pro plans with Stripe-powered payments+ - Free plan with rolling weekly word limits (2,000 words/week)+ - Pro plan with unlimited transcriptions+ - 7-day free trial for new accounts with countdown display+ - In-app upgrade prompts when approaching or reaching usage limits+ - Stripe billing portal access for Pro subscribers+- **Usage Tracking**: Real-time usage display with progress bar, color-coded thresholds, and next billing date+- **Account Section in Settings**: Profile display, plan status badge, usage bar, billing management, and sign out+- **Upgrade Prompt Dialog**: When usage limit is reached, offers three paths — upgrade to Pro, bring your own key, or switch to local+- **Cancel Processing Button**: Cancel ongoing transcription processing mid-flight- **Dynamic Window Resizing**: Window automatically resizes based on command menu and toast visibility+- **Dark Mode Icon Inversion**: Monochrome provider icons now automatically invert in dark mode for better visibility### Changed+- **Onboarding Redesign**: Auth-first onboarding flow+ - Signed-in users get a streamlined 3-step flow (Welcome → Setup → Activation)+ - Non-signed-in users get a 4-step flow with transcription mode selection+ - Permissions merged into Setup step for signed-in users+- **Transcription Mode Architecture**: Unified mode selection across OpenWhispr Cloud, Bring Your Own Key (BYOK), and Local+ - Signed-in users default to OpenWhispr Cloud+ - Non-signed-in users choose between BYOK and Local- **Design System Overhaul**: Complete refactor of styling to use design tokens throughout the codebase- Button component now uses `text-foreground`, `bg-muted`, `border-border` instead of hardcoded hex values- Removed hardcoded classes and inline styles across components- Improved button and badge consistency- **Settings UI Redesign**: Overhauled all settings pages with unified panel system, redesigned sidebar, and extracted permissions section- **Dark Mode Polish**: Premium button styling, glass morphism toasts, and streamlined visuals-- **Onboarding Improvements**:- - Streamlined to 4-step flow- - Extended to support multiple local transcription providers (Whisper and NVIDIA Parakeet)- - Improved contrast and design system usage+- **App Channel Isolation**: Development, staging, and production channels now use isolated user data directories### Fixed- **Light Mode UI Visibility**: Fixed multiple UI elements that were invisible or hard to see in light mode:@@ -35,6 +54,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0- **Local Reasoning Model Persistence**: Fixed local reasoning model selection not persisting correctly- **Parakeet Model Status**: Added dedicated IPC channel for Parakeet model status checks- **Groq Qwen3 Models**: Removed thinking tokens from Qwen3 models on Groq provider+- **OAuth Session Grace Period**: Automatic session refresh with exponential backoff retry during initial OAuth establishment## [1.3.3] - 2026-01-28diff --git a/README.md b/README.mdindex 9372d12d7..87e28ccc8 100644--- a/README.md+++ b/README.md@@ -12,6 +12,9 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file## Features+- ☁️ **OpenWhispr Cloud**: Sign in and transcribe instantly — no API keys needed, with free and Pro plans+- 🔐 **Account System**: Google OAuth and email/password sign-in with email verification+- 💳 **Subscription Management**: Free tier (2,000 words/week), Pro tier (unlimited), 7-day free trial- 🎤 **Global Hotkey**: Customizable hotkey to start/stop dictation from anywhere (default: backtick `)- 🤖 **Multi-Provider AI Processing**: Choose between OpenAI, Anthropic Claude, Google Gemini, or local models- 🎯 **Agent Naming**: Personalize your AI assistant with a custom name for natural interactions@@ -254,8 +257,9 @@ npm run build:linux # Linux### First Time Setup1. **Choose Processing Method**:- - **Local Processing**: Download Whisper models for completely private transcription- - **Cloud Processing**: Use OpenAI's API for faster transcription (requires API key)+ - **OpenWhispr Cloud**: Sign in for instant cloud transcription with free and Pro plans+ - **Bring Your Own Key**: Use your own OpenAI/Groq/AssemblyAI API keys+ - **Local Processing**: Download Whisper or Parakeet models for completely private transcription2. **Grant Permissions**:- **Microphone Access**: Required for voice recording@@ -328,14 +332,17 @@ Improve transcription accuracy for specific words, names, or technical terms:- Domain-specific terms (e.g., "amortization", "polymerase")### Processing Options+- **OpenWhispr Cloud**:+ - Sign in with Google or email — no API keys needed+ - Free plan: 2,000 words/week with 7-day Pro trial for new accounts+ - Pro plan: unlimited transcriptions+- **Bring Your Own Key (BYOK)**:+ - Use your own API keys from OpenAI, Groq, AssemblyAI, or custom endpoints+ - Full control over provider and model selection- **Local Processing**:- - Install Whisper automatically through the Control Panel+ - Install Whisper or NVIDIA Parakeet through the Control Panel- Download models: tiny (fastest), base (recommended), small, medium, large (best quality)- Complete privacy - audio never leaves your device-- **Cloud Processing**:- - Requires OpenAI API key- - Faster processing- - Uses OpenAI's Whisper API## Project Structure@@ -595,7 +602,7 @@ OpenWhispr is designed with privacy and security in mind:## FAQ**Q: Is OpenWhispr really free?**-A: Yes! OpenWhispr is open source and free to use. You only pay for OpenAI API usage if you choose cloud processing.+A: Yes! OpenWhispr is open source and free to use. The free plan includes 2,000 words/week of cloud transcription, and local processing is completely free with no limits. Pro plan ($9/month) offers unlimited cloud transcription.**Q: Which processing method should I use?**A: Use local processing for privacy and offline use. Use cloud processing for speed and convenience.@@ -614,10 +621,12 @@ A: OpenWhispr supports 58 languages including English, Spanish, French, German,## Project Status-OpenWhispr is actively maintained and ready for production use. Current version: 1.3.3+OpenWhispr is actively maintained and ready for production use. Current version: 1.4.0- ✅ Core functionality complete- ✅ Cross-platform support (macOS, Windows, Linux)+- ✅ OpenWhispr Cloud with account system and usage tracking+- ✅ Free and Pro plans with Stripe billing- ✅ Local and cloud processing- ✅ Multi-provider AI (OpenAI, Anthropic, Gemini, Groq, Local)- ✅ Compound hotkey support