TROUBLESHOOTING.md

🎥 Audio/Video Troubleshooting Guide

Common Issues and Solutions

1. Video Recording Issues

Problem: Video recording creates 0-second files or doesn't work at all.

Solutions:

• Browser Compatibility: Use Chrome, Firefox, or Edge. Safari may have issues.
• Camera Permissions: Make sure to allow camera access when prompted.
• HTTPS Required: Some browsers require HTTPS for camera access. Use streamlit run --server.address 0.0.0.0 --server.port 8501 for local testing.
• Refresh Page: If buttons don't respond, try refreshing the page.

2. Audio Recording Issues

Problem: Voice input doesn't work or produces no audio.

Solutions:

• Microphone Permissions: Allow microphone access when prompted.
• Browser Settings: Check browser settings for microphone permissions.
• Clear Browser Cache: Clear browser cache and cookies.
• Try Different Browser: Some browsers handle WebRTC better than others.

3. Dependencies Issues

Problem: Import errors or missing modules.

Solutions:

# Install all dependencies
pip install -r requirements.txt

# If you get errors, try installing individually:
pip install streamlit-webrtc
pip install opencv-python-headless
pip install av
pip install SpeechRecognition
pip install gTTS
pip install PyAudio

4. Windows-Specific Issues

Problem: PyAudio installation fails on Windows.

Solutions:

# Try installing PyAudio with pipwin
pip install pipwin
pipwin install pyaudio

# Or download from: https://www.lfd.uci.edu/~gohlke/pythonlibs/#pyaudio

5. Performance Issues

Problem: Slow video/audio processing.

Solutions:

• Reduce Video Quality: The app uses 640x480 resolution by default.
• Close Other Apps: Close other applications using camera/microphone.
• Check System Resources: Ensure sufficient RAM and CPU available.

Testing Your Setup

Run the test script to verify everything is working:

streamlit run test_audio_video.py

This will check:

• ✅ All dependencies are installed
• ✅ Directories are writable
• ✅ Basic functionality

Browser Requirements

• Chrome: Best compatibility
• Firefox: Good compatibility
• Edge: Good compatibility
• Safari: Limited compatibility (not recommended)

Network Requirements

• Local Development: Works fine on localhost
• Production: HTTPS required for camera/microphone access
• Firewall: Ensure ports 8501 (or your chosen port) is accessible

Error Messages and Solutions

Error	Solution
"Camera not found"	Check camera permissions and browser settings
"Microphone not found"	Check microphone permissions and browser settings
"WebRTC not supported"	Update browser or try different browser
"Permission denied"	Allow camera/microphone access in browser
"Video file too small"	Record for at least 2-3 seconds

Getting Help

If you're still having issues:

1. Check the browser console for JavaScript errors
2. Run the test script: streamlit run test_audio_video.py
3. Check if your camera/microphone work in other applications
4. Try a different browser
5. Restart the Streamlit server

Development Tips

• Use st.debug() to add debugging information
• Check st.session_state for state management issues
• Monitor browser console for WebRTC errors
• Test on different devices and browsers