🎵 AudioGrabber Browser Extension

AudioGrabber is a powerful browser extension designed to intelligently capture, edit, and save audio directly from any tab. Whether you're sampling music, grabbing sound effects, or recording speech, AudioGrabber makes the process seamless with its smart silence detection and built-in waveform editor.

✨ Features

• 🎙️ Smart Recording: Automatically starts recording when sound is detected and stops after a period of silence. No more manual trimming of long silences at the start or end.
• 🖥️ In-Page Overlay Interface: Operates as a draggable overlay directly on the page you are recording from, allowing you to control the process without leaving your content.
• 🌊 Waveform Visualization: Visualizes the captured audio as a detailed waveform for precise editing.
• 🔍 Zoom Precision: Use the mouse wheel to zoom in/out on the waveform for frame-perfect trimming.
• ✂️ Intuitive Trimming: Easily trim your recording by dragging start and end markers on the waveform.
• 🔁 Loop & Preview: Loop your selected region or preview the trimmed audio to ensure it's perfect before saving.
• 💾 High-Quality Export: Save your final edited clip as a high-quality .wav file.

🌐 Browser Support

AudioGrabber works seamlessly with all Chromium-based browsers, including:

• Google Chrome
• Microsoft Edge
• Brave
• Opera
• Vivaldi

🚀 Installation

1. Download Release: Go to the Releases page and download the latest AudioGrabber.zip.
2. Extract: Unzip the downloaded file to a folder on your computer.
3. Open Extensions Page:
   • Chrome: Navigate to chrome://extensions/
   • Edge: Navigate to edge://extensions/
4. Enable Developer Mode: Toggle the "Developer mode" switch (usually in the top right or left corner).
5. Load Unpacked: Click the "Load unpacked" button.
6. Select Directory: Browse to and select the folder where you extracted the extension.
7. Ready to Use: The extension is now installed! 🎉

📖 How to Use

1. Open the Menu: Right-click on any web page where you want to record audio.
2. Activate AudioGrabber: Select "AudioGrabber: Open" from the context menu. The overlay interface will appear.
3. Arm the Recorder: Click the "ARMED" button. The extension is now listening.
4. Play Audio: Start playing the audio on the webpage (e.g., a YouTube video, a music stream).
5. Automatic Capture:
   • 🔴 Recording starts automatically when sound is detected.
   • 🛑 Recording stops automatically after 2 seconds of silence.
6. Edit: Once recording stops, the waveform editor appears.
   • Zoom In/Out: Use your mouse wheel on the waveform for precise marker placement.
   • Drag the start and end handles to trim the audio.
   • Click "Play" ▶️ to preview the selection.
   • Toggle "Loop" 🔁 to repeat the selection during playback.
7. Save: Click "Save WAV" 💾 to download the trimmed audio file.
8. Reset: Use the reset buttons (arrows) to quickly snap the start/end markers back to their original positions.

🛠️ Tech Stack

• Manifest V3: Built using the latest Chrome Extension standards.
• Offscreen Documents: Uses the Offscreen API for audio capture, ensuring compliance and performance.
• WaveSurfer.js: Powered by WaveSurfer.js for beautiful and interactive waveform rendering.
• Web Audio API: Utilizes the Web Audio API for silence detection and audio processing.

🔒 Permissions

• tabCapture & offscreen: To capture tab audio stream.
• scripting: To inject the UI into the current page.
• contextMenus: To add the "Open" option to the right-click menu.
• activeTab: To access the current tab's content.

📄 License

MIT License