binary locations - panuozzo77/StreamingCommunity GitHub Wiki

Binary Locations

This guide explains how to use the pre-compiled binaries for StreamingCommunity and how to customize their locations on your system.

Pre-compiled Binaries

StreamingCommunity offers pre-compiled binaries for Windows, macOS, and Linux, which allow you to run the application without installing Python or other dependencies.

Download Links

Windows macOS Linux Linux Previous All Versions

Default Binary Locations

StreamingCommunity requires FFmpeg and related binaries for media processing. These binaries are stored in specific locations depending on your operating system:

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

The binaries include:

  • ffmpeg: For media processing and conversion
  • ffprobe: For analyzing media files
  • ffplay: For media playback

Customizing Binary Locations

You can customize the location of these binaries by following these steps for your operating system:

Windows

  1. Move the binary folder from C:\binary to your desired location

  2. Add the new path to Windows environment variables:

    • Open Start menu and search for "Environment Variables"
    • Click "Edit the system environment variables"
    • Click "Environment Variables" button
    • Under "System Variables", find and select "Path"
    • Click "Edit"
    • Add the new binary folder path
    • Click "OK" to save changes

For detailed Windows PATH instructions, see the Windows PATH guide.

macOS

  1. Move the binary folder from ~/Applications/binary to your desired location

  2. Add the new path to your shell's configuration file:

    # For bash (edit ~/.bash_profile)
    export PATH="/your/custom/path:$PATH"
    
    # For zsh (edit ~/.zshrc)
    export PATH="/your/custom/path:$PATH"
  3. Reload your shell configuration:

    # For bash
    source ~/.bash_profile
    
    # For zsh
    source ~/.zshrc

Linux

  1. Move the binary folder from ~/.local/bin/binary to your desired location

  2. Add the new path to your shell's configuration file:

    # For bash (edit ~/.bashrc)
    export PATH="/your/custom/path:$PATH"
    
    # For zsh (edit ~/.zshrc)
    export PATH="/your/custom/path:$PATH"
  3. Apply the changes:

    source ~/.bashrc   # for bash
    # or
    source ~/.zshrc    # for zsh

Important Notes

After moving the binary folder, ensure that:

  • All executables (ffmpeg, ffprobe, ffplay) are present in the new location
  • Files have the correct permissions and extensions:
    • Windows: .exe extensions required
    • macOS/Linux: Ensure files have execute permissions (chmod +x filename)

Running the Pre-compiled Binaries

Windows

  1. Download the Windows executable from the link above
  2. Double-click the .exe file to run it
  3. Alternatively, run it from Command Prompt or PowerShell:
    .\StreamingCommunity_win.exe
    

macOS

  1. Download the macOS binary from the link above
  2. Open Terminal and navigate to the download location
  3. Make the file executable:
    chmod +x StreamingCommunity_mac
  4. Run the binary:
    ./StreamingCommunity_mac

Linux

  1. Download the Linux binary from the link above
  2. Open Terminal and navigate to the download location
  3. Make the file executable:
    chmod +x StreamingCommunity_linux
  4. Run the binary:
    ./StreamingCommunity_linux

Troubleshooting

Common Issues

  1. "Permission denied" when running the binary

    • Ensure the file has execute permissions: chmod +x filename
    • On macOS, you might need to allow the application in System Preferences > Security & Privacy
  2. "Command not found" when running FFmpeg

    • Verify the binary location is in your PATH
    • Check if the binaries exist in the expected location
  3. "Missing dependencies" on Linux

    • Install required libraries: sudo apt-get install libssl-dev libcurl4-openssl-dev (Debian/Ubuntu)
    • For other distributions, install equivalent packages

Getting Help

If you encounter issues not covered here:

Next Steps

⚠️ **GitHub.com Fallback** ⚠️