FixesMac6 min read
MacWhisper crashing or freezing on Mac: what to check
MacWhisper crash or freeze? Update the app, confirm the edition, try a smaller model, check free RAM and disk, and read the crash report in Console.
Published by Optimal Apps, the maker of Petal.
On this page
If you see a MacWhisper crash or a freeze, there is no single known cause, so work through safe checks in order. Update MacWhisper to the latest version, confirm which edition you have, try a smaller model, check free memory and disk space, and read the crash report in Console. MacWhisper's release notes list many crash fixes, so the update is the most useful first step. After a crash on an Apple silicon Mac, also check that MacWhisper did not move into a slower compatibility mode.
This guide does not guess at root causes. It gives the checks that narrow down the problem, and what to send to MacWhisper support if they do not fix it.
Quick-fix checklist
| Symptom | First check | Why |
|---|---|---|
| Crashes after a macOS update | Update MacWhisper | New macOS versions often need app fixes |
| Crashes on long or large files | Try a smaller model | Large models need more memory |
| Freezes on transcription | Check memory in Activity Monitor | Memory pressure makes the Mac swap and stall |
| Fails on save or export | Check free disk space | Models, audio, and exports need room |
| Slow after an earlier crash | Settings > Advanced > WhisperKit | Compatibility mode can be on |
| Finishes without any text | Settings > Advanced > Downmix to Mono | Some files decode wrongly |
| MacWhisper not opening at all | Reinstall, then read Console | A damaged install or a launch crash |
Step 1: Update MacWhisper
- Open MacWhisper and check for updates from the app menu.
- If the app does not open, download the latest version from macwhisper.com (website edition) or update Whisper Transcription in the App Store app (App Store edition).
- Restart the Mac after the update.
Why it works: MacWhisper's release notes include many crash fixes, for example for specific macOS versions and for some model and voice-detection settings. If your crash is a known bug, the update fixes it without other steps.
Step 2: Confirm your edition
MacWhisper comes in two editions: MacWhisper from macwhisper.com and Whisper Transcription from the Mac App Store. They share core features but differ in others. For example, dictation exists only in the website edition.
Note the edition and its version number in About. Support needs both, and the two editions get updates at different times. If you have a dictation problem rather than a crash, read MacWhisper dictation not working.
Step 3: Try a smaller model
Local speech models load into memory. A large model on a Mac with little memory can make the app slow, freeze, or quit.
- Open MacWhisper's model settings.
- Pick a smaller model than the one you use now.
- Transcribe the same file again.
If the smaller model works, the large model was too much for this Mac or for this file. You can keep the smaller model, or close other apps before you use the large one.
On Intel Macs, MacWhisper's docs say on-device transcription is much slower, because those Macs have no dedicated machine learning hardware. MacWhisper suggests a cloud transcription provider there.
Step 4: Check memory and disk space
Memory
- Open Activity Monitor from Applications > Utilities.
- Click the Memory tab.
- Start a transcription in MacWhisper and watch the Memory Pressure graph at the bottom.
If the graph turns yellow or red, the Mac is short on memory. Quit browsers with many tabs, virtual machines, and other heavy apps, then try again.
Disk
- Open System Settings > General > Storage.
- Check the free space.
Models, imported audio, and exports all need room. If the disk is almost full, macOS can stop apps from saving files, and the app can fail in odd ways. Free some space and try again.
Step 5: Check for compatibility mode
MacWhisper's docs explain that on M-series Macs, slow transcription can mean that MacWhisper crashed earlier and moved to a compatibility mode. The docs say this is most common on M1 Macs.
- Open MacWhisper Settings > Advanced > WhisperKit.
- Make sure Disable all GPU usage is off.
- Transcribe a short file to test the speed.
If the app crashes again with the GPU on, note it for support, because that is useful detail.
Step 6: Check the audio file
A damaged or unusual file can cause problems in any transcription app.
- Try a different file, such as a short Voice Memos recording.
- If only one file fails, convert it. For example, open it in QuickTime Player and choose File > Export As > Audio Only, then transcribe the exported file.
- If MacWhisper finishes with no text, MacWhisper's docs say the file is usually too short or was decoded wrongly. Open Settings > Advanced and turn Downmix to Mono on or off, then try again.
Step 7: Read the MacWhisper crash report in Console
If MacWhisper quits, macOS saves a crash report.
- Open Console from Applications > Utilities.
- Select Crash Reports in the sidebar.
- Find the entry with MacWhisper (or Whisper Transcription) in the name, and the time of the crash.
- Select it and copy the text, or choose Reveal in Finder to get the file.
You do not need to read the whole report. Send it to support. If you look at it, the first lines show the app version and macOS version, and the "Exception Type" line shows the kind of crash.
Step 8: Fix MacWhisper not opening
If MacWhisper does not open at all:
- Restart the Mac.
- Delete the app from Applications and install a fresh copy from the same source (macwhisper.com or the App Store).
- If macOS shows a security message, open System Settings > Privacy & Security and look for an Open Anyway button for MacWhisper.
- If it still does not open, check Console for a crash report at launch (Step 7).
Do not delete MacWhisper's data folders unless support asks you to. They can hold your models, settings, and transcripts.
Step 9: Contact MacWhisper support
Email support@macwhisper.com with:
- The edition (MacWhisper or Whisper Transcription) and its version
- Your Mac model, memory size, and macOS version
- The model you used and the length of the file
- The crash report from Console
Petal for file transcription with a fixed RAM budget
If you mostly need to transcribe a file or dictate into apps, and you want to compare another tool, Petal for Mac is a free, open-source app from Optimal Apps, the publisher of this site.
- File transcription from the menu bar. Click the Petal icon and choose Transcribe Audio File…, or drop an audio file onto the menu bar window. Petal copies the transcript when it is done, and saves it in History.
- A RAM budget for the default model. Petal's rule is to keep the RAM need of a default model under 8 GB, so the default setup does not need a top-tier Mac.
- Model sizes up front. Settings > Models shows each model's size before the download, such as Whisper Large V3 Turbo at about 1.1 GB or Qwen3 ASR 1.7B at about 2.5 GB. Parakeet 110M is the recommended light English model.
- Transcribe Again. If a result is poor, the History card can run the saved audio again with another model.
- On device. Speech recognition runs on your Mac. Cleanup with Petal W1 also runs on your Mac.
Petal needs macOS 26.2 or later. For more on file workflows, read Transcribe an audio file on Mac. To compare Whisper-based apps, read Whisper app for Mac or Petal vs MacWhisper.
Summary
- Update MacWhisper first, because many crashes are fixed in new versions.
- Note the edition and version.
- Try a smaller model, and check memory pressure and free disk space.
- Turn off Disable all GPU usage if MacWhisper moved to compatibility mode.
- Test with a different or converted audio file.
- Send the Console crash report to MacWhisper support.
Questions
Why does MacWhisper keep crashing?
There is no single cause. Common factors in any local transcription app are an old app version, a model too large for the Mac's memory, a full disk, or a damaged audio file. Update first, then try a smaller model and check free memory and storage.
Why is MacWhisper slow after a crash?
MacWhisper's docs say that after a crash on an M-series Mac, the app can move to a compatibility mode, which is slower. Open Settings > Advanced > WhisperKit and make sure Disable all GPU usage is off.
Where do I find the MacWhisper crash report?
Open Console from Applications > Utilities, select Crash Reports in the sidebar, and look for an entry with MacWhisper in the name. Send it to support@macwhisper.com with your Mac model and macOS version.
Why did MacWhisper finish without any text?
MacWhisper's docs say this usually means the file is too short or was decoded wrongly. Turn Downmix to Mono on or off in Settings > Advanced and transcribe again.