Autoplay Audio Muter

WHAT IT DOES

This script automatically detects and mutes autoplaying audio and video elements on any page—HTML5 video, audio tags, YouTube embeds, Vimeo players, and other embedded media. It sets volume to 0 or uses the browser's muted property, and also pauses playing media. A counter badge shows how many elements were muted, and per-site memory prevents re-muting on repeat visits. Enjoy browsing without unexpected sound—autoplay media stays silent until you choose to unmute it.

WHERE IT RUNS

The script works on any page with autoplaying media—news sites, social media, video platforms, blogs, and any website with video or audio content. It detects HTML5 video and audio elements, YouTube and Vimeo embeds, and other embedded players. The script handles both static and dynamically loaded media.

HOW TO USE

After installation, the script automatically mutes media based on your settings. A badge appears showing the count of muted elements. Click the badge to open the panel. Customize: enable or disable auto-muting, choose mute delay (ms), set max attempts, enable muting on page load or on scroll (with configurable threshold), enable per-site memory, show/hide the count badge, choose badge position, toggle debug mode, and select which media types to mute (HTML5 videos, HTML5 audio, embedded players). Click "Scan & Mute Now" to manually trigger a scan.

TECHNICAL MECHANISM

The script uses a multi-stage media detection and muting pipeline. First, it scans the DOM for HTML5 video and audio elements using tag selectors, and embedded players using comprehensive iframe/embed selectors for YouTube, Vimeo, Dailymotion, Twitch, SoundCloud, Spotify, and others. Second, it checks if the element is already muted by examining the `muted` property for HTML5 media, or the URL parameters for embeds (mute=1, muted=1). Third, it applies muting: for HTML5 media, it sets `muted = true` and `volume = 0`, and pauses playback; for YouTube embeds, it modifies the iframe src to include `&mute=1` and sends a postMessage mute command; for Vimeo embeds, it adds `&muted=1` and sends a volume command. Fourth, it stores muted URLs in per-site storage using GM_setValue. The script uses a MutationObserver for dynamically loaded media and tracks iframe loads.

THE PANEL

The settings panel is fully draggable and can be positioned anywhere on your screen. It automatically snaps to the nearest edge when released, keeping your workspace organized. The panel can be collapsed to a small bubble showing only a gear icon, and restored with a single click. Its position is remembered across page reloads using GM_setValue. The panel also responds to the Escape key, which instantly hides it until you click the bubble again. All settings are saved immediately when changed and persist across browser sessions.

PLEASE NOTE

This script requires the free BotGentz extension to run. Muting embedded players relies on iframe communication which may not work for all players or sites. The script does not access, store, or transmit any personal data or browsing history. All processing happens locally in your browser and never leaves your device.