🎧 WaveWizard 🎶

Tired of being unsure if your audio files are truly high quality or just upscaled fakes? Discover the truth behind your audio with WaveWizard! Dive deep into the intricate details of your music files and effortlessly uncover their real sample rate, bit depth, and more.

Overview

WaveWizard is an interactive Gradio app that analyzes audio files to determine their actual sample rate and bit depth. It helps you verify if your high-resolution audio files are genuine or upsampled from lower-quality sources.

• Detects true sample rate by analyzing significant frequency content.
• Estimates effective bit depth based on dynamic range.
• Visualizes the frequency spectrum, spectrogram, and amplitude histogram.
• Supports multiple files and folders for batch processing.

Features

• 🎶 Waveform
• 📈 Spectral Features
• 📊 Frequency Spectrum Analysis
• 🌈 Spectrogram Visualization
• 📈 Amplitude Histogram
• 🔍 Bit Depth and Sample Rate Estimation
• 🎛️ Interactive Gradio Interface

Demo

(Give it a try!)

Screenshots

Interactive Interface

Detailed Analysis

Installation

Prerequisites

• Python 3.7+
• pip package manager

Clone the Repository

git clone https://github.com/JackVinati/WaveWizard.git
cd WaveWizard

Install Dependencies

pip install -r requirements.txt

Contents of requirements.txt:

numpy
librosa
matplotlib
soundfile
gradio

Usage

Running the App

python wavewizard_app.py

Accessing the Interface

After running the script, open your web browser and navigate to the local URL provided (e.g., http://127.0.0.1:7860/).

Analyzing Audio Files

1. Upload Files:
   • Click on "Upload Audio Files" to select one or more audio files.
2. Specify Folder Path (Optional):
   • Enter the path to a folder containing audio files.
3. Analyze:
   • Click on the "Analyze" button to start the analysis.
4. View Results:
   • The app displays analysis results, including:
   • File Information: Bit depth, sample rate, duration, etc.
   • Plots: Frequency spectrum, spectrogram, and amplitude histogram.
   • Estimations: Significant frequency content, estimated real sample rate, dynamic range, and effective bit depth.

Project Structure

WaveWizard/
├WaveWizard/
├── wavewizard_app.py       # Main application script
├── requirements.txt        # Python dependencies
├── README.md               # Project documentation
├── LICENSE                 # License file
├── assets/                 # Images and other assets
├── audio_analysis/         # Main package folder
│   ├── __init__.py         # Initializes the package
│   ├── audio_analysis.py   # Orchestrator function for analysis
│   ├── audio_processing.py # Module for audio processing functions
│   ├── audio_plotting.py   # Module for plotting functions
│   ├── utility.py          # Module for utility functions

Contributing

Contributions are welcome! Please open an issue or submit a pull request for any improvements or feature requests.

License

This project is licensed under the MIT License.

Acknowledgments

• Librosa for audio processing.
• Gradio for the interactive interface.
• Matplotlib for plotting.

Contact

• GitHub: @JackVinati