Skip to content

Installation Guide

Jump to bottom
Hmily edited this page Mar 27, 2025 · 8 revisions

📦 StreamCap Installation Guide

🌟 General Users

StreamCap offers multiple versions of installation packages to meet the needs of different users. Here’s a guide to choosing the right version for you.

🎯 Choosing the Right Installation Package

Windows Users

  • StreamCap_xxx_Win_x64.zip
    • Includes FFmpeg: This version includes precompiled FFmpeg and is suitable for most users. If you are unsure whether FFmpeg is already installed on your system, it is recommended to download this version.
  • StreamCap_xxx_Win_x64_noFF.zip
    • Excludes FFmpeg: If your system already has FFmpeg installed and the environment variables are configured, you can choose this version. This version does not include FFmpeg, which reduces the size of the installation package.

macOS Users

  • StreamCap_xxx_mac_universal.dmg
    • Includes FFmpeg: This version includes precompiled FFmpeg and is suitable for most users. If you are unsure whether FFmpeg is already installed on your system, it is recommended to download this version.
  • StreamCap_xxx_mac_universal_noFF.dmg
    • Excludes FFmpeg: If your system already has FFmpeg installed and the environment variables are configured, you can choose this version. This version does not include FFmpeg, which reduces the size of the installation package.

📝 Note: The initial startup may be slower, so please be patient while the interface initializes.

🚀 Running the Program

Windows Users

  1. After downloading, extract the .zip file.
  2. Double-click the StreamCap.exe file to launch the program.

macOS Users

  1. After downloading, double-click the .dmg file.
  2. Drag the StreamCap.app package into the Applications folder on the right.
  3. Open the installed program from the Applications folder.

🔧 Troubleshooting:

If macOS users encounter an error message saying "StreamCap" is damaged and can't be opened. You should move it to the Trash, please follow these steps to resolve the issue:

  1. Open the Terminal and enter the following command, then press Enter. You will be prompted to enter your password. After entering the password, press Enter again:

    sudo spctl --master-disable

    After completing the above steps, open System Settings > Privacy & Security > Security, and change the setting to "Allow apps downloaded from: Anywhere". Then, try to open the damaged application again. If a message appears saying "Apple cannot verify that "StreamCap.app" does not contain malware that may harm your Mac or compromise your privacy.", go back to System Settings > Privacy & Security > Security. A "Open Anyway" button will appear. Click it and continue clicking "Open Anyway" to proceed.

  2. For macOS versions below 15, if the application still shows the "damaged" message, enter the following command in the Terminal and press Enter:

    sudo xattr -rd com.apple.quarantine /Applications/StreamCap.app

  3. Try to open the damaged StreamCap application again.

😼 Advanced Users

If you are an advanced user or need to compile StreamCap from the source code, please follow the steps below:

🛠️ Compiling from Source Code

  1. Clone the Project Repository: 
    git clone https://github.com/ihmily/StreamCap.git
cd StreamCap
  2. Install Dependencies: 
    pip install -r requirements.txt
  3. Run the Program: 
    python main.py
  4. Install FFmpeg (if needed):
    • If FFmpeg is not installed on your system, please visit the FFmpeg Official Download Page to download and install it.
    • Ensure that the path to the FFmpeg executable is added to your system's environment variables.

📝 Important Notes

  • Importance of FFmpeg: StreamCap relies on FFmpeg to process video streams. If you choose a version that does not include FFmpeg, please ensure that FFmpeg is correctly installed on your system and the environment variables are configured.
  • Environment Variable Configuration: If FFmpeg is installed on your system but the environment variables are not set, the program may not run properly. Please ensure that the path to the FFmpeg executable is added to your system's environment variables.
  • Version Compatibility: Ensure that your operating system version is compatible with the downloaded installation package version.

🤝 Contribution Guide

We welcome anyone to participate in the development and improvement of StreamCap! If you encounter any issues or have suggestions for improvement, please feel free to submit them on GitHub Issues.

Clone this wiki locally