Diagnostics and logs
Use logging and diagnostics when something fails silently — hotkeys, config, or crashes. Controls live under Settings → Advanced. Beta builds also upload sanitized diagnostic bundles automatically (90-day retention). Stable builds only send telemetry if you opt in under Privacy.
Enable and download logs
- Open Settings → Advanced → Logging.
- Turn Enable Logging on (pre-release/dev builds may already force debug logging).
- Set Log Level (Error → Debug) and Max Records if you need a longer buffer.
- Reproduce the problem once.
- Click Download log or Download CSV, and optionally Open Data Folder.
- Attach the file to a GitHub issue or support email with OS and version from Settings → About.
What to share
Share downloaded logs and a short repro. Do not paste API keys. Prefer the export buttons over copying raw folders unless support asks.
Built-in diagnostics
Under Settings → Advanced → Diagnostics you can:
- Review environment info (OS, app version).
- Run hotkey hook / key-capture / matching tests.
- Analyze config health.
- Run a system health check.
- Save diagnostic report — structured results plus a log excerpt for support.
Logging may rise to Debug only while a test runs.
Beta diagnostic uploads
| Topic | Detail |
|---|---|
| When | Pre-release (beta) builds |
| What | Sanitized diagnostic log bundles (warnings, errors, debug-oriented bundles — not raw audio or full transcripts as product telemetry) |
| Opt-out | None on beta — disclosed under Settings → Privacy |
| Retention | 90 days (with per-user/device and daily upload caps) |
| Stable | No forced log upload; telemetry is consent-gated |
Channel choice: Updating and the beta channel. Privacy toggles: Privacy settings.
Sanitization is not anonymity theater
Bundles are scrubbed of obvious secrets where possible, but treat exports as sensitive. Only send them to official support channels.