Skip to content

Repository files navigation

AudioEX

AudioEX is a small Chrome extension for changing the audio of individual tabs. It uses Chrome's tab capture and Web Audio APIs, and all processing stays inside the browser.

Features

  • 10-band equalizer with ±12 dB per band
  • Compressor / soft limiter with threshold and ratio controls
  • Volume amplifier with up to +12 dB of boost
  • Mono routing with three modes:
    • Copy left to right
    • Copy right to left
    • Sum left and right to both channels
  • Independent enable switch for every processor
  • Per-tab capture with settings remembered for the next tab
  • Multiple captured tabs at the same time

The mono sum is normalized as (L + R) / 2 to preserve headroom. The compressor sits after the equalizer and amplifier so it can catch their boosted output.

Install

AudioEX requires Chrome 116 or newer.

  1. Clone this repository or download and extract its source.
  2. Open chrome://extensions in Chrome.
  3. Turn on Developer mode.
  4. Select Load unpacked.
  5. Choose the repository folder containing manifest.json.
  6. Pin AudioEX from Chrome's extensions menu if desired.

Use

  1. Open a tab that is playing audio.
  2. Open AudioEX and select Enable on this tab.
  3. Enable and adjust any processors.
  4. Close the popup. Processing continues until the tab is closed, capture ends, or Disable on this tab is selected.

The toolbar badge reads ON while a tab is being processed. Each newly captured tab requires an explicit click. Chrome internal pages cannot be captured, and reloading or updating the extension ends active captures.

Audio chain

Captured tab
  -> 10-band EQ
  -> stereo / mono routing matrix
  -> volume amplifier
  -> compressor / matched bypass
  -> browser audio output

Chrome stops the tab's original local playback while it is captured. AudioEX reconnects the processed signal to the browser output, including when every processor is bypassed.

The compressor uses the browser's DynamicsCompressorNode. It behaves as a soft limiter, not a guaranteed brick-wall limiter. Its bypass path has a matching 6 ms delay so enabling it does not change timing.

Privacy

AudioEX has no analytics, network requests, content scripts, or host permissions. Captured audio is processed locally and is never saved or transmitted.

Development

The extension uses browser-native JavaScript modules and has no runtime or development dependencies.

npm run check

This runs syntax checks, Node unit tests, manifest checks, and real Web Audio tests in headless Chrome. Set CHROME_PATH if Chrome or Chromium is installed somewhere unusual.

License

MIT

About

Per-tab equalizer and audio controls for Chrome

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages