Installation
Install the stable macOS 1.6 release.
System Requirements
- • macOS 14.0 (Sonoma) or later
- • Apple Silicon recommended, Intel supported
- • 8 GB RAM minimum, 16 GB+ recommended
- • Apple Translate features require macOS 15+
- • Apple Intelligence and SpeechAnalyzer require macOS 26+
Download
Download the latest stable DMG from typewhisper-mac releases or install via Homebrew below.
Release candidates and daily builds stay on preview channels and do not flow through Homebrew. For most users, the latest stable release is the right choice.
Homebrew
brew install --cask typewhisperFirst Launch
TypeWhisper appears as an icon in the menu bar. Open Settings to download your first model, configure your hotkey, and grant Microphone plus Accessibility access. Once that is done, you can complete your first dictation immediately.
Upgrade from an earlier version
macOS 1.6
TypeWhisper 1.6 adds faster and more resilient capture, Backup & Restore, calendar-aware meeting recording, live transcript updates, improved Whisper Mode, and expanded integrations and automation.
What's new in 1.6
- Faster recording startup, microphone priorities, and improved recovery for built-in, AirPods, Bluetooth, and virtual inputs.
- Optional calendar-aware meeting recording with notifications, automatic Recorder sessions, and event metadata sidecars.
- Backup & Restore, privacy-friendly Statistics, and a redesigned Settings experience.
- Live transcript updates, improved Whisper Mode, Obsidian live sync, MCP Client actions, bulk plugin updates, and expanded OpenAI-Compatible profiles.
Before upgrading
When upgrading from 1.5.1, back up important data before replacing the app. After the first launch, confirm Microphone and Accessibility permissions and run a short test dictation before returning to your normal workflow.
iCloud sync limitation
Automatic private iCloud sync remains unavailable in 1.6. Cloud Folder Sync remains available with iCloud Drive, Dropbox, OneDrive, Syncthing, or a custom folder.
Build from Source
git clone https://github.com/TypeWhisper/typewhisper-mac.git
cd typewhisper-mac
# Requires Xcode 16+
open TypeWhisper.xcodeprojUninstall
If you want to remove TypeWhisper completely on macOS and reinstall from a clean slate, deleting the app alone is often not enough. Official release builds also store local state, widget data, and secrets in ~/Library and Keychain.
# Optional if installed via Homebrew
brew uninstall --cask typewhisper
After that, quit TypeWhisper and remove the following paths:
rm -rf /Applications/TypeWhisper.app
rm -rf "$HOME/Library/Application Support/TypeWhisper"
rm -f "$HOME/Library/Preferences/com.typewhisper.mac.plist"
rm -rf "$HOME/Library/Group Containers/2D8ALY3LCL.com.typewhisper.mac"
rm -f /usr/local/bin/typewhisper
rm -rf "$HOME/Documents/TypeWhisper Recordings"- • The CLI path only matters if you installed the tool from Settings > Advanced > CLI Tool.
- • The Documents folder is optional and only affects exported recordings or files you also want to remove.
- • Also open macOS Keychain Access, search for `com.typewhisper.mac.apikey`, and remove matching entries, including license items under `com.typewhisper.mac.apikey.license`.
- • If `~/Library` is hidden in Finder, use Finder > Go > Go to Folder and paste the path you need.
- • Restart your Mac after cleanup, then install the latest version again.