X Mute Word Batch Adder

WHAT IT DOES

X Mute Word Batch Adder is a browser extension that automatically scans the current X (Twitter) page for mute word settings, mute list, and mute input fields. It detects mute-related elements by examining class names, IDs, and data attributes for patterns like "input[placeholder*='mute']", "[class*='mute']", and mute settings containers. The extension adds a floating batch add button (🔇) next to the mute settings, providing quick access to batch mute controls. Clicking the button opens a panel where you can batch add mute words, import word lists, set mute durations, and store mute history locally. The panel provides a text area where you can enter multiple mute words (one per line), select mute duration (Forever, 1 day, 7 days, or 30 days), and click "Add Mute Words" to batch apply them. You can also load preset word lists for common categories like SPAM words or political keywords. The extension maintains a mute word database with mute history, notes, and tags. The main panel shows mute history with words, durations, and timestamps. All data is stored locally in your browser using GM_setValue, ensuring your mute history persists across page reloads and browser sessions. This helps X (Twitter) users who want to quickly mute multiple keywords or phrases for content filtering, reducing unwanted content in their timeline.

WHERE IT RUNS

This extension runs on any X (Twitter) page that displays mute word settings, mute list, or mute input fields – including X (Twitter) settings pages, mute word management pages, and any page with mute controls. The extension intelligently adapts to different page structures and supports a wide range of common X display patterns. No manual configuration is required per site; the extension automatically detects mute elements using a flexible pattern matching system. This makes it ideal for X users who want to batch mute multiple words.

HOW TO USE

Simply install the extension and navigate to any X (Twitter) page with mute word settings. The extension automatically detects mute controls and shows a batch add button (🔇) next to the mute settings. Click the button to open the batch mute panel. The panel provides a text area where you can enter mute words (one per line). Select the mute duration from the dropdown (Forever, 1 day, 7 days, or 30 days). Click "Add Mute Words" to batch add all the words to your mute list. You can also use preset word lists by clicking "📋 Common SPAM words" or "📋 Politics" to load predefined word lists. A floating button (🔇) appears in the bottom-right corner of the page – click this to open the panel from anywhere. The panel also shows your mute history with words, durations, and timestamps. Use the settings section to set your default mute duration. The "Clear All Mute Data" button removes all tracking data when needed.

ONE TECHNICAL SECTION – WHY IT WORKS

The extension uses DOM detection and event simulation to batch add mute words. The detection system uses a comprehensive set of CSS selectors targeting mute input fields, mute lists, and mute settings containers. When batch adding words, the extension processes each word sequentially with a 500ms delay between additions to avoid rate limiting. For each word, the extension finds the mute input field, sets the value using the native setter, and dispatches both "input" and "change" events to ensure React and Vue applications recognize the value change. The extension then locates the add or submit button and triggers a click event. If a duration selector is present, the extension selects the appropriate duration before submission. Each successful mute addition is logged to the local database with the word, duration, and timestamp. Preset word lists are loaded from predefined arrays. A MutationObserver detects dynamic content updates and re-scans only when new mute elements appear, balancing real-time accuracy with system performance.

THE PANEL – DRAG / PER-SITE POSITION / SNAP / COLLAPSE / RESIZE / ESCAPE

The batch mute panel includes a draggable title bar, allowing you to position it anywhere on screen for convenient access during content filtering setup. The extension remembers your preferred position per website, so the panel opens in the same location each time you return to that domain. The panel supports snap-to-edge behavior – when dragged near screen edges, it gently snaps into place for a tidy workspace layout. You can collapse the panel down to just its title bar by clicking the collapse button, keeping it accessible without taking up screen space. The word input and history are contained within a scrollable body, ensuring all content remains accessible even on smaller screens. Pressing the Escape key closes the panel instantly, returning you to your X (Twitter) settings workflow.

PLEASE NOTE

This extension requires the free BotGentz extension to be installed and enabled, as it relies on BotGentz's userscript injection and GM_* API shims for cross-browser compatibility. Websites frequently update their HTML structures and class names, which may cause mute detection to break temporarily – we actively maintain the matching patterns and release updates regularly. The extension stores all mute word data, history, and notes exclusively in your local browser storage (GM_setValue); no data is ever transmitted to any external server or third party. The extension does not read, modify, or interfere with any X (Twitter) content or functionality beyond the mute controls – it operates on the page content and stores only metadata (mute words, durations, timestamps, and notes) that you explicitly create. You are responsible for backing up your mute history data if you switch browsers or clear your storage. Use this tool responsibly and in accordance with X's Terms of Service.