This guide provides detailed instructions for manually installing StreamingCommunity. This method gives you full control over the installation process and is recommended for advanced users or those with specific setup requirements.

Before proceeding with the manual installation, ensure you have the following prerequisites installed on your system:

1. Python: Version 3.8 or higher

   • Verify with: python --version or python3 --version
   • Download Python if needed

2. FFmpeg: Required for media processing

   • Verify with: ffmpeg -version
   • Download from FFmpeg's official website
   • For Windows users: gyan.dev FFmpeg builds

3. Git (optional): For cloning the repository

   • Verify with: git --version
   • Download Git if needed

You can either clone the repository using Git or download it as a ZIP file.

git clone https://github.com/Arrowar/StreamingCommunity.git
cd StreamingCommunity

1. Go to https://github.com/Arrowar/StreamingCommunity
2. Click the "Code" button and select "Download ZIP"
3. Extract the ZIP file to your desired location
4. Navigate to the extracted directory

Creating a virtual environment is recommended to isolate the project dependencies.

# Create a virtual environment
python -m venv .venv

# Activate the virtual environment
.venv\Scripts\activate

# Create a virtual environment
python3 -m venv .venv

# Activate the virtual environment
source .venv/bin/activate

With your virtual environment activated, install the required Python packages:

pip install -r requirements.txt

StreamingCommunity requires FFmpeg for media processing. You need to ensure FFmpeg is properly installed and accessible.

StreamingCommunity looks for FFmpeg binaries in these default locations:

• Windows: C:\binary
• macOS: ~/Applications/binary
• Linux: ~/.local/bin/binary

1. Create the appropriate directory for your operating system
2. Download FFmpeg binaries for your platform
3. Extract the binaries (ffmpeg, ffprobe, ffplay) to the directory

1. Install FFmpeg using your system's package manager:

   • Windows: Use a package manager like Chocolatey: choco install ffmpeg
   • macOS: Use Homebrew: brew install ffmpeg
   • Debian/Ubuntu: sudo apt install ffmpeg
   • Arch Linux: sudo pacman -S ffmpeg
   • CentOS/RHEL: sudo dnf install ffmpeg

2. Ensure FFmpeg is in your system PATH

If you want to use a custom location for FFmpeg:

1. Place the FFmpeg binaries in your preferred location
2. Add the location to your system's PATH variable:
   • Windows: See Windows PATH guide
   • macOS/Linux: Add to your shell profile (.bashrc, .zshrc, etc.):

     export PATH="/your/custom/path:$PATH"

To verify that everything is installed correctly:

# Make sure your virtual environment is activated
python -c "import StreamingCommunity; print('StreamingCommunity is installed')"

python test_run.py

python3 test_run.py

For Windows 7, follow these additional steps:

1. Ensure you have Visual C++ Redistributable for Visual Studio 2015-2019 installed
2. You may need to manually set the console size:

   mode 120, 40

For installation on Termux, refer to the Termux-specific guide for detailed instructions.

To update your manual installation to the latest version:

python update.py

python3 update.py

1. FFmpeg Not Found

   • Ensure FFmpeg binaries are in the correct location
   • Verify FFmpeg is in your PATH: which ffmpeg (Linux/macOS) or where ffmpeg (Windows)

2. Python Package Installation Errors

   • Try updating pip: pip install --upgrade pip
   • Install packages one by one to identify problematic dependencies

3. Permission Issues

   • On Linux/macOS, you might need to use sudo for system-wide installations
   • Ensure you have write permissions to the installation directory

If you encounter issues not covered here:

• Check the Common Issues section
• Visit the GitHub Issues page
• Join the Discord community for support

• Configure your settings
• Learn about command line arguments
• Try your first global search