Smart Audio Cutter Pro ✂️

Smart Audio Cutter Pro is a lightweight, high-speed Python tool designed to batch-cut audio files based on precise timestamps. It utilizes FFmpeg's Direct Stream Copy technology, ensuring zero quality loss and blazing fast processing speeds (no re-encoding required).

---

✨ Features

• ⚡ Blazing Fast: Cuts hours of audio in seconds.
• 💎 Lossless Quality: No re-encoding; preserves the original audio quality 100%.
• ⏱️ Millisecond Precision: Supports Minute:Second:Millisecond format (e.g., 05:30:50).
• 🌍 Cross-Platform: Works seamlessly on Windows, macOS, and Linux.
• 🖱️ Drag & Drop Support: Easy-to-use interface for terminal beginners.
• 📊 Progress Tracking: Live progress bar with status updates.

---

🛠️ Installation & Prerequisites

To use this tool, you need Python and FFmpeg installed on your system.

1. Install Python

• All OS: Download and install Python from python.org.
• Important: During installation, make sure to check the box "Add Python to PATH".

2. Install FFmpeg

This script relies on FFmpeg to process the audio files.

🍎 For macOS Users

Open your Terminal and run:

brew install ffmpeg

(Note: If you don't have Homebrew, visit brew.sh to install it first).

🪟 For Windows Users

Open PowerShell or Command Prompt and run:

winget install Gyan.FFmpeg

Alternatively, you can download the executable from ffmpeg.org and add it to your System PATH manually.

---

📝 Input File Format

You need to create a text file (e.g., list.txt) containing the cut details. Format per line: Start Time, End Time, Filename

Time Format: MM:SS:ms (Minutes : Seconds : Milliseconds)

Example Content of list.txt:

00:00:00, 00:00:15, Intro.mp3
00:01:05, 00:02:30, 01_Surah_Fatiha.mp3
05:10:05, 05:15:00, 02_Dua.mp3

Note: 05:10:05 means 5 minutes, 10 seconds, and 5 milliseconds.

---

🚀 How to Use

Method 1: Drag and Drop (Easiest)

1. Open your Terminal (Mac) or Command Prompt (Windows).
2. Navigate to the folder containing the script (e.g., cd Desktop/AudioCutter).
3. Run the script:

   python smart_cutter.py

4. The script will ask you to input the files. Simply Drag and Drop your .txt file into the terminal window and press Enter.
5. Then, Drag and Drop your source Audio .mp3 file and press Enter.

Method 2: Command Line (Fastest)

If you want to run it instantly without prompts, provide the filenames as arguments:

python smart_cutter.py list.txt source_audio.mp3

(Replace list.txt and source_audio.mp3 with your actual file names).

---

❓ Troubleshooting

Q: The generated files are empty (0kb) or silent?

• Check Time Range: Ensure your timestamps actually exist in the audio file. For example, do not try to cut at 00:55:00 (55 minutes) if your audio is only 7 minutes long.
• Check Format: Ensure you are using Minutes:Seconds or Minutes:Seconds:Milliseconds.

Q: "ModuleNotFoundError" or Python error?

• This script uses standard Python libraries. If you see this, ensure you have Python 3 installed and you are running the command using python3 or python.

Q: "FFmpeg not found"?

• This means FFmpeg is not installed or not added to your system's PATH. Please refer to the Installation section above.

---

License: Open Source. Feel free to modify and share.