How can we help?

Open TypeSay Settings and navigate to the Audio tab. Confirm that the correct input device is selected from the dropdown. If your microphone does not appear, check that it is connected and recognized by your operating system. On macOS, you may need to grant microphone permission in System Settings > Privacy & Security > Microphone.

Try switching to a smaller Whisper model. The Tiny model (75 MB) transcribes in about 1 second on most hardware. If accuracy is the priority, use the Small or Medium model with GPU acceleration enabled. Ensure your environment has low background noise, and speak clearly at a normal pace. You can also try setting the language manually instead of relying on auto-detection.

Another application may be using the same keyboard shortcut. Open TypeSay Settings > Hotkeys and try assigning a different key combination. TypeSay validates shortcuts in real-time to prevent conflicts. On Linux, make sure TypeSay has permission to register global hotkeys (some Wayland compositors require additional configuration).

TypeSay supports two insert modes: Type Simulation and Clipboard. If one mode is not working with a specific application, try switching to the other in Settings > Output. Clipboard mode copies the text, pastes it via Ctrl+V (or Cmd+V), and then restores your previous clipboard contents. Some terminal emulators and elevated (admin) windows may block type simulation.

Models are downloaded from HuggingFace on first use. Check your internet connection and firewall settings. If the download stalls, close TypeSay, delete the partial model file from the models directory, and try again. The models directory is located in your system's app data folder (e.g., %APPDATA%\TypeSay on Windows, ~/Library/Application Support/TypeSay on macOS).

GPU acceleration requires compatible hardware and drivers. NVIDIA cards need CUDA drivers installed. Apple Silicon Macs use Metal automatically. For Vulkan support, ensure your GPU drivers are up to date. Check the Performance tab in Settings to confirm which backend TypeSay is using. If GPU is available but not active, try restarting the application.