Diagnostics settings
Settings → Diagnostics brings together live runtime status, log inspection, and interactive probe tools so you can verify shortcuts, microphones, and Linux panel applets without leaving the app.
Screenshot needed
settings-diagnostics.webp
Visible. Settings Diagnostics tab with Copy summary button, system environment rows, live log viewer, and probe controls.
Capture. Paper theme, Settings → Diagnostics open.
Alt. Settings → Diagnostics showing Runtime & Shortcut Health, Kalam Logs, and Troubleshooting Probes.
settings-diagnostics.webp is added under apps/docs/static/img/screenshots/.Runtime & Shortcut Health
The top card reports a live snapshot of your Kalam environment:
- Refresh status / Copy summary: Pull fresh runtime facts or copy a clean plain-text diagnostics summary (with API keys excluded) to attach when reporting an issue.
- Process & Environment: Active build version, process ID, OS, architecture, and on Linux, your detected desktop environment and session type (
WaylandorX11). - Config & Microphone: Active configuration file path, selected audio input, and all microphones currently detected by the system.
- Shortcut portal: Confirms whether global hotkeys (including Linux desktop portals) are registered cleanly.
- Quit Kalam: Cleanly shuts down the background process and tray service when you need a full restart.
Kalam Logs
View the live rolling log directly inside the app:
- Refresh logs to pull recent events from the background daemon.
- Download log or Download CSV to export logs for bug reports.
- Open folder to open the local data directory in your file manager.
Logs never record your API keys. By default they capture lifecycle events, provider error codes, and shortcut status.
Troubleshooting Probes
When something behaves unexpectedly—such as a shortcut not firing on Linux Wayland or a clipboard paste fallback failing—use the built-in probe actions to test hotkey delivery, microphone capture, and text insertion in isolation.
For step-by-step triage by symptom, see Diagnostics & logs and Troubleshooting.