This directory contains examples demonstrating different ways to use Ferrous Waves.

First, generate the sample audio files:

cargo run --example generate_samples

This creates a samples/ directory with test WAV files including sine waves, chords, and drum patterns.

• basic_analysis.rs - Simple audio file analysis using the high-level API
• compare_files.rs - Compare two audio files and show differences
• spectral_analysis.rs - Direct use of FFT and STFT processors
• onset_detection.rs - Detect note onsets and transients in audio
• perceptual_analysis.rs - LUFS loudness measurement and perceptual metrics
• content_classification.rs - Speech/music/silence detection with confidence scores
• musical_analysis.rs - Key detection, chroma analysis, and harmonic complexity
• quality_assessment.rs - Audio quality scoring, issue detection, and recommendations
• segment_analysis.rs - Temporal structure, pattern detection, and coherence analysis
• fingerprint_similarity.rs - Audio fingerprinting, similarity detection, and duplicate finding
• cached_analysis.rs - Using the cache system for faster repeated analysis
• batch_processing.rs - Process multiple files in parallel
• envelope_visualization.rs - Generate waveform visualization with peak and RMS envelopes
• pitch_detection.rs - Detect pitch using YIN/PYIN algorithms, analyze vibrato
• cpu_features.rs - Display detected CPU SIMD capabilities and test performance
• generate_samples.rs - Generate test WAV files for the examples

After generating samples, run any example:

cargo run --example basic_analysis
cargo run --example compare_files
cargo run --example spectral_analysis
cargo run --example onset_detection
cargo run --example perceptual_analysis
cargo run --example content_classification
cargo run --example musical_analysis
cargo run --example quality_assessment
cargo run --example segment_analysis
cargo run --example fingerprint_similarity
cargo run --example cached_analysis
cargo run --example batch_processing
cargo run --example envelope_visualization
cargo run --example pitch_detection
cargo run --example cpu_features

The envelope_visualization example creates a PNG image showing waveform with peak and RMS envelopes.

The mcp_client.rs example shows the JSON format for MCP tool calls, including:

• Different analysis profiles (quick, standard, detailed, fingerprint, mastering)
• Pagination with cursors
• Comparison with similarity scoring

To use the actual MCP server:

# Start the MCP server
cargo run --bin mcp_server

# The server communicates via stdio and can be integrated with
# AI assistants that support the Model Context Protocol

The main CLI provides these commands:

# Analyze a single file
ferrous-waves analyze audio.wav

# Compare two files
ferrous-waves compare original.wav processed.wav

# Extract tempo
ferrous-waves tempo music.wav --show-beats

# Detect onsets
ferrous-waves onsets drums.wav

# Batch process files
ferrous-waves batch ./music "*.wav" --output results/

# Start HTTP server
ferrous-waves serve --port 8080