🎛️ AudioNoise Web
_{Real-time audio DSP in your browser}

Professional-grade audio effects ported from torvalds/AudioNoise C algorithms

Features • Quick Start • DSP Engine • Architecture • Contributing • Support

---

✨ The Vision

AudioNoise Web brings professional guitar pedal DSP effects to your browser. Process audio in real-time with sub-millisecond latency using algorithms ported from Linus Torvalds' AudioNoise C library.

"The main design goal has been to learn about digital audio processing basics. Just IIR filters and basic delay loops. Everything is single sample in, single sample out with no latency." — Linus Torvalds

---

🚀 Features

🎛️ AudioNoise DSP Engine

Real-time audio processing ported from C-based guitar pedal algorithms:

Effect	Description
Echo	Delay with feedback and LFO modulation
Flanger	Classic modulated delay sweeping
Phaser	4-stage allpass cascade with LFO
Low Pass	Warm tone shaping biquad filter
High Pass	Clean up muddy frequencies
Band Pass	Isolate frequency ranges
Notch	Surgical frequency removal
All Pass	Phase shifting without amplitude change

📊 Real-Time Visualization

• Waveform — Time-domain audio visualization
• Spectrum Analyzer — Frequency distribution bars
• Spectrogram — Scrolling frequency/time heatmap

🎤 Multiple Input Sources

• File Upload — Process any audio file (MP3, WAV, OGG)
• Microphone — Live real-time processing
• Bluetooth — Multi-channel instrument routing

🤖 Optional AI Effect Suggestions

• Bring your own API key (OpenAI, Anthropic, Ollama, or custom)
• Analyzes your audio in real-time
• Recommends effects based on frequency profile
• One-click effect application with optimized parameters

---

🏃 Quick Start

# Clone the repository
git clone https://github.com/yourusername/audionoise-web.git
cd audionoise-web

# Install dependencies
npm install

# Start development server
npm run dev

Open http://localhost:5000 in your browser.

---

🔧 DSP Engine

The AudioNoise DSP Engine is a complete audio processing toolkit ported from C to TypeScript/Web Audio API.

Architecture

client/src/lib/dsp/
├── audio-engine.ts      # Web Audio context management
├── lfo.ts               # Low Frequency Oscillator
├── biquad.ts            # IIR filter implementations
├── delay-line.ts        # Circular buffer with interpolation
├── effects/
│   ├── echo.ts          # Delay-based echo
│   ├── flanger.ts       # Modulated delay flanger
│   └── phaser.ts        # Allpass cascade phaser
└── index.ts             # Module exports

Design Philosophy

Inspired by the original AudioNoise C library:

• Zero Latency — Single sample in, single sample out
• IIR Filters — Efficient recursive filtering
• Real-Time Safe — No allocations in audio path
• Analog Emulation — Digital recreation of classic circuits

Usage

import { audioEngine, createEchoNode, createPhaserNode } from '@/lib/dsp';

// Initialize engine
await audioEngine.initialize();

// Connect audio source
await audioEngine.connectMicrophone();

// Add effects
const echo = createEchoNode(audioEngine.audioContext, 300, 0.5, 0.5);
audioEngine.addEffect(echo.input);

// Get visualization data
const freqData = audioEngine.getFrequencyData();

---

🏗️ Architecture

audionoise-web/
├── client/                 # React frontend
│   ├── src/
│   │   ├── components/     # UI components
│   │   │   ├── effects-rack.tsx
│   │   │   ├── audio-visualizer.tsx
│   │   │   ├── ai-effect-suggester.tsx
│   │   │   └── audio-input.tsx
│   │   ├── hooks/          # React hooks
│   │   │   └── use-audio-dsp.ts
│   │   ├── lib/
│   │   │   └── dsp/        # AudioNoise DSP library
│   │   └── pages/
│   │       └── studio.tsx  # Main application
│   └── index.html
├── server/                 # Express backend
├── reference/              # Original C algorithms
│   └── audionoise-c/
└── shared/                 # Shared types

---

🛠️ Tech Stack

Layer	Technology
Frontend	React 18, TypeScript, Tailwind CSS
UI Components	shadcn/ui, Radix Primitives
Audio	Web Audio API, AudioWorklet
State	React Query, Zustand
Backend	Express, Node.js
Build	Vite, ESBuild

---

🤝 Contributing

We love contributions! See our Contributing Guide for details.

Quick contribution ideas:

• 🎸 Port more effects from AudioNoise (FM synthesis, AM synthesis, distortion)
• 📊 Add FFT frequency-domain analysis (see issue #37)
• 🎛️ Add granular synthesis controls (see issue #40)
• 🧪 Add unit tests for DSP algorithms
• 📱 Improve mobile responsiveness

---

💖 Support the Project

If AudioNoise Web helps you process audio, consider supporting development:

Ethereum / EVM Chains

0x618d855C2F32f1C9343624111b8bEd20eEccdf53

Your support helps us:

• 🚀 Port more effects from AudioNoise
• 🔊 Add FFT visualization and analysis
• 📱 Improve mobile experience
• 📚 Create tutorials and documentation

---

📜 License

This project is licensed under the GNU General Public License v2 — see the LICENSE file for details.

This is free and open source software. You are free to use, modify, and distribute this software under the terms of the GPL v2.

---

🙏 Acknowledgments

• AudioNoise — Original C DSP algorithms for guitar pedals
• DaisySP — Inspiration for flanger implementation
• Web Audio API — Making browser audio processing possible
• shadcn/ui — Beautiful component primitives

---

Built with 💜 for audio enthusiasts

_{AudioNoise Web — Real-time DSP in your browser}