Diagnostics and logs
When hotkeys, microphones, permissions, or Linux panel chips behave unexpectedly, open Settings → Diagnostics for live runtime status, rolling logs, and interactive probes—or Settings → Advanced to download full log files and markdown support bundles.
Quick inspection in Settings → Diagnostics
- Open Settings → Diagnostics.
- Click Refresh status under Runtime & Shortcut Health to inspect detected OS/desktop session (
WaylandvsX11), microphone devices, and shortcut registration. - Click Copy summary for a clean diagnostics snapshot (API keys are automatically excluded).
- Review live Kalam Logs directly in the viewer or run Troubleshooting Probes to test hotkey delivery or insertion step by step.
Export log files & support bundles
- Open Settings → Advanced → Logging.
- On pre-release beta builds, debug logging runs automatically; click Download log or Download CSV after reproducing the issue (or adjust Log Level and Max Records on future stable builds).
- Under Diagnostics → Support export, run Analyze config, Modifier snapshot, or Export markdown to bundle recent probe output and logs.
- Send the exported file through kalamvoice.com/contact with your OS and build version from Settings → About.
Never paste API keys
Diagnostic exports exclude stored API keys, LLM polish capture payloads, and dictated transcripts—still share logs only with official support channels.
Beta diagnostic uploads
| Property | Behavior |
|---|---|
| Applies to | Pre-release beta builds (1.0.0-beta.x) |
| Contents | Anonymous usage events and sanitized diagnostic log bundles (no audio, no transcripts, no API keys) |
| Retention | Up to 90 days under the Beta Policy |
| Stable builds | Telemetry and log uploads default to Off until opted in under Settings → Privacy |