rs-audio-stats 1.1.3

Professional-grade audio analysis tool with EBU R128 loudness measurement

rs_audio_stats

🎵 Professional-grade audio analysis and normalization library for Python with EBU R128 loudness measurement.

✨ Features

• 📊 EBU R128 Loudness Analysis: Industry-standard loudness measurement (±0.05 LUFS accuracy)
• 🎛️ Audio Normalization: Normalize to broadcast standards (-23 LUFS, streaming platforms)
• ⚡ High Performance: SIMD-optimized, multi-threaded batch processing
• 🔄 Batch Processing: Analyze entire directories with progress tracking
• 📁 Multiple Formats: WAV, FLAC, MP3, AAC, OGG, ALAC, MP4/M4A support
• 📤 Export Options: CSV, JSON, XML, TSV output formats
• 🌍 Cross-Platform: Windows, macOS (Intel/Apple Silicon), Linux - No compilation required!

🚀 Quick Start

Installation

pip install rs-audio-stats

That's it! No additional dependencies or compilation required.

Basic Usage

import rs_audio_stats

# Analyze audio file
info, results = rs_audio_stats.analyze_audio_all("audio.wav")
print(f"Loudness: {results.integrated_loudness:.1f} LUFS")
print(f"Peak: {results.true_peak:.1f} dBFS")
print(f"Dynamic Range: {results.loudness_range:.1f} LU")

# Normalize to streaming standard (-14 LUFS)
rs_audio_stats.normalize_to_lufs("input.wav", -14.0, "output.wav")

# Batch process directory
results = rs_audio_stats.batch_analyze("/path/to/audio/files/")
rs_audio_stats.export_to_csv(results, "analysis_results.csv")

🎯 Use Cases

• Broadcasting: Ensure EBU R128 / ATSC A/85 compliance
• Music Production: Master to streaming platform standards
• Podcasting: Normalize episodes to consistent levels
• Quality Control: Automated audio file validation
• Post-Production: Film/TV audio delivery standards

📊 Supported Measurements

• Integrated Loudness (LUFS) - Overall program loudness
• Short-term Loudness (LUFS) - 3-second maximum
• Momentary Loudness (LUFS) - 400ms maximum
• Loudness Range (LU) - Dynamic range measurement
• True Peak (dBFS) - Maximum sample peak with oversampling
• RMS Levels (dB) - Average and maximum RMS power

🎵 Supported Audio Formats

Input: WAV, FLAC, MP3, AAC, OGG Vorbis, ALAC, MP4/M4A
Output: WAV (32-bit float PCM)

🔧 Core Functions

# Analysis
analyze_audio()          # Selective measurements
analyze_audio_all()      # All measurements
get_audio_info_py()      # File info only
batch_analyze()          # Directory processing

# Normalization
normalize_integrated_loudness()  # Target LUFS
normalize_true_peak()           # Target dBFS peak
normalize_to_lufs()             # Convenience wrapper

# Export
export_to_csv()         # Spreadsheet format
export_to_json()        # Programming format
find_audio_files()      # File discovery

📈 Performance

• Ultra-fast: WAV files analyzed in milliseconds
• Memory efficient: Streaming processing for large files
• Parallel processing: Multi-threaded batch operations
• SIMD optimized: Uses CPU vector instructions

🎬 Example Applications

Podcast Production

# Normalize entire season to -16 LUFS
episodes = rs_audio_stats.find_audio_files("./season1/")
for episode in episodes:
    output = episode.replace("raw", "normalized")
    rs_audio_stats.normalize_to_lufs(episode, -16.0, output)

Music Mastering

# Check album consistency
results = rs_audio_stats.batch_analyze("./album/")
loudness_values = [r[2].integrated_loudness for r in results]
consistency = max(loudness_values) - min(loudness_values)
print(f"Album loudness range: {consistency:.1f} LU")

Broadcast Compliance

# Check EBU R128 compliance
info, results = rs_audio_stats.analyze_audio_all("program.wav")
if -23.5 <= results.integrated_loudness <= -22.5:
    print("✅ EBU R128 compliant")
else:
    print("❌ Needs normalization")

📖 Documentation

• Complete API Guide - Comprehensive documentation with real-world examples
• API Reference - Detailed function reference
• GitHub Repository - Source code and issues

📄 License

MIT License - See LICENSE file for details.

🏷️ Version

Current version: 1.1.3