Skip to content
sebastianabantoPublic

About

Browser extension for Chrome & Edge that auto-pauses audio in your other tabs when one starts playing — never hear two sounds at once.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

5 Commits

Folders and files

Repository files navigation

AudiStop

Never hear two tabs play audio at once. AudiStop is a lightweight browser extension for Chrome, Edge, and other Chromium-based browsers (Brave, Opera, Vivaldi) that automatically pauses the audio in your other tabs the moment one starts playing. Switch from a music tab to a video, or from a podcast to a live stream, and the previous one pauses on its own — no more racing to find the tab that's making noise.

In short, it enforces one audio tab at a time: when a new tab starts making sound, the others are paused. Works with any site that plays media through a standard <video> or <audio> element — music streaming, video sites, podcasts, live streams, and web players alike.

Also useful if you're looking to: auto-pause background tabs, stop overlapping audio, pause other tabs when one plays, mute-free tab audio focus, or keep only one tab playing sound.

Manifest V3 Chrome & Edge License: MIT

Why a browser extension?

A browser reports all of its tabs as a single audio stream to the operating system — neither Windows' media APIs (SMTC) nor its audio APIs (WASAPI) can tell one tab apart from another. That's why a desktop app can't manage "tab vs tab" inside the same browser. The only layer that actually sees each tab is the browser itself, which is exactly where AudiStop runs.

Features

  • All tabs mode — any tab that starts playing pauses the rest. One sound at a time, zero configuration.
  • Selected sites mode — the rule applies only between the domains you choose; every other tab is left alone.
  • Real pause — it actually pauses the <video>/<audio> element (not just mute), so nothing keeps playing in the background. Press play again whenever you want.
  • Global on/off switch.
  • Bilingual UI — English and Spanish, chosen automatically from your browser's language (falls back to English).
  • Private & lightweight — no telemetry, no network requests, no accounts. Respects your dark mode.

Installation

Load unpacked (developer mode)

Same steps in Chrome and Edge:

  1. Download or clone this repository.
  2. Open chrome://extensions (or edge://extensions).
  3. Turn on Developer mode (top-right).
  4. Click Load unpacked and select the repository folder.
  5. The blue AudiStop icon appears in your toolbar (pin it if you like).
git clone https://github.com/sebastianabanto/audistop.git

Usage

Click the toolbar icon to open the panel:

  • Switch (top) — enable or disable the extension.
  • All tabs — the default; nothing to configure.
  • Selected sites — open a tab and click + Add this tab; repeat for the others. The auto-pause rule then applies only among those domains.

Use cases

  • Listening to music in one tab and clicking a video in another — the music pauses instead of playing on top of the video.
  • Juggling several video or streaming tabs and wanting only the one you're watching to have sound.
  • Reading with a podcast or lo-fi tab open, then opening something else that plays audio, without hearing both at once.
  • Anyone who constantly hunts for "which tab is making that noise?" and mutes it by hand.

How it works

The extension listens for the browser's per-tab audible signal. When a tab starts producing sound, a tiny script is injected into the other relevant tabs that pauses any playing media element. Pausing a tab makes it silent, so there's no feedback loop — when you manually press play on it again, it becomes the active source and the others pause instead.

Permissions

Permission Why it's needed
tabs Detect which tab is producing sound and read its domain.
scripting + <all_urls> Inject the small script that pauses media in the right tab.
storage Remember your mode and site list (chrome.storage.sync).

Limitations

  • Pauses standard <video>/<audio> elements. Sites that play sound without a standard media element may not respond.
  • Cannot inject into internal browser pages (chrome://…, edge://…, the extension store, PDFs); those tabs are ignored.

Privacy

AudiStop sends no data anywhere. Everything stays in your own browser profile via chrome.storage.sync. See background.js — it's a few dozen lines.

Project structure

File Role
manifest.json Manifest V3 definition.
background.js Service worker: detects the active tab and pauses the others.
popup.html · popup.css · popup.js Control panel (modes and site list).
_locales/ UI translations (English and Spanish).
icons/ Extension icons.
llms.txt Machine-readable project summary for AI tools (llmstxt.org).

FAQ

How do I stop two browser tabs from playing audio at the same time?

Install AudiStop and leave it in All tabs mode. Whenever a tab starts playing sound, every other tab that's playing is paused automatically, so only one plays at a time.

Does it mute the other tab or actually pause it?

It pauses the media (<video>/<audio>), it does not just mute it. Nothing keeps running silently in the background; you press play again when you want it back.

Which browsers are supported?

Any Chromium-based browser: Google Chrome, Microsoft Edge, Brave, Opera, and Vivaldi. It's a standard Manifest V3 extension.

Does it work with YouTube, Spotify Web, SoundCloud, Twitch, etc.?

Yes — it works with any site that plays sound through a standard HTML media element, which covers virtually all mainstream music, video, and streaming sites.

Can I limit it to just a couple of sites?

Yes. Switch to Selected sites mode and add the domains you want; the auto-pause rule then applies only among those, leaving every other tab untouched.

Is it free and open source?

Yes, it's free and MIT-licensed. The whole extension is a few small files with no dependencies and no build step.

Does it collect any data?

No. There is no telemetry and no network activity. Your settings live only in your browser profile via chrome.storage.sync.

Why an extension instead of a desktop app?

A browser exposes all its tabs to the operating system as a single audio stream, so a Windows app cannot tell one tab from another. Only code running inside the browser can act per tab — which is what this extension does.

Contributing

Issues and pull requests are welcome. The codebase is intentionally small and dependency-free.

License

MIT — free to use, copy, modify, and redistribute.

About

Browser extension for Chrome & Edge that auto-pauses audio in your other tabs when one starts playing — never hear two sounds at once.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages