🎵 ClearWave

ClearWave is an intelligent browser extension designed to provide a consistent and comfortable audio experience. It automatically normalizes volume levels in real-time, preventing sudden spikes in volume or whisper-quiet dialogue.

✨ Features

• Real-time Normalization: Automatically adjusts the volume of any media to match your preferred reference level.
• 📍 Set Reference Volume: Use the "Set Reference" button while listening to your ideal volume to teach the extension your preference.
• 📊 Live Volume Meter: A visual representation of current audio levels with smooth, real-time updates.
• 🚀 One-Click Toggle: Quickly enable or disable normalization with a simple switch.
• 🎨 Premium UI: A modern, glassmorphic design that feels native to your browsing experience.
• 🧠 Smart Detection: Dynamically detects new media elements (videos/audio) as they appear on the page.

🛠 How It Works

ClearWave uses the Web Audio API to hook into the audio stream of your browser tab.

1. Analysis: It measures the RMS (Root Mean Square) amplitude of the audio 10 times per second.
2. Comparison: It compares the current level against your stored Reference Level.
3. Adjustment: A GainNode is used to smoothly increase or decrease the volume to match the target, ensuring a consistent output without clipping or distortion.

📥 Installation

1. Clone or download this repository to your local machine:

   git clone https://github.com/apon133/ClearWave.git

2. Open Google Chrome and navigate to chrome://extensions/.
3. Enable Developer mode using the toggle in the top-right corner.
4. Click Load unpacked and select the folder where you saved the extension files.

🖥 Supported Sites

Currently optimized for:

• YouTube
• Support for Netflix and others coming soon!

📝 Usage

1. Open a video or audio stream on a supported site.
2. Click the ClearWave icon in your extension toolbar.
3. Adjust the system/video volume to a level you find comfortable.
4. Click 📍 Set Reference Volume. ClearWave will now remember this as your "perfect" volume.
5. Turn on Auto Normalize to let ClearWave handle the rest!

🤝 Contributing

Contributions are welcome! If you'd like to help improve ClearWave, please:

1. Fork the repository.
2. Create a new branch (git checkout -b feature/AmazingFeature).
3. Commit your changes (git commit -m 'Add some AmazingFeature').
4. Push to the branch (git push origin feature/AmazingFeature).
5. Open a Pull Request.

📄 License

Distributed under the MIT License. See LICENSE for more information.

---

Created with ❤️ by apon133