Skip to main content
WhisprDesk

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:
    1. Open the WhisprDesk app: click its icon in the Dock (or open it from your Applications folder).
    2. Click the gear button at the top right of the window to open Settings.
    3. Click Privacy & Data.
    4. 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.

  1. Open your Mac's System Settings and click Keyboard.
  2. 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:

  1. Open the WhisprDesk app: click its icon in the Dock (or open it from your Applications folder).
  2. Click the gear button at the top right of the window to open Settings, then click Preferences.
  3. 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

  1. Open the WhisprDesk app: click its icon in the Dock (or open it from your Applications folder).
  2. Click the Models tab at the top of the window, then click Speech to text.
  3. 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.
  4. Click the gear button at the top right to open Settings, click Privacy & Data, and check that Microphone is granted under Permissions.
  5. 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:

  1. Open the WhisprDesk app: click its icon in the Dock (or open it from your Applications folder).
  2. Click the Models tab at the top of the window, then click Speech to text.
  3. 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

  1. Open the WhisprDesk app: click its icon in the Dock (or open it from your Applications folder).
  2. Click the gear button at the top right of the window to open Settings, then click Preferences.
  3. Under Language, change Transcription language from Auto-detect to the language you speak.
  4. 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).

  1. Open your Mac's System Settings and click Privacy & Security.
  2. Click Screen Recording and turn on WhisprDesk.
  3. 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

  1. Open the WhisprDesk app: click its icon in the Dock (or open it from your Applications folder).
  2. Click the gear button at the top right of the window to open Settings.
  3. Click System and scroll to Debug Logging.
  4. Turn on Debug mode. It stays on after a restart until you turn it off.
  5. Reproduce the problem.
  6. 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.
  7. Attach the most recent log file to your email to support.
  8. 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

  1. Open the WhisprDesk app: click its icon in the Dock (or open it from your Applications folder).
  2. Click the ? button at the top right of the window.
  3. 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.