Skip to main content
Kalam Documentation

Your first dictation

Click any text field outside Kalam, hold your dictation shortcut for at least 300 ms, speak naturally, and release. Your words appear right at the cursor.

Floating pill in the Recording state showing active profile, waveform, timer, and Stop control. (Click to zoom)

Before you begin​

Finish First-run setup through Try it so at least one speech engine is ready.

OSDefault Hold to DictateWhat to watch
WindowsCtrl+WinFloating pill
macOSCtrl+OptionFloating pill
LinuxCtrl+AltPanel chip

Four steps to dictate anywhere​

  1. Click into another app

    Open Notepad, TextEdit, Slack, your browser, or your code editor and click inside a text field so the cursor is blinking.

  2. Hold and wait for the listening signal

    Hold Hold to Dictate (at least 300 ms). The floating pill on Windows/macOS or the panel chip on Linux expands to show it is listening.

  3. Speak naturally

    Say a complete sentence or thought at a normal speaking pace while watching the live waveform respond to your voice.

  4. Release to transcribe and insert

    Release the shortcut. Kalam transcribes the audio, optionally polishes it (on Pro profiles with Improve enabled), inserts the text at your cursor, and saves a record under History.

How text gets inserted​

  • macOS: Kalam defaults to Accessibility, then paste—it inserts via macOS Accessibility first and falls back to paste if a target app blocks Accessibility typing.
  • Windows and Linux: Kalam defaults to Paste for reliable multi-word formatting, and automatically switches to simulated keystrokes when dictating inside Sensitive apps so private passwords or notes never touch your clipboard.

You can adjust insertion defaults in Settings → Voice Input.

If nothing happens​

  • Overlay never lights up: Check that you held the shortcut longer than 300 ms and clicked outside Kalam. On macOS, verify Input Monitoring is enabled in System Settings. On Windows, if the target window is running as Administrator, Windows blocks normal-privilege apps from hearing global shortcuts.
  • Overlay listens, then nothing appears: Make sure the text field still has focus, then check Permissions by OS (macOS Accessibility, GNOME/KDE Wayland Allow remote interaction).
  • Audio fails or wrong mic: Open Settings → Voice Input to test and select the right microphone.