This document addresses common issues you might encounter when using StreamingCommunity and provides solutions to help you resolve them.

Issue: Error message about incompatible Python version.

Solution:

• Ensure you have Python 3.8 or higher installed
• Verify your Python version with python --version or python3 --version
• If needed, download and install the latest Python version from python.org

Issue: Errors when installing required packages.

Solution:

• Update pip: python -m pip install --upgrade pip
• Try installing packages one by one to identify problematic dependencies
• Check your internet connection
• If behind a proxy, configure pip to use it: pip install --proxy http://user:password@proxyserver:port packagename

Issue: Error messages about missing FFmpeg binaries.

Solution:

• Verify FFmpeg is installed: ffmpeg -version
• Ensure FFmpeg is in the correct location (see Binary Locations)
• Download FFmpeg from ffmpeg.org if needed
• Add FFmpeg to your system PATH

Issue: Unable to access streaming sites.

Solution:

• Check your internet connection
• Verify the site is operational by trying to access it in a browser
• Some sites may be geo-restricted; consider using a VPN
• The site domain may have changed; run the update script: python update.py

Issue: SSL certificate verification errors.

Solution:

• Set verify to false in the REQUESTS section of your config.json
• Update your system's CA certificates
• Check your system date and time (incorrect time can cause certificate validation failures)

Issue: Requests timing out during searches or downloads.

Solution:

• Increase the timeout value in the REQUESTS section of your config.json
• Check your internet connection speed and stability
• Try reducing the number of worker threads if your connection is unstable

Issue: Downloads fail to complete.

Solution:

• Check the error message for specific issues
• Increase the max_retry value in the REQUESTS section
• Reduce the number of worker threads if your connection is unstable
• Try a different resolution by changing the force_resolution setting
• Check if the content is still available on the source site

Issue: Downloaded files are corrupted or won't play.

Solution:

• Ensure the download completed successfully
• Try downloading with different codec settings
• Verify FFmpeg is working correctly
• Try playing the file with VLC or another robust media player
• Check if the source content is of good quality

Issue: Downloaded content is missing audio tracks or subtitles.

Solution:

• Verify that download_audio and download_subtitle are set to true
• Check if the source content actually has the audio/subtitle languages you're requesting
• Update your specific_list_audio and specific_list_subtitles settings to include the desired languages
• Some content may not have separate audio tracks or subtitles available

Issue: Downloads are progressing very slowly.

Solution:

• Check your internet connection speed
• Adjust the number of worker threads based on your connection:
  • Fast connection: Increase workers (16-24)
  • Slow connection: Decrease workers (4-6)
• Try a lower resolution by changing the force_resolution setting
• Set default_preset to a faster option like "ultrafast" or "superfast"

Issue: The application is using excessive CPU resources.

Solution:

• Reduce the number of worker threads
• Set default_preset to a faster option
• Enable GPU acceleration if your hardware supports it
• Close other CPU-intensive applications while downloading

Issue: Telegram bot doesn't respond to commands.

Solution:

• Verify the bot is running
• Check the TOKEN_TELEGRAM value in your .env file
• Ensure you're using the correct bot in Telegram
• Restart the bot script

Issue: "Unauthorized" message when trying to use the bot.

Solution:

• Verify your AUTHORIZED_USER_ID in the .env file
• Make sure you're using the correct Telegram account
• Restart the bot after updating the .env file

Issue: Changes to configuration don't take effect.

Solution:

• Ensure you're editing the correct config.json file
• Verify the JSON syntax is valid
• Save the file before running the application
• Check file permissions (the application needs write access to update the file)

Issue: Command line arguments don't override settings.

Solution:

• Check the syntax of your command line arguments
• Ensure you're using the correct argument names
• For boolean values, use "true" or "false" (lowercase doesn't matter)
• For lists, use comma-separated values without spaces

If you encounter issues not covered here:

1. Check the GitHub Issues page for similar problems
2. Join the Discord community for support
3. Enable debug mode in your configuration to get more detailed logs
4. Consider opening a new issue on GitHub with detailed information about your problem