Installation Guide

📦 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, 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:

   sudo spctl --master-disable

2. Try opening the program again. If it still shows the "damaged" message, enter the following command:

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

3. Attempt to open the 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.