Skip to content

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

chore: doc update + worfklow var injection

Gabriel Steindc6e6c7fc2c6
diff --git a/.github/workflows/build-and-notarize.yml b/.github/workflows/build-and-notarize.yml
index 0467140a8..720d6486d 100644
--- a/.github/workflows/build-and-notarize.yml
+++ b/.github/workflows/build-and-notarize.yml
@@ -41,6 +41,9 @@ jobs:
- name: Build Application
run: 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 Artifacts
uses: actions/upload-artifact@v4
@@ -84,6 +87,8 @@ jobs:
run: npm run build:win -- --publish never
env:
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 Artifacts
uses: actions/upload-artifact@v4
@@ -151,6 +156,8 @@ jobs:
run: npm run build:mac -- --${{ matrix.arch }} --publish never
env:
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.yml
index 6df1aadd6..c786e26d2 100644
--- a/.github/workflows/release.yml
+++ b/.github/workflows/release.yml
@@ -50,6 +50,8 @@ jobs:
run: npm run build:linux -- --publish always
env:
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 always
env:
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 always
env:
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: true
CSC_KEY_PASSWORD: ${{ secrets.APPLE_CERTIFICATE_PASSWORD }}
APPLE_API_KEY_ID: ${{ secrets.APPLE_API_KEY_ID }}
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 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-28
diff --git a/README.md b/README.md
index 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 Setup
1. **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 transcription
2. **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