Troubleshooting
Common issues and their solutions. If you can't find your answer here, open an issue on GitHub.
Frequently Asked Questions
The hotkey doesn't work
Check if another app is using the same shortcut. On macOS, ensure OpenTypeless has Accessibility permissions (System Settings > Privacy & Security > Accessibility). On Linux, some desktop environments may intercept global shortcuts.
Transcription is inaccurate
The best STT provider depends on your languages, audio conditions, latency needs, formatting expectations, and data policy. Record a representative sample, compare the transcripts, and consult the current documentation and billing terms for Deepgram, Groq Whisper, OpenAI Whisper, AssemblyAI, and any other candidate. You can switch providers without losing the rest of your settings.
AI polishing changes my meaning
The LLM tries to preserve your intent while improving grammar and formatting. If it's changing too much, try a different LLM provider or adjust the polishing prompt in settings.
High latency / slow response
Diagnose the STT and LLM routes separately. Check the endpoint URL, API credentials, region, and network connection for each configured provider. For a local route, use a Custom Whisper-compatible endpoint for STT and use Ollama only for LLM text polishing. If Ollama is the slow stage, confirm that the selected model fits the machine's available memory.
API key not working
Verify the key is correct and has the right permissions. Check that billing is enabled on your provider account. Some providers require you to add credits before the key works.
App won't start on Linux
Ensure you have WebKit2GTK installed. On Ubuntu: sudo apt install libwebkit2gtk-4.1-0. On Fedora: sudo dnf install webkit2gtk4.1.