Audio Extract

A powerful, easy-to-use batch audio extraction tool wrapping FFmpeg. Extract specific segments of multiple audio files in one go, either via a graphical user interface (GUI) or a command line interface (CLI).

Features

• Batch Processing: Extract excerpts from all audio files (e.g., MP3, WAV) in a directory simultaneously.
• Dual Interfaces: Use the intuitive Graphical User Interface (GUI) or the automation-friendly Command Line Interface (CLI).
• Flexible Configuration: Define settings once in a parameters.yaml file, or override them dynamically in the CLI.
• Fade Effects: Apply smooth fade-out/fade-in transitions to extracted clips.
• FFmpeg Integration: Auto-detects FFmpeg on your system PATH or allows specifying a custom path.

Prerequisites

• FFmpeg: Must be installed on your system.
  • Download link: https://www.ffmpeg.org/
• Python: Version 3.7 or newer.

Installation

From Releases (Pre-built Wheel/Executable)

Download the latest wheels or standalone executable from Releases.

Usage

🖥️ Graphical Interface (GUI) - On Linux or Mac OS

The GUI allows you to select directories, adjust start/end times, toggle fade effects, and run extractions visually.

1. Launch the GUI by running:

   audio_extract_gui
   

2. Choose the input folder, set your extraction duration, and click Process.

🖥️ Graphical Interface (GUI) - On Windows

1. Download and run the standalone audio_extract.exe directly from the Releases page.
2. Choose the input folder, set your extraction duration, and click Process.

💻 Command Line Interface (CLI)

To run the CLI, navigate to your desired directory and execute:

audio_extract

By default, the CLI will look for a parameters.yaml file in the current directory to read configuration parameters.

Configuration File (parameters.yaml)

Create a parameters.yaml file in your working directory to customize the default run behavior:

input_dir: "input"
output_dir: "output"
first_second: 0
last_second: 120
input_file_extension: ["mp3", "wav"]

YAML Configuration Parameters

Command-Line Arguments

All parameters from parameters.yaml can be overridden using arguments:

To view the CLI help menu, run:

audio_extract --help

Examples

• Extract the first 30 seconds of all files from my_audio and save to my_extracts:

  audio_extract --input my_audio --output my_extracts --start 0 --end 30
  

• Extract from second 60 to 120 with a 3-second fade duration:

  audio_extract --start 60 --end 120 --fade 3
  

• Run in debug mode with a custom input directory:

  audio_extract --debug --input /path/to/your/audio
  

Build from Source

For development instructions and packaging details, please refer to build.md.