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
Try switching to a different STT provider. Deepgram and OpenAI Whisper generally offer the best accuracy for English. For Chinese, try GLM-ASR. Also check your microphone input level in system 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
Try Groq for both STT and LLM — it's the fastest option. Also check your internet connection. If using Ollama, ensure your machine has enough RAM for the model.
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.