How do I troubleshoot common issues?
How do I troubleshoot common issues?
Most issues in Meeting Notes Pro fall into three categories: license activation, processing, and export. Here are the most common problems and their solutions.
License Activation Errors
| Error | Cause | Solution |
|---|---|---|
Invalid license key | Typo or wrong key | Double-check the key; keys are case-sensitive |
License expired | Subscription ended | Renew via Settings > Manage Subscription |
Device limit reached | Used on 3+ devices | Contact support to deactivate a previous device |
Network error | No internet connection | Check your connection and try again |
Processing Errors
Automatic retry errors (Tier 1)
These resolve on their own. The app retries automatically with delays of 1s, 2s, and 4s.
- "Rate limit exceeded": Too many requests; wait a moment
- "Server error (503)": Temporary AWS issue
- "Request timeout": Slow network or large transcript
Circuit breaker errors (Tier 2)
After 5 consecutive failures, requests are paused for 30 seconds.
- Wait for the cooldown to complete
- Check your internet connection
- Try again after the cooldown
Immediate errors (Tier 3)
These require your action.
- "Authentication failed": Your license may be invalid or expired. Contact support
- "Template validation failed": Try a different template or provide a more structured transcript
- "Completeness score too low": Provide a more detailed transcript
Export Errors
| Error | Cause | Solution |
|---|---|---|
| File save failed | Disk full or permissions | Check available disk space |
| PII token missing | Token mapping expired | Reprocess the transcript |
| File already exists | Duplicate filename | Choose a different filename |
Common Issues
Blank clients in dropdown: Go to Settings > Data Maintenance > Clear All Clients, then re-add your clients.
App won't start: Ensure Windows 10+ is installed. Try running as administrator. Check the app logs at ~/.meeting-notes-pro/logs/.
Slow processing: Processing time depends on transcript length. Keep transcripts under 10,000 words. Ensure a stable internet connection.
Need more help? Contact support@northerncatalyst.ca