Skip to content

Latest commit

Β 

History

108 Commits

Folders and files

NameName
Last commit message
Last commit date
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Lufalyze

License: MIT PRs Welcome Netlify Status Sponsor

Navigation

πŸ“Š Try Demo β€’ πŸ”¬ Technical Docs β€’ 🎯 Platform Targets β€’ πŸš€ Getting Started

Overview

Lufalyze is a professional web-based audio analysis platform that implements ITU-R BS.1770-4 and EBU R 128 standards for precise loudness measurement. Analyze audio directly in your browser with WebAssembly performance and complete privacy.

✨ Key Features

  • 🎯 Professional Loudness Analysis - ITU-R BS.1770-4 / EBU R 128 compliance with Β±0.1 LU accuracy
  • πŸ” Technical Quality Assessment - True peak detection, clipping analysis, DC offset detection, and spectral analysis
  • πŸ“Š PDF Reports - Professional analysis reports with platform target comparisons
  • 🎚️ Platform Targets - Pre-configured targets for Spotify, YouTube, Apple Music, Netflix, and more
  • πŸ”’ Privacy-Focused - All processing happens locally in your browser
  • ⚑ High Performance - WebAssembly-powered analysis with 50x real-time speed
  • ⌨️ Keyboard Shortcuts - Full keyboard navigation (press H for help)
  • β™Ώ Accessibility - Screen reader support and ARIA compliance
  • πŸŒ™ Dark Mode - Comfortable viewing in any lighting condition

Quick Start

πŸ“± Web App (Recommended)

  1. Visit lufalyze.com
  2. Upload your audio file (WAV, MP3, FLAC, AAC, OGG, M4A)
  3. View instant analysis results
  4. Export professional PDF reports (press E)

πŸ’» Local Development

# Clone and install
git clone https://github.com/tillrd/Lufalyze.git
cd Lufalyze
npm install

# Start development server
npm run dev

# Build for production
npm run build

Platform Targets

Platform Target (LUFS) Tolerance
Spotify -14.0 Β±1.0
YouTube -14.0 Β±1.0
Apple Music -16.0 Β±1.0
Netflix -27.0 Β±1.0
Amazon Music -24.0 Β±1.0
TikTok/Instagram -14.0 Β±1.0
Broadcast TV -23.0 Β±1.0

Supported Formats

Format Max Size
WAV 100MB
FLAC 200MB
MP3 75MB
M4A/AAC 75MB
OGG Vorbis 75MB
WebM Audio 75MB

πŸ” Analysis Capabilities

Lufalyze provides comprehensive audio analysis focused on loudness measurement and technical quality assessment:

Loudness Analysis

  • ITU-R BS.1770-4 Compliance - Professional-grade loudness measurement
  • EBU R 128 Standards - Broadcast-quality analysis with Β±0.1 LU accuracy
  • Multi-Metric Analysis - Momentary, Short-term, and Integrated LUFS
  • Platform Optimization - Automatic compliance checking for streaming services

Technical Assessment

  • True Peak Detection - Comprehensive peak analysis with platform compliance
  • Quality Metrics - Clipping detection, DC offset analysis, and noise assessment
  • Spectral Analysis - Frequency balance across 7 bands with professional insights
  • Stereo Analysis - Phase correlation, stereo width, and imaging quality

Performance Metrics

  • Accuracy: Professional-grade measurement with Β±0.1 LU precision
  • Processing Speed: Real-time analysis with WebAssembly optimization
  • Coverage: Works with all supported audio formats
  • Reliability: Consistent results across different audio content types

Documentation Structure

Document Audience Content
README.md Everyone Overview, quick start, basic usage
docs/TECHNICAL.md Developers & Researchers Mathematical formulas, algorithms, implementation details
docs/DEVELOPMENT.md Contributors Development setup, architecture, testing, deployment
CONTRIBUTING.md Contributors Pull request workflow, coding standards, community guidelines
LICENSE Legal MIT license terms

Keyboard Shortcuts

Key Action Context
U Upload file Always
E Export PDF report After analysis
C Copy results After analysis
D Toggle dark mode Always
H Show help Always
S Jump to spectrum Always
L Jump to loudness Always
P Jump to platform targets Always
F Jump to file details Always
T Jump to technical analysis Always
1-5 Select platform target Always
Esc Close modals In modals

Technology Stack

  • Frontend: React 18 + TypeScript + Vite
  • Audio Processing: WebAssembly (Rust) + Web Audio API
  • Styling: Tailwind CSS + Headless UI
  • PDF Generation: PDF-lib for professional reports
  • Testing: Vitest + Playwright E2E
  • Deployment: Netlify with automatic builds
  • Standards: ITU-R BS.1770-4, EBU R 128, WCAG 2.1 AA

Contributing

We welcome contributions! Please see our Contributing Guide for:

  • πŸ› οΈ Development setup and build instructions
  • πŸ“ Coding standards and style guidelines
  • πŸ§ͺ Testing requirements and procedures
  • πŸ“‹ Pull request process and review criteria
  • πŸ› Bug reporting and feature requests

License & Credits

  • License: MIT License - Free for commercial and personal use
  • Standards: Implements ITU-R BS.1770-4 and EBU R 128 specifications
  • Creator: Richard Tillard (@tillrd)
  • Privacy: No data collection, no analytics, no tracking
  • Security: All processing local, no server uploads

Links


Lufalyze - Professional Audio Analysis Platform

Built with ❀️ for the audio engineering community

Try it now β€’ Technical docs β€’ Report issues

About

Professional audio analysis with ITU-R BS.1770-4 compliance. WebAssembly-powered loudness measurement and key detection.

Topics

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Sponsor this project

Packages

Used by

Contributors

Languages