Audio Converter

Convert audio files between popular formats with control over quality settings. Supports batch processing and maintains metadata where possible.

Quick Start

from scripts.audio_converter import AudioConverter

# Simple conversion
converter = AudioConverter("input.wav")
converter.convert("output.mp3")

# With quality settings
converter = AudioConverter("input.flac")
converter.bitrate(320).sample_rate(44100).convert("output.mp3")

# Batch convert directory
AudioConverter.batch_convert("./input_folder", "./output_folder", format="mp3", bitrate=192)

Features

• Format Support: MP3, WAV, FLAC, OGG, M4A/AAC, AIFF
• Quality Control: Bitrate, sample rate, channels
• Metadata Preservation: Copy tags when possible
• Batch Processing: Convert entire directories
• Normalization: Optional volume normalization

API Reference

Initialization

# From file
converter = AudioConverter("audio.wav")

Settings

converter.bitrate(192)        # kbps (for lossy formats)
converter.sample_rate(44100)  # Hz
converter.channels(2)         # 1=mono, 2=stereo
converter.normalize(True)     # Normalize volume

Conversion

# Convert to format (inferred from extension)
converter.convert("output.mp3")

# Explicit format
converter.convert("output", format="mp3")

Batch Processing

# Convert all files in directory
AudioConverter.batch_convert(
    input_dir="./wavs",
    output_dir="./mp3s",
    format="mp3",
    bitrate=320
)

CLI Usage

# Simple conversion
python audio_converter.py --input song.wav --output song.mp3

# With quality settings
python audio_converter.py --input song.flac --output song.mp3 --bitrate 320 --sample-rate 44100

# Batch convert
python audio_converter.py --input-dir ./wavs --output-dir ./mp3s --format mp3 --bitrate 192

# Normalize during conversion
python audio_converter.py --input song.wav --output song.mp3 --normalize

CLI Arguments

| Argument | Description | Default | |----------|-------------|---------| | --input | Input audio file | Required | | --output | Output file path | Required | | --input-dir | Input directory for batch | - | | --output-dir | Output directory for batch | - | | --format | Output format | From extension | | --bitrate | Bitrate in kbps | 192 | | --sample-rate | Sample rate in Hz | Original | | --channels | Number of channels | Original | | --normalize | Normalize volume | False |

Supported Formats

| Format | Extension | Type | Notes | |--------|-----------|------|-------| | MP3 | .mp3 | Lossy | Most compatible | | WAV | .wav | Lossless | Large files | | FLAC | .flac | Lossless | Compressed lossless | | OGG | .ogg | Lossy | Open format | | M4A | .m4a | Lossy | AAC codec | | AIFF | .aiff | Lossless | Apple format |

Examples

Convert WAV to MP3

converter = AudioConverter("recording.wav")
converter.bitrate(320).convert("recording.mp3")

Convert FLAC to Multiple Formats

source = AudioConverter("album.flac")

# High quality MP3
source.bitrate(320).convert("album_hq.mp3")

# Standard MP3
source.bitrate(192).convert("album_std.mp3")

# OGG for streaming
source.bitrate(128).convert("album.ogg")

Batch Convert for Podcast

# Convert all WAV recordings to MP3 with podcast settings
AudioConverter.batch_convert(
    input_dir="./raw_episodes",
    output_dir="./episodes",
    format="mp3",
    bitrate=128,
    sample_rate=44100,
    channels=1  # Mono for podcasts
)

Dependencies

pydub>=0.25.0
soundfile>=0.12.0

Note: Requires FFmpeg installed on system for MP3/M4A support.

Limitations

• Requires FFmpeg for MP3 and M4A formats
• Metadata transfer is best-effort
• Some format combinations may not preserve all tags