Skip to main content
Kalam Documentation

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.

Settings → Advanced → Logging showing Download log, Download CSV, and Open Data Folder controls. (Click to zoom)

Quick inspection in Settings → Diagnostics​

  1. Open Settings → Diagnostics.
  2. Click Refresh status under Runtime & Shortcut Health to inspect detected OS/desktop session (Wayland vs X11), microphone devices, and shortcut registration.
  3. Click Copy summary for a clean diagnostics snapshot (API keys are automatically excluded).
  4. 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​

  1. Open Settings → Advanced → Logging.
  2. 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).
  3. Under Diagnostics → Support export, run Analyze config, Modifier snapshot, or Export markdown to bundle recent probe output and logs.
  4. 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​

PropertyBehavior
Applies toPre-release beta builds (1.0.0-beta.x)
ContentsAnonymous usage events and sanitized diagnostic log bundles (no audio, no transcripts, no API keys)
RetentionUp to 90 days under the Beta Policy
Stable buildsTelemetry and log uploads default to Off until opted in under Settings → Privacy