ReEQ Audio Toolkit

Modern browser extension for real-time audio equalization and bass boost.
Built with React, TypeScript, and the Web Audio API.

---

Features

• 10-band parametric equalizer with adjustable frequency, gain, and Q-factor
• Real-time frequency spectrum visualizer for visual feedback
• Master volume control with gain limiting
• Preset management with import/export functionality
• Multi-tab support for processing audio across multiple browser tabs
• Low latency processing using OffscreenDocument API

---

Tech Stack

• Frontend: React 19, TypeScript, Zustand
• Build: Vite, CRXJS
• Audio: Web Audio API (BiquadFilter, AnalyserNode)
• Extension: Chrome Manifest V3

---

Installation

1. Download or clone this repository
2. Run npm install && npm run build
3. Open Chrome and navigate to chrome://extensions
4. Enable "Developer mode"
5. Click "Load unpacked" and select the dist folder

---

Usage

1. Click the ReEQ extension icon and then click EQ This Tab to enable audio processing on the current tab
2. Adjust EQ filters by dragging dots (hold Shift to modify Q-factor)
3. Use the volume slider to control master gain
4. Save your settings as presets for quick access
5. Switch between EQ, Guide, and Active Tabs views

---

Project Structure

src/
├── background/        # Service worker and background logic
├── offscreen/         # Audio processing engine
├── popup/             # React UI components
│   ├── components/    # UI components (EQ, controls, tabs)
│   ├── hooks/         # Custom React hooks
│   └── utils/         # Helper functions and constants
├── store/             # Zustand state management
└── types/             # TypeScript type definitions

---

For Development

# Clone repository
git clone https://github.com/addavriance/ReEQ.git
cd ReEQ

# Install dependencies
npm install

# Build extension
npm run build

---

Acknowledgments

This project was inspired by the original Ears Audio Toolkit. The codebase has been completely rewritten using modern technologies and Manifest V3 compliance.