Changelog

Bug Fixes

• Sparkle update detection with full git history, bump to 0.13.4

What's New

CloudflareASR Plugin

Community contribution by @yunluyl - new transcription plugin for OpenAI-compatible ASR servers behind Cloudflare tunnels.

• Supports CF-Access service token authentication and optional Bearer token
• Qwen3-ASR output parsing (<asr_text> tags)
• Model fetching and manual model selection

Audio Engine Resilience

• Recording now automatically recovers when macOS interrupts the audio engine (e.g. notification sounds, Bluetooth device changes)
• Previously buffered audio is preserved during engine restart

Menu Bar Fix

• Windows opened from the menu bar (Settings, History) now properly appear in front instead of behind other windows

Based in part on PR #88 by @yunluyl

What's New

• History Audio Playback: Optionally save and replay audio recordings from transcription history

Bug Fixes

• Cloud Transcription Reliability: Fixed cloud API requests (Groq, OpenAI, Deepgram, etc.) hanging after sleep/wake or network changes. All plugins now use ephemeral HTTP sessions with 30s timeouts instead of persistent connections that go stale
• Indicator Preview: Fixed color scheme not applying correctly in IndicatorPreviewView (#86)
• MLX Plugins: Fixed Qwen3 and Voxtral plugins failing to load on macOS 15 due to missing Swift compatibility libraries
• Plugin CI: All plugins now build with Xcode 26.2 for consistent package resolution

What's New in v0.4.1

Welcome Wizard Redesign

• Dark theme — Migrated to FluentWindow with Mica backdrop, matching the rest of the app. Previously rendered with invisible text on a white background
• Plugin-based setup — Step 1 now dynamically lists all available marketplace extensions with install/installed status and shows transcription models from installed engines. No more hardcoded model selection
• Streamlined flow — Reduced from 5 steps to 4: Extensions & Model → Microphone → Hotkeys → Done. The obsolete "Cloud Providers" step has been removed (now handled by the plugin system)
• Re-run anytime — Added "Open Wizard" shortcut on the Dashboard to re-run the setup at any time

Bug Fixes

• Fixed all Welcome Window elements being invisible on the dark theme (#3)

New Features

• Support modifier-combo hotkeys like CMD+OPT, Fn+CMD, etc. (#81)
• Expose selected text to post-processing plugins (#83)

Bug Fixes

• Fix Sparkle update detection not finding new versions (#85)
• Fix hidden history records staying selected when collapsing groups (#80)
• Fix missing plugins in registry and auto-register new plugins
• Fix plugin CI building with wrong Xcode version (#82)

What's New in v0.4.0

This is a major feature release bringing full feature parity with the Mac version.

Post-Processing Pipeline

• Refactored text processing into a priority-based pipeline architecture
• Plugin post-processors can now hook into the processing chain with custom priorities
• Action plugins (Linear, Obsidian) can receive processed text instead of inserting it

HTTP API (7 new endpoints)

• GET /v1/history — Search history with pagination
• DELETE /v1/history — Delete history entries
• GET /v1/profiles — List all profiles
• PUT /v1/profiles/toggle — Toggle profile on/off
• POST /v1/dictation/start / stop — Remote recording control
• GET /v1/dictation/status — Check recording state
• Extended /v1/status with streaming and translation capabilities

Model Auto-Unload

• Models are now automatically unloaded after a configurable idle timeout
• Saves memory when TypeWhisper is running but not actively used
• Configurable via ModelAutoUnloadSeconds setting (0 = disabled)

History Export

• Added Markdown (.md) and JSON (.json) export formats
• Export dialog now supports 4 formats: Text, CSV, Markdown, JSON

New Plugins (available in Marketplace)

• Google Gemini — LLM provider supporting Gemini 2.5 Flash, Pro, and Flash Lite
• Linear — Create Linear issues directly from transcriptions via GraphQL API
• Obsidian — Save transcriptions as Markdown notes in Obsidian vaults with YAML frontmatter
• Script Runner — Pipe transcriptions through custom shell scripts (cmd/PowerShell)
• Live Transcript — Floating semi-transparent window showing real-time transcription

Per-Profile Hotkeys

• Each profile can now have a dedicated hotkey for instant activation
• Bypasses automatic app/URL matching — press the hotkey to dictate with that specific profile
• Configure via the new hotkey recorder in the profile detail panel

Audio Device Preview

• Real-time microphone level meter in audio settings
• Visual feedback when selecting or testing microphone devices
• Preview automatically starts/stops when navigating to/from the Recording section

Database

• Schema upgraded to v6 with new columns for action plugin routing, profile hotkeys, and model tracking

New Plugins

• LiveTranscriptPlugin - Real-time live transcript overlay during recording (#77)

New Features

• Redesigned Home Dashboard as Bento Grid layout (#78)

Bug Fixes

• Fix iPhone Continuity mic causing recording to immediately stop (#76)
• Fix memory corruption crash in audio level update pipeline
• Fix WhisperKit auto-detect language detection (#75)
• Show guidance when no LLM provider plugins are installed

Updates

• WhisperKitPlugin 1.0.14

New Plugins

• ScriptPlugin - Post-process transcribed text via shell commands (e.g. tr, sed, custom scripts)
• ObsidianPlugin - Auto-export transcriptions to Obsidian vaults with daily notes support
• DeepgramPlugin - Real-time WebSocket streaming transcription via Deepgram
• AssemblyAIPlugin - WebSocket v3 streaming transcription via AssemblyAI

New Features

• Overlay indicator system with customizable styles and position presets
• Static indicator preview and style picker in General Settings
• Configurable notch display for multi-monitor setups (#65)
• Dynamic app group identifier for codesigning (PR #73)
• DEVELOPMENT_TEAM xcconfig for easier contributor setup (#67)

Bug Fixes

• Fix crash on macOS 26 when starting recording - EXC_BAD_ACCESS in StreamingHandler (PR #74)
• Fix crash when saving history records after ScriptPlugin processing
• Fix API key persistence in cloud plugins (#72)
• Fix Prompt Palette text selection and replacement in Electron apps (#70)
• Fix auto-install of plugins - users now choose in setup wizard (#66)
• Fix mic preview not restarting when switching devices in setup wizard (#63)
• Fix MACOSX_DEPLOYMENT_TARGET for all plugin targets (#64)
• Fix CODE_SIGN_IDENTITY overrides for automatic signing (#67)

What's New

Auto-Unload Models

• Configurable auto-unload - Local transcription models can now be automatically unloaded from memory after a configurable inactivity period. Choose from Immediate, 2/5/10/30/60 minutes, or Never.
• Automatic reload - When you start dictating after a model was auto-unloaded, it reloads automatically - no manual intervention needed.
• RAM savings - Frees up gigabytes of RAM when you're not actively transcribing, especially useful on 8 GB machines.

Settings: Recording > Engine > Auto-unload model

Fixes

• Bundled plugins - Fixed bundled plugins not being auto-enabled on first launch.

What's New

Instant Results with Streaming

When using Deepgram or AssemblyAI with live transcription enabled, the streaming result is now used as the final transcription. Previously, the app would discard the live result and run a redundant batch transcription after recording stopped — adding unnecessary delay. Now results appear instantly when you stop recording.

AssemblyAI Streaming Fixes

• Live transcription now works — fixed audio chunk sizing (AssemblyAI requires ≥50ms chunks)
• Multilingual support — automatically uses the multilingual streaming model for non-English languages
• No more duplicated text — fixed finality detection for the v3 streaming API

Bug Fix

• Fixed missing space in text stabilization when the transcription engine diverges mid-word

What's New

VoxtralPlugin

• Local Voxtral Mini 4B - New speech-to-text plugin for local transcription using Voxtral Mini 4B.

Setup Wizard

• Embedded Marketplace - Plugin marketplace is now embedded directly in Setup Wizard Step 2 with default engine and LLM pickers.

Homebrew

• Homebrew Tap support - Install TypeWhisper via brew install typewhisper/tap/typewhisper.

Fixes

• Control+Space hotkey - Fixed hotkey recorder not capturing modifier+key combinations like Control+Space.
• Processing spinner - Show a spinner in the notch indicator during transcription processing.
• Microphone permission - Auto-open Settings when microphone permission is missing.

What's New

Widgets

• Home Screen Widgets - 4 new WidgetKit widgets: Stats (small), Last Transcription (small), Activity Chart (medium), and History (large). Add them to your desktop for quick dictation insights.

Simulated Streaming

• Streaming for all engines - Non-streaming engines (Parakeet, Qwen3, cloud engines) now show simulated streaming text output, giving visual feedback while transcription completes.

macOS 14 Support

• macOS Sonoma compatibility - Deployment target lowered to macOS 14. All plugins now load on Sonoma as well.

Maintenance release v0.12.4

Other Changes

• Add UI localization with English default and German support

Maintenance release v0.12.1

Performance

• History section: Opens instantly — async cache loading off the UI thread and real UI virtualization (ListBox) replace the previous synchronous load that froze the UI
• Dashboard: No longer blocks app startup — history data loads asynchronously in the background
• Stats caching: TotalRecords/Words/Duration are cached and updated incrementally instead of recalculated via LINQ on every access

Other Changes

• Fix SupportedLanguages DIM test by enabling CallBase on mock
• Refresh profile transcription model list on plugin state changes
• Improve OpenAI Compatible plugin connection UX and remove inline styles
• Migrate all settings sections to WPF-UI controls
• Migrate PluginsSection to WPF-UI with CardExpander and fix expand state
• Add WPF-UI Fluent Design and migrate SettingsWindow to FluentWindow
• Add OpenAI Compatible plugin for local LLM servers
• Extract local models into SherpaOnnx plugin and unify Models UI
• Refresh plugin and model lists live after marketplace install/uninstall
• Add plugin system parity: IActionPlugin, streaming, marketplace, and localization
• Add prompt palette for AI-powered text processing via hotkey

What's New

Plugin Marketplace

Browse, install, update, and uninstall plugins directly from Settings > Integrations. Plugins are downloaded from GitHub Releases with progress feedback. Available/Installed tabs, update badges, and "Install from File" for local bundles.

Qwen3 ASR Engine

New local transcription engine powered by MLX on Apple Silicon. 30 languages, no API key required. Available as a plugin from the marketplace.

All Engines are Plugins

WhisperKit, Parakeet, SpeechAnalyzer, Groq, and OpenAI transcription engines have been migrated to the plugin system. The Models tab has been removed - each engine now manages its models in its own settings within the Integrations tab.

Hide Menu Bar Icon

New option in Settings > General > Appearance to hide the menu bar icon. When hidden, a Dock icon appears and the settings window opens on launch.

Plugin Localization

Plugins now support localized names and descriptions. German translations included for all bundled plugins and marketplace listings.

Improvements

• Engine and model picker moved to Recording settings for easier access
• History view redesigned with wider settings window and cached computed properties
• Plugins report supported languages for better profile matching
• Model download progress shown immediately for all engines
• Plugin auto-restores its model on app launch
• Settings window forwards plugin state changes for live UI updates

Fixes

• WhisperKit model download progress polling
• Prevent re-installing plugins after user uninstalls them
• SpeechAnalyzer settings view loads models on appear
• Plugin deactivation falls back to first ready engine
• WhisperKitConfig downloadBase set correctly to prevent Documents permission prompt

Simplification Release

This release focuses on removing complexity and cleaning up features that didn't carry their weight.

Removed

• Whisper mode (microphone gain boost) - removed for simplicity
• Silence detection - never worked reliably enough to ship
• Default prompt setting - unused, prompts are better managed per-profile
• Auto-submit in profiles - removed to reduce profile complexity
• Notch indicator extras - clock and battery removed, blue audio glow removed
• Preset labels from prompt actions list
• Dead code - toast overlay, hotkey migration, unused settings

Improved

• Settings reorganized - "Dictation" tab renamed to "Recording", audio sections regrouped
• Hotkey settings - more compact layout
• DictationViewModel - refactored with shared helpers, DRY event processing
• README - updated to reflect current feature set

Maintenance release v0.10.1

New Features

• Dynamic Island overlay: Configurable floating overlay with widgets (profile, model, audio level) and multi-monitor support
• Dictionary page redesign: Search bar with filtering, rich empty states with icons, segmented type selector, colored accent stripes on entry cards, polished add form and edit overlay

Improvements

• Profile widget: Show "Kein Profil" placeholder when no profile is active
• Profile settings: Hide detail panel when no profile is selected

What's New

History Overhaul

• Standalone History window - Access history directly from the tray menu, independent of Settings
• Timeline grouping - Entries grouped by Today, Yesterday, Last 7 Days, etc.
• Filters - Filter by app and time range with native picker controls
• Bulk delete - Multi-select entries and delete via context menu
• "Delete All Visible" - Delete all entries matching current filters at once
• Auto-retention - Configure automatic cleanup (keep last 30/90/180/365 days) in Settings > Advanced
• Multi-select export - Export multiple entries as Markdown, Plain Text, or JSON

Profiles

• Per-profile hotkeys - Assign dedicated hotkeys to individual profiles
• Auto-submit option - Automatically submit text in chat apps (press Enter after insertion)

API & Integration

• HTTP API endpoints for history and profiles (#30)

Improvements

• Separate Dev and Production builds with different bundle IDs and data directories
• Disable streaming preview when cloud engine is selected
• Fix translation language normalization
• Windows no longer force-float above other apps

What's New

HTTP API for External Integrations

TypeWhisper now exposes a comprehensive HTTP API for controlling the app from external tools like Raycast, Alfred, or custom scripts.

New endpoints:

• GET /v1/history - Search and browse transcription history (with q, limit, offset params)
• DELETE /v1/history?id=<uuid> - Delete a history entry
• GET /v1/profiles - List all profiles
• PUT /v1/profiles/toggle?id=<uuid> - Enable/disable a profile
• POST /v1/dictation/start - Start voice recording
• POST /v1/dictation/stop - Stop voice recording
• GET /v1/dictation/status - Check if currently recording

All date fields now use ISO 8601 format. CORS headers support PUT and DELETE methods.

Separate Dev and Production Builds

Debug and Release builds now use different bundle IDs and data directories, so you can run both side-by-side without conflicts:

• Production: com.typewhisper.mac / ~/Library/Application Support/TypeWhisper/
• Development: com.typewhisper.mac.dev / ~/Library/Application Support/TypeWhisper-Dev/

Other

• Updated README with screenshots for all settings tabs
• Added screenshot automation script

What's New

ActionPlugin System

• New ActionPlugin protocol for routing LLM output to custom actions instead of text insertion
• Bundled LinearPlugin: Create Linear issues directly from voice dictation

Bug Fixes

• Fix auto-paste not working in some apps (#29) - Text insertion now works reliably in all apps (VS Code, Notes, etc.) by removing an overly restrictive accessibility check

Bug Fixes

• Fix SmartScreen warnings for plugin DLLs on startup: Remove "Mark of the Web" (Zone.Identifier) from plugin files before loading assemblies. Prevents Windows SmartScreen balloon notifications for built-in plugins (e.g. Groq) after install or update via Velopack.

Bug Fixes

• Fix built-in plugins missing after install/update: OpenAI, Groq, and Webhook plugins are now included in the Velopack installer package. Previously they were only present in build output but not in the publish directory.
• Fix settings lost on updates: Settings persistence is now resilient against corruption with atomic writes, automatic backup before each save, and recovery from backup if the primary file is corrupt.

Bugfixes

Auto-Update: Balloon-Klick funktioniert jetzt

• Klick auf die Tray-Notification "Update verfügbar" startet jetzt direkt den Download und die Installation
• Vorher wurde der Klick ignoriert, obwohl der Text "Klicken Sie hier zum Aktualisieren" anzeigte

Auto-Start: Funktioniert nach Updates zuverlässig

• --minimized Flag wird jetzt korrekt ausgewertet
• Nach Velopack-Updates wird der Auto-Start Registry-Eintrag automatisch mit dem neuen Exe-Pfad aktualisiert
• Onboarding-Fenster wird bei minimiertem Start übersprungen
• Logging in startup.log für einfacheres Debugging

What's New

Multi-Webhook System (Mac-Parität)

• Multiple Webhooks mit individueller Konfiguration (Name, URL, HTTP-Methode)
• Profil-Filter pro Webhook (nur bei bestimmten Profilen auslösen)
• Delivery Log mit den letzten 20 Zustellungen (Erfolg/Fehler)
• Automatischer Retry nach 5 Sekunden bei Fehlern
• Neuer Bearbeitungs-Dialog für Webhook-Konfiguration

Laufende Apps im Profil-Editor

• Apps-Feld zeigt jetzt laufende Anwendungen als klickbare Vorschläge
• Ein Klick fügt die App zum Profil-Filter hinzu
• Liste aktualisiert sich automatisch

SDK

• TranscriptionCompletedEvent enthält jetzt ProfileName

Bug Fixes

• Fix rapid back-to-back dictation hanging the app - When starting a new recording immediately after the previous one finished, the app could become unresponsive. The inserting-state reset timer now gets properly cancelled when a new recording begins.

Cleanup

• Removed unused "Always Paste" option from profiles

What's New in v0.9

Plugin System

TypeWhisper is now extensible through plugins. A new plugin SDK (TypeWhisperPluginSDK) enables developers to build custom integrations:

• Extension points: LLM providers, transcription engines, and post-processors can all be added via plugins
• Typed event bus: Plugins can observe dictation lifecycle events (recording start/stop, transcription complete, text inserted, etc.)
• Host services API: Plugins get scoped keychain access, UserDefaults, data directories, and profile name resolution
• Priority-based post-processing pipeline: Multiple post-processors run in defined order

Cloud Providers are now Plugins

Groq, OpenAI, and Gemini are now bundled as plugins instead of hardcoded providers. This makes them easier to update independently and serves as reference implementations for plugin developers.

• Gemini support - New! Use Google's Gemini models for prompt processing via OpenAI-compatible API
• Dual-purpose plugins - Groq and OpenAI plugins provide both transcription and LLM capabilities
• User-installed plugins in ~/Library/Application Support/TypeWhisper/Plugins/ take priority over built-in ones

Webhook Plugin

A new built-in webhook plugin lets you send transcription results to external services:

• Configurable webhook URLs with per-profile filtering
• Automatic retry logic and delivery log

Bug Fixes

• Fixed media pause launching Apple Music when nothing is playing (#25)
• Fixed WhisperKit model disappearing from picker after first transcription

What's Changed

• Prompt Palette redesigned: Moved from notch overlay to a standalone floating panel for better usability and more screen space
• Project roadmap added: Added a roadmap document outlining planned features and development direction

What's Changed

• Add global default prompt setting (#17)
• Fix audio end being cut off on quick stop
• Move WhisperKit model storage from Documents to Application Support
• Add silence-pause mode for continuous dictation
• Remove unused DictationOverlay files

Other Changes

• Fix Velopack update discovery with per-architecture channels

Other Changes

• Add version display and update check to Info settings section
• Remove unused XAML namespace and explicit DataType from DictionarySection

What's Changed

• Add Custom Prompts feature with LLM text processing by @SeoFood in #18

Other Changes

• Non-blocking transcription pipeline with Channel<T> job queue

Other Changes

• Add cloud transcription providers (Groq, OpenAI) with provider architecture

Other Changes

• Fix release pipeline: apply RID only to publish step
• Build separate release artifacts for win-x64 and win-arm64

What's Changed

• Add project README with features, build instructions, architecture overview, and model recommendations
• Fix welcome wizard: replace outdated Whisper model list with Parakeet TDT 0.6B and Canary 180M Flash

Other Changes

• Add release pipeline with GitHub Actions and Velopack
• Redesign dashboard with activity chart and stats
• Fix dispose guards and missing connection opens
• Add DB migration for tags column and consume trailing punctuation in snippets
• Enhance snippets: tags, clipboard placeholder, import/export, editor dialog
• Add dictionary feature: cards UI, term packs, auto-learning
• Extend sound durations and remove stop sound
• Add sound feedback with NAudio and fix playback order
• Remove Whisper reference from info section
• Add audio ducking and media pause during recording
• Redesign history as timeline with inline-expandable cards
• Add .agents/ and .claude/ to gitignore
• Enhance overlay UI with partial transcription, badges, and timer
• Add live transcription with Silero VAD for real-time partial results
• Refactor hotkeys: support hybrid, toggle-only, and hold-only modes
• Remove Whisper engine, consolidate to Parakeet-only
• Add app icon for tray, taskbar, and exe from Mac icon set
• Add browser URL detection via Windows UI Automation for profile matching
• Initial commit: TypeWhisper Windows with local Opus-MT translation