Permissions by OS
Every OS handles microphone access, global keyboard shortcuts, and inserting text into other apps differently. Select your operating system below to see exactly what Kalam needs and why.
- Windows
- macOS
- Linux
Windows 11 requires only microphone access in Windows privacy settings. Text insertion and global hotkeys do not require extra Windows privacy toggles.
| Capability | Requirement | If missing or blocked |
|---|---|---|
| Microphone | Windows Microphone privacy permission enabled for Kalam | Recording cannot start; pick or test mic under Settings → Voice Input |
| Shortcuts | Standard Windows desktop focus | If an elevated (Run as Administrator) terminal or window is focused, Windows isolates global hotkeys from normal apps. Click a standard window or run Kalam as Administrator for that session |
| Text insertion | Defaults to Paste; forces direct keystrokes inside Sensitive apps | Some elevated apps reject un-elevated paste—Kalam shows Copied — paste manually |
macOS 11+ enforces separate System Settings grants under Privacy & Security for audio, hotkeys, and typing. Because public beta builds are self-signed, first launch may also require Open Anyway in System Settings → Privacy & Security.
| Permission | Why Kalam needs it | If disabled |
|---|---|---|
| Microphone | Capture your speech from the selected input device | Dictation cannot start (required during setup) |
| Input Monitoring | Detect Hold to Dictate and Toggle Dictation when other apps are in front | Global shortcuts do nothing outside the Kalam window |
| Accessibility | Primary text-insertion path (Accessibility, then paste) | Kalam falls back to Paste (which updates the clipboard), except inside Sensitive apps |
| Notifications | Deliver desktop status and update notices | Alerts stay silent |
Re-granting permissions after a beta update
If a permission toggle looks enabled in System Settings → Privacy & Security after updating a beta build but Kalam still flags it:
- Select Kalam in that System Settings list and remove it with
−. - Add Kalam again or select Repair inside the Kalam prompt so macOS binds the grant to the updated app signature.
Linux does not use macOS-style TCC prompts. Microphone access works automatically once a capture device is present, while text insertion and hotkey capture depend on your display session (X11, Wayland, or COSMIC).
Session insertion behavior
Kalam defaults to Paste across standard apps and switches to direct typing inside Sensitive apps. Depending on your desktop session:
| Session | How insertion & shortcuts work | First-run prompt |
|---|---|---|
| X11 (Linux Mint, Xubuntu, Kubuntu X11) | Inserts directly via X11 input/paste | No extra prompt |
| GNOME / KDE Wayland | Uses desktop portal global shortcuts and remote input | System prompts Allow remote interaction on first dictation—approve once |
| COSMIC | Inserts via the input method when an editable field is active; otherwise falls back to paste | No TCC dialog |
Panel chip
On Linux, live dictation feedback appears inside the panel chip applet rather than a floating window. GNOME usually activates kalam@kalamvoice.com automatically; KDE, Cinnamon, MATE, Xfce, and COSMIC add Kalam Dictation from the panel widget menu.