AudioBatchConvert

Fast, recursive, multi-core audio batch converter using FFmpeg.
Convert entire folders of audio files into a consistent format using all available CPU cores.

My hardware supports different file formats and backups in WAV were too big so I needed an efficient tool to convert all my samples to other formats. Backups are great in flac.

---

Features

• Throw any folder – scans subdirectories for audio files
• Multi-core processing – utilizes all available CPU cores (configurable)
• Flexible format support – output to WAV, FLAC, AIFF, MP3, etc.
• Preserve directory structure – mirrors input folder layout in output
• Cross-platform – works on macOS, Linux, and Windows

---

Requirements

• FFmpeg (must be installed and available in your system path, You can check this by running: ffmpeg -version)

Installation

Option 1: Download Pre-built Executables (currently failing, please use option 2 for now)

Download the appropriate executable for your operating system from the Releases page:

• Windows: AudioBatchConverter.exe
• macOS: AudioBatchConverter.dmg
• Linux: AudioBatchConverter-x86_64.AppImage

Option 2: Install from Source

Clone this repository and set up a virtual environment:

git clone https://github.com/yourname/multicore-batch-audio-converter.git
cd multicore-batch-audio-converter

# configure requirements
bash setup_env.sh

Usage

Graphical User Interface

Launch the application with:

# If using the executable:
# Simply double-click the downloaded file

# If installed from source:
venv/bin/python convert.py --gui

The GUI provides options for:

• Selecting input and output directories
• Choosing file types to convert
• Selecting output format, sample rate, and bit depth
• Setting the number of CPU cores to use
• Monitoring conversion progress

Command Line Interface

venv/bin/python convert.py INPUT_DIR OUTPUT_DIR EXTENSIONS OUTPUT_FORMAT SAMPLE_RATE BIT_DEPTH [--workers N]

Argument | Description
INPUT_DIR | Root folder to search for audio files
OUTPUT_DIR | Destination folder to write converted files (will mirror directory layout)
EXTENSIONS | Pipe-separated list of extensions to match "wav|mp3|aiff" or all "*"
OUTPUT_FORMAT | Choose one output format (e.g. wav, flac, aiff, mp3)
SAMPLE_RATE | Output sample rate (e.g. 44100, 48000,)
BIT_DEPTH | Output bit depth (e.g. 16, 24)
--workers N | (Optional) Number of parallel processes to use (default: all cores)
--gui | (Optional) Launch the graphical user interface

Example

Convert all .flac and .mp3 files from ~/audio_library to 16-bit 44.1kHz WAV format in ~/converted using 4 cores:

venv/bin/python convert.py ~/audio_library ~/converted "flac|mp3" wav 44100 16 --workers 4

Building from Source

To build standalone executables:

# Install PyInstaller
pip install pyinstaller

# Build executable
pyinstaller --name AudioBatchConverter --onefile --windowed main.py

License

This project is licensed under the MIT License.

FFmpeg is a required external dependency and is licensed separately under LGPL/GPL.
This project does not bundle FFmpeg — please install it according to your platform.