If Python is not installed, download and install it from the Python official website.

1. Download or clone this project.
2. Double-click start.bat.

Upon the first run, if the program detects that FFmpeg is not installed, an installation dialog will pop up:

1. Select the installation directory for FFmpeg (defaults to the ffmpeg folder in the user's home directory).
2. Click the "Install" button.
3. The program will:
   • Automatically download FFmpeg (approx. 100MB, takes about 10 seconds).
   • Automatically extract it to the specified directory.
   • Automatically add it to the system PATH environment variable.
4. After installation, restart the program to use it.

The program provides three methods to package it into a standalone .exe file, allowing it to run without Python installed.

1. Double-click build_exe.bat.
2. The script will automatically install PyInstaller (if not installed) and begin packaging.
3. The executable file will be located in dist\M4S Merger Tools v1.x.0.exe.

python build_exe.py

# Install PyInstaller
pip install pyinstaller

# Package (using the batch script)
build_exe.bat

# Or directly use PyInstaller
pyinstaller --onefile --windowed --name "M4S Merger Tools v1.x.0" main.py

The packaged .exe file can be:

• Copied to any Windows computer and run directly.
• Shared with other users via USB drives or cloud storage.
• Upon first run, the program automatically detects and installs FFmpeg as needed (requires network connection).

The program includes a comprehensive error handling mechanism, displaying detailed error prompts at every stage.

• Python version check
• Module import check
• GUI initialization check

• File selection error prompts
• FFmpeg call error prompts
• File processing error prompts
• Network connection error prompts

• FFmpeg download error prompts
• Extraction error prompts
• PATH addition error prompts

If the program fails to respond:

1. Check for error pop-up windows (they might be hidden behind other windows).
2. Check if a process is running in the Task Manager.
3. Try running as administrator.
4. Check the program's log output (if running from source code).

A: The program automatically checks for FFmpeg on the first run. If it's not installed, an installation dialog will appear—follow the instructions. If it is installed but the program can't detect it, ensure FFmpeg is added to the system PATH environment variable, and then restart the program.

A: Possible reasons include:

• Network connection issues: Check your internet connection.
• Insufficient disk space: FFmpeg requires about 200MB of space.
• Permission issues: Ensure you have write permissions for the installation directory.

If automatic installation fails, you can install FFmpeg manually (refer to the manual installation instructions in the "Installation" section).

A: Please check:

1. Whether an error prompt window appeared (it might be hidden).
2. If a process is running in the Task Manager.
3. Try running as administrator.
4. If using the EXE file, ensure the file is complete and not blocked by antivirus software.

A: Please ensure that you have selected both video and audio files and used the "One-Click Muxing" feature to combine the streams.

A: Check the error message in the log output area. Common causes include:

• File paths containing special characters.
• Corrupted files.
• Insufficient disk space.
• FFmpeg version incompatibility.
• Network connection issues (during FFmpeg download).

• GUI Framework: Python tkinter
• Video Processing: FFmpeg
• Error Handling: Comprehensive exception capturing and user notification mechanism

This project is licensed under the MIT License.