Common Issues

Solutions to frequent problems

Transcription Not Working

  • Check microphone permission is granted
  • Verify correct microphone is selected
  • Test microphone in Settings
  • Check transcription engine is configured

Hotkeys Not Responding

  • Ensure Speakly is running (check menu bar)
  • Verify accessibility permission on macOS
  • Check hotkey isn't conflicting with other apps
  • Try resetting hotkeys in Settings

Poor Transcription Quality

  • Speak clearly and at consistent volume
  • Reduce background noise
  • Try a larger model (e.g., medium instead of small)
  • Add technical terms to Dictionary
Documentation - Speakly