Categorized triage. If your issue isn't here, email support@crossmeet.com with logs (%APPDATA%\CrossMeet\logs.db).

1. Install & launch

Q: Install fails halfway

Symptom: installer progress bar stalls or shows an error
Try:

Temporarily disable antivirus
Right-click installer → Run as administrator
Check disk space (C: needs 1 GB+)
Don't install into a path containing non-ASCII characters

Q: White screen / stuck at Loading

Symptom: window opens but content stays blank
Try:

Delete %APPDATA%\CrossMeet\backend.port, restart
Inspect %APPDATA%\CrossMeet\logs.db (open in SQLite browser)
Kill stray Python: Task Manager → kill any cm-backend.exe
Still broken: uninstall → delete %APPDATA%\CrossMeet\ → reinstall

Q: "Backend not responding"

Symptom: red error banner in the UI
Try:

Settings → System → Restart Backend
Check firewall isn't blocking cm-backend.exe (only listens on 127.0.0.1)
Search logs for [FATAL]

Q: Python runtime download fails

Symptom: first launch stuck at "Preparing Python runtime"
Try:

Switch networks (corporate VPN may block PyPI)
Settings → Advanced → PyPI Mirror → pick Tsinghua / Aliyun mirror
Manual runtime download: see [Offline installer] (coming soon)

2. Activation

Q: "Invalid license key"

Recheck key spelling (watch 0/O, 1/I, l/1)
Check the key wasn't refunded/revoked
Email support@crossmeet.com to verify

Q: "Device limit exceeded"

All slots used — release an old device (Activation docs §5/§6)
Or email support to request more slots

Q: "License expired"

Check my.crossmeet.com → Subscription status
Check your system clock is accurate (large drift breaks signatures)
Check Settings → Licensing → Last heartbeat timestamp

3. ASR (recognition)

Q: All garbage / wrong language

Settings → ASR → Language — force a specific language (don't use auto)
Check mic level: Settings → Audio → input waveform

Q: Sentences break too early

Settings → ASR → Advanced → vad_threshold higher (0.4–0.5)
Or min_silence_ms higher (700–1000)

Q: Sentences break too late / never break

vad_threshold lower (0.2)
min_silence_ms lower (300)

Q: Words dropped / parts missing

Check CPU usage — local Whisper falling behind drops content
Switch to medium model (large is too heavy for weak CPUs)
Enable GPU acceleration

Q: Chinese recognition is poor

Switch to Aliyun ASR or Qwen3-ASR (best for Chinese)
For local Whisper: use large-v3-turbo (Chinese-optimized)

4. LLM (translation)

Q: Translation truncated / drops words

Check the prompt template includes {text} placeholder
Glossary too large — context overflowing. Remove unrelated terms.
Switch to a larger-context model (Gemini 1.5 Pro 1M)

Q: Translation slow

GPT-4o-mini > Claude Sonnet > Claude Opus (descending speed)
Disable RAG (if KB enabled) to isolate
Check network latency to api.openai.com

Q: Poor translation / "AI translation" feel

Upgrade to Claude 3.5 Sonnet
Add Glossary for keywords
Enable RAG for business context
Add style few-shot examples in prompt template

Q: LLM occasionally returns JSON / markdown

Add to prompt end: Output ONLY the translation, no explanation, no JSON, no markdown:

5. TTS (synthesis)

Q: TTS silent

Check Settings → Audio → Output Device
Check TTS engine selected: Settings → TTS
Local preview: Settings → Audio → Test TTS

Q: TTS stutters / interrupts

Swap to a cloud engine (local ChatTTS is slow)
Check network stability
Lower per-request character count (Settings → TTS → max_chars_per_request)

Q: Wrong voice

Settings → TTS → pick another voice
ElevenLabs: tweak stability parameter

6. vMic (virtual microphone)

Q: Zoom / Teams can't hear TTS

Zoom mic MUST be CrossMeet Virtual Microphone
NOT CrossMeet Virtual Microphone (loopback)
Test: CrossMeet → Settings → Audio → Test vMic

Q: They hear echo

Disable Zoom's "Original sound for musicians"
Your physical mic should NOT be the vMic loopback

Q: BSoD after driver install

Uninstall CrossMeet → reboot → reinstall latest (driver v2 fixes several issues)
Still BSoD: email + minidump to support

Q: Driver leftover after uninstall

Device Manager → audio I/O → right-click CrossMeet Virtual Microphone → Uninstall device
Check "Delete the driver software"

7. Network & sync

Q: "Cannot reach license server"

Test reachability: ping api.crossmeet.com
Check firewall
Corporate network: Settings → Networking → configure proxy

Q: History didn't auto-sync

Cloud Sync is a paid feature — confirm purchase at my.crossmeet.com
Settings → Sync → Status
Force: top-right sync icon right-click → Force Sync Now

8. Performance

Q: High CPU usage

Disable local Whisper (use cloud) or switch to base model
Disable RAG if you have many docs
Task Manager — is it cm-backend.exe? Check logs.

Q: Memory growing (suspected leak)

Restart the app (short-term)
Report: Settings → Help → Report Issue auto-attaches memory profile

Q: GPU not used

NVIDIA driver ≥ 525 + CUDA 12.x
Settings → ASR → Advanced → Use CUDA checked
nvidia-smi to confirm a CrossMeet process appears

9. Data & privacy

Q: Where is history? How do I export?

Location: %APPDATA%\CrossMeet\crossmeet.db (SQLite)
Export: main UI → History → select session → Export → Markdown / PDF / DOCX

Q: How to wipe all data?

Full reset: uninstall → delete %APPDATA%\CrossMeet\ → reinstall
History only: main UI History → multi-select → Delete

Q: Does data go to your cloud?

Local by default. ASR audio + translations DO NOT leave your machine to our servers.
Cloud LLM / ASR APIs are controlled by your API key (independent of CrossMeet servers)

10. Still stuck?

Gather info:
- Settings → Help → Generate Diagnostic Bundle → packages logs + redacted config
Email support@crossmeet.com with the bundle
Urgent: ask in community.crossmeet.com
Pro / Lifetime / Enterprise: VIP channel (24h SLA)