Troubleshooting and logs
Applies to WhisprDesk 1.9.0 · Updated 2026-11-16
Most WhisprDesk problems come down to a missing permission, a model that is not downloaded yet, or a missing API key. This page covers the common fixes and how to collect a debug log if you need to contact support. Debug logs are written only to your Mac and are never sent anywhere automatically.
Before you start
Open the WhisprDesk app: click its icon in the Dock, or open it from your Applications folder. The WhisprDesk window opens on the Transcripts tab. If WhisprDesk is running but you don't see its window, click the WhisprDesk icon in the menu bar at the top right of your screen and choose Open WhisprDesk. The gear button at the top right of the window opens Settings, and the ? button next to it opens help and support.
Text does not paste into my app
Where: WhisprDesk > Settings > Privacy & Data > Permissions
- Make sure WhisprDesk has the Accessibility permission:
- Open the WhisprDesk app: click its icon in the Dock (or open it from your Applications folder).
- Click the gear button at the top right of the window to open Settings.
- Click Privacy & Data.
- Under Permissions, click Test & Grant next to Accessibility and allow it in System Settings.
- Without Accessibility, the text is still copied. Press Cmd+V to paste it.
- Your dictation is also saved on the Transcripts tab (when Data Retention is on). Open the WhisprDesk app, click the Transcripts tab, hover over the dictation, and click Copy text.
- If permission looks granted but paste still fails, open your Mac's System Settings, click Privacy & Security, then Accessibility, remove WhisprDesk from the list, and add it again. The Reset accessibility permissions button in WhisprDesk takes you to that screen; it does not remove anything itself.
The Globe key opens the emoji picker
Where: your Mac's System Settings > Keyboard, or WhisprDesk > Settings > Preferences > Dictation Hotkey
WhisprDesk shows a note under the hotkey field in Settings > Preferences when this setting is on.
- Open your Mac's System Settings and click Keyboard.
- Set Press 🌐 key to to Do Nothing. On some Macs the setting is named Press fn key to.
Or choose a different hotkey in WhisprDesk:
- Open the WhisprDesk app: click its icon in the Dock (or open it from your Applications folder).
- Click the gear button at the top right of the window to open Settings, then click Preferences.
- Under Dictation Hotkey, click the key field and press a new key.
Nothing happens when I dictate
Where: WhisprDesk > Models > Speech to text, then Settings > Privacy & Data, then Settings > Preferences
- Open the WhisprDesk app: click its icon in the Dock (or open it from your Applications folder).
- Click the Models tab at the top of the window, then click Speech to text.
- Check the banner at the top. If it says No model selected, download a model on the On this Mac tab, or add a key on the Cloud (your key) tab, then click Use this model.
- Click the gear button at the top right to open Settings, click Privacy & Data, and check that Microphone is granted under Permissions.
- If you see No Audio Detected, click Preferences and check your input device, and make sure your microphone is not muted.
Re-transcribe says I need a local model
Where: WhisprDesk > Models > Speech to text > On this Mac
Re-transcribe only uses local models. To download one:
- Open the WhisprDesk app: click its icon in the Dock (or open it from your Applications folder).
- Click the Models tab at the top of the window, then click Speech to text.
- Click the On this Mac tab, choose NVIDIA Parakeet or OpenAI Whisper, and click Download on a model.
More: Audio and transcripts.
Cloud transcription fails
Where: WhisprDesk > Models > Speech to text > Cloud (your key)
- Check that your API key is correct and has credit with the provider: open the WhisprDesk app, click the Models tab, click Speech to text, click Cloud (your key), and check the API Key field for your provider.
- Files sent to a cloud provider from the Transcribe a file tab are limited to 25 MB each. For larger files, use a local model.
- The provider's service status and limits apply.
Text appears in the wrong language or alphabet
Where: WhisprDesk > Settings > Preferences > Language
- Open the WhisprDesk app: click its icon in the Dock (or open it from your Applications folder).
- Click the gear button at the top right of the window to open Settings, then click Preferences.
- Under Language, change Transcription language from Auto-detect to the language you speak.
- Dictate again.
WhisprDesk then tells the model which language to expect (Whisper on this Mac, and OpenAI, Groq, Mistral, and most custom providers in the cloud). If you use NVIDIA Parakeet and speak a language outside its 25 European languages, switch to a Whisper model or a cloud model in Models > Speech to text. See Choosing a transcription engine.
Recording inside a note stops
Where: your Mac's System Settings > Privacy & Security > Screen Recording
Recording into a note needs your OpenAI API key and the Screen Recording permission (shown in WhisprDesk as System Audio).
- Open your Mac's System Settings and click Privacy & Security.
- Click Screen Recording and turn on WhisprDesk.
- Open the WhisprDesk app, click the Notes tab, open the note, and try recording again.
More: Notes.
The local API returns an error
Where: WhisprDesk > Settings > Integrations > External App Gateway
See the error table in Local API. A 500 usually means the Whisper Base model, or Parakeet, is not downloaded.
Collect a debug log
Where: WhisprDesk > Settings > System > Debug Logging
- Open the WhisprDesk app: click its icon in the Dock (or open it from your Applications folder).
- Click the gear button at the top right of the window to open Settings.
- Click System and scroll to Debug Logging.
- Turn on Debug mode. It stays on after a restart until you turn it off.
- Reproduce the problem.
- Go back to Settings > System > Debug Logging and click Show in Finder next to Logs folder. You can also copy the folder path with the copy button.
- Attach the most recent log file to your email to support.
- Turn Debug mode off when you are done, because it writes to disk continuously.
Before you share a log: logs never contain your API keys, but in debug mode they can include text you were typing in other apps. Do not share a debug log that may contain private text. Open the file and check it first if you are unsure.
Contact support
Where: WhisprDesk > ? button at the top right > Contact support
- Open the WhisprDesk app: click its icon in the Dock (or open it from your Applications folder).
- Click the ? button at the top right of the window.
- Click Contact support to email us, or Report a problem to open an email with your app and macOS versions already filled in.
Or email support@whisprdesk.com. Include your macOS version, what you were doing, and a debug log if you can.