🎵 Allegro - Professional BPM Analysis Showcase

Allegro is a comprehensive showcase application demonstrating the power of the realtime-bpm-analyzer library. This Next.js application provides professional-grade BPM analysis tools for music producers, DJs, and audio enthusiasts.

🌐 Live Demo: allegro-project.com

✨ Features

• 📁 File Analysis - Upload and analyze BPM from audio files (MP3, WAV, FLAC)
• 🎤 Real-time Microphone - Live BPM detection from your microphone input
• 📻 Audio Stream Analysis - Analyze BPM from online radio streams and URLs
• 📊 Visual Analytics - Real-time audio visualization and BPM tracking
• 📱 Mobile Responsive - Fully optimized for mobile devices with touch-friendly UI
• 🎨 Modern UI - Beautiful glassmorphic design with smooth animations

🚀 Powered by realtime-bpm-analyzer

This application showcases the capabilities of the realtime-bpm-analyzer library:

npm install realtime-bpm-analyzer

Key Library Features:

• ⚡ Real-time processing - Analyze BPM as audio streams
• 🎯 High accuracy - Advanced algorithms for precise BPM detection
• 🔄 Multiple input sources - Files, streams, microphone, audio nodes
• 🌐 Web Audio API - Leverages modern browser capabilities
• 📦 Zero dependencies - Lightweight and performant
• 🎛️ Configurable - Customizable analysis parameters

Quick Usage Example:

import { createRealtimeBpmAnalyzer } from 'realtime-bpm-analyzer';

// Create audio context and processor
const audioContext = new AudioContext();
const analyzer = await createRealtimeBpmAnalyzer(audioContext);

// Connect to audio source
source.connect(analyzer);

// Listen for BPM events with typed listeners
analyzer.on('bpm', (data) => {
  console.log('Current BPM:', data.bpm[0].tempo);
});

analyzer.on('bpmStable', (data) => {
  console.log('Stable BPM detected:', data.bpm[0].tempo);
});

🛠️ Installation & Development

Prerequisites

• Node.js 22+
• npm or yarn or pnpm

Quick Start

1. Clone the repository

   git clone https://github.com/dlepaux/allegro.git
   cd allegro

2. Install dependencies

   npm install
   # or
   yarn install
   # or
   pnpm install

3. Start development server

   npm run dev
   # or
   yarn dev
   # or
   pnpm dev

4. Open your browser

   http://localhost:3000
   

🎯 Use Cases & Applications

For Music Producers

• Track Analysis - Quickly determine BPM of samples and loops
• Tempo Matching - Find tracks with similar BPMs for mashups
• Live Recording - Real-time BPM monitoring during performances

For DJs

• Beatmatching - Precise BPM detection for seamless mixing
• Set Preparation - Batch analyze music libraries
• Live Analysis - Real-time BPM detection during sets

For Developers

• Integration Examples - See how to implement realtime-bpm-analyzer
• Best Practices - Learn optimal Web Audio API usage patterns
• Performance Optimization - Understand efficient audio processing

🤝 Contributing

We welcome contributions! This project serves as both a showcase for realtime-bpm-analyzer and a testing ground for new features.

Development Guidelines

1. Fork the repository
2. Create a feature branch: git checkout -b feature/amazing-feature
3. Follow the existing code style (ESLint + TypeScript)
4. Test thoroughly across different audio sources
5. Update documentation if needed
6. Submit a pull request

Areas for Contribution

• 🎨 UI/UX improvements - Enhance the user interface
• 📊 New visualizations - Create audio analysis charts
• 🔧 Performance optimizations - Improve audio processing
• 📱 Mobile enhancements - Better touch interactions
• 🌐 Accessibility - Improve screen reader support
• 🧪 Testing - Add unit and integration tests

📖 realtime-bpm-analyzer Documentation

Official Resources

• 📦 NPM Package: realtime-bpm-analyzer
• 🐙 GitHub Repository: dlepaux/realtime-bpm-analyzer
• 📚 API Documentation: Available in the package README

Advanced Usage Patterns

// File analysis - Offline/synchronous analysis
import { analyzeFullBuffer } from 'realtime-bpm-analyzer';
const tempos = await analyzeFullBuffer(audioBuffer);
console.log('BPM:', tempos[0].tempo);

// Custom filtering for better bass detection
import { getBiquadFilter } from 'realtime-bpm-analyzer';
const filter = getBiquadFilter(audioContext);
source.connect(filter).connect(analyzer);

// Real-time stream processing with typed events
analyzer.on('bpm', (data) => {
  console.log('Analyzing...', data.bpm[0].tempo);
});

analyzer.on('bpmStable', (data) => {
  console.log('Stable BPM detected:', data.bpm[0].tempo);
  console.log('Confidence:', data.bpm[0].count);
});

// Continuous analysis for streams (auto-resets)
const streamAnalyzer = await createRealtimeBpmAnalyzer(audioContext, {
  continuousAnalysis: true,
  stabilizationTime: 20000 // Reset every 20 seconds
});

streamAnalyzer.on('analyzerReset', () => {
  console.log('Analyzer reset - starting fresh analysis');
});

📄 License

This project is licensed under the Apache License - see the LICENSE file for details.

🙏 Acknowledgments

• realtime-bpm-analyzer - The core BPM detection engine
• Web Audio API - Modern browser audio processing capabilities
• Next.js Team - Amazing React framework
• Tailwind CSS - Utility-first CSS framework

---

🌐 Visit Live Demo • 📦 NPM Package • 🐙 GitHub

Built with ❤️ for the audio development community