Tab Sound Indicator Enhancer

WHAT IT DOES

This script transforms the tiny, easily-overlooked speaker icon on audio-playing tabs into a bold, customizable visual indicator that you can actually see. Choose any color, adjust the size from small to large, and select from pulse or glow animations to make audio-indicating tabs stand out instantly. The script also adds a persistent mute/unmute state badge directly on the indicator, so you always know whether a tab is muted at a glance—without clicking or hovering.

WHERE IT RUNS

The script runs on every website you visit—video players, music streaming services, web conferencing tools, social media feeds, and any page with an audio or video element. It works seamlessly across all modern browsers that support the BotGentz extension, including Chrome, Firefox, Edge, and Brave.

HOW TO USE

Once installed, the script adds a small settings panel to your page. Use the color picker to set your preferred indicator hue. Choose a size that fits your visual needs—Small for minimal distraction, Medium for balanced visibility, or Large for maximum awareness. Pick an animation style: Pulse for subtle attention, Glow for a radiant effect, or None for a static indicator. Toggle the mute state display on or off depending on your preference. Click "Apply now" to refresh the enhancement on the current page, or "Reset defaults" to revert to the original settings.

TECHNICAL MECHANISM

The script uses a mutation observer to monitor the DOM for newly added audio and video elements, then applies CSS customizations directly to their control indicators. Instead of relying on browser-specific tab APIs (which are unavailable in userscript contexts), it targets visible audio controls and speaker icon elements using a comprehensive set of CSS selectors. It preserves the original element display properties and injects keyframe animations via GM_addStyle, ensuring smooth, performant transitions without interfering with page functionality. The mute state is detected by checking the element's muted property and ARIA attributes, then displaying a badge overlay positioned absolutely relative to the indicator.

THE PANEL

The settings panel is draggable to any position on the screen and automatically snaps to the nearest edge when released for a clean workspace. It can be collapsed to a small bubble showing just the gear emoji, and expanded again with a single click. The panel remembers its position across page reloads via GM_setValue. Press the Escape key at any time to hide the panel temporarily, and click the bubble to bring it back. All changes are saved immediately and persist across browser sessions.

PLEASE NOTE

This script requires the free BotGentz browser extension to run. Websites frequently update their HTML structures and CSS classes, which may cause the indicator detection to stop working on specific sites. If you notice the enhancement is no longer applying, check for script updates or report the issue to the developer. The script does not collect, store, or transmit any personal data, browsing history, or page content. All settings are stored locally in your browser's userscript storage and never leave your device.