Troubleshooting Guide
Microphone Access Issues
Problem: "Microphone access denied" or "Permission blocked"
Quick Solutions:
- Click "Open in New Tab" - Resolves embedded browser restrictions
- Refresh and retry - Allow permissions when prompted
- Check browser settings - Ensure microphone is enabled for this site
- Close other apps - That might be using the microphone
Browser-Specific Fixes:
- Chrome: Click the microphone icon in address bar
- Firefox: Settings → Privacy & Security → Permissions
- Safari: Preferences → Websites → Microphone
- Edge: Settings → Site Permissions → Microphone
Performance Issues
Problem: App running slowly or freezing
Immediate Actions:
- Close unnecessary browser tabs
- Refresh the page
- Check available device memory
- Use latest browser version
Optimization Tips:
- Use Chrome or Firefox for best performance
- Avoid running other audio applications
- Monitor shorter sessions (under 2 hours)
- Export data regularly to free memory
Data & Report Issues
Session Not Saving
- Check internet connection
- Ensure browser allows localStorage
- Try creating a new session
- Contact support with session ID
Email Reports Not Sending
- Verify recipient email address
- Check spam/junk folders
- Ensure SendGrid is configured
- Try downloading PDF/CSV directly
Platform-Specific Issues
Mobile Devices
- Use landscape orientation
- Keep screen active during monitoring
- Check device microphone permissions
- Close background apps
Replit Preview
- Always click "Open in New Tab"
- Embedded view blocks microphone
- Use webview tab instead
- Deploy for full functionality
Network Issues
- Ensure stable internet connection
- Use HTTPS (secure) connection
- Check firewall settings
- Try different network if possible
Common Error Codes
Error | Meaning | Solution |
---|---|---|
NotAllowedError |
Microphone permission denied | Grant permission in browser settings |
NotFoundError |
No microphone detected | Check hardware connection |
AbortError |
Operation was interrupted | Refresh page and try again |
NotReadableError |
Hardware error | Restart browser or device |