​
Introduction

Superwhisper is designed to be reliable, but various factors can occasionally affect its performance. This documentation section is designed to help you diagnose and resolve common issues you might encounter.

For your peace of mind, the application automatically saves your dictations every few seconds. You can access your original recordings through the History tab or directly in the Superwhisper folder.

It is suggested you activate error logging in the Configuration tab. This helps diagnose issues through the application’s built-in error tracking system.

​
General Troubleshooting

Recording Window Issues

If the recording window doesn’t appear after pressing the keyboard shortcut, there might be a conflict in your shortcut settings. Check or modify your keyboard shortcuts configuration to fix this issue.

Audio Capture Issues

If the wave visualization in the interface isn’t moving, this typically indicates an audio capture problem. Learn more about these settings.

Transcription & AI Processing Issues

If you’re experiencing issues with your transcription results or AI processing, check this detailed guide to identify the origin of the issue and possible solutions.

​
Common Issues and Solutions

Automatic Language Detection

If your language isn’t being correctly detected or if automatic detection defaults to English, check this guide for solutions.

How to Downgrade

If you need to downgrade due to issues with the current version, here you can find links to previous Superwhisper versions.

Performance Issues

If Superwhisper feels slow or unresponsive, check this guide for optimization tips to improve application speed and efficiency.

Realtime Transcription

Real-time transcription is currently available only with Ultra Cloud Models. Learn how to enable and configure this feature.

Custom Modes Not Saving

If your custom modes aren’t saving or disappear unexpectedly, it may be related to iCloud sync issues. This guide offers solutions.

AI Answers Instead of Transcribing

If you’re getting AI responses when you only want formatted transcription, check these prompting tips.

Long Files Not Transcribing

If you’re using Ultra Cloud for longer files and experiencing issues, Nova is the recommended voice model for longer content. Learn more about the available AI models.

Activation Problems

Having trouble activating your App Store purchase? This guide walks you through how to recover your license.

Context Issues

If context awareness isn’t working correctly or you want to learn more about it, check this guide.

Recording System Audio

This custom mode-specific feature allows you to record audio as you listen. Learn more about it.

Deactivating AI in Custom Modes

Custom modes offer flexibility not available in other modes. Learn how to deactivate AI processing by editing JSON files directly.

Report Issues

If you encounter reproducible bugs or issues, please submit them through our reporting system for faster resolution.