Twitter/X Bulk Mute Word List Importer

WHAT IT DOES

This userscript helps you quickly build a mute word list for Twitter/X by extracting words from any webpage. It scans any webpage for text-based lists of words or phrases—from articles, blocklists, or manual entry—displays the list with checkboxes, and allows you to select multiple words to import into your Twitter/X mute settings. It shows the source context of each word, filters by word length, and maintains a list of already imported words to avoid duplicates. It exports the list of selected words and provides a confirmation step before taking action. The script simulates the import action by copying the selected words to your clipboard so you can paste them into Twitter/X's mute settings.

WHERE IT RUNS

The script works on any webpage with text-based lists—blocklist pages, articles, forums, or any page with words or phrases. It runs entirely within your browser, reading only the visible content of the current page. It does not track your browsing history, access other tabs, or send any data externally. All word data and import history are stored locally.

HOW TO USE

After installation, open the panel by clicking the tool's icon in the BotGentz sidebar. Click "Scan for words" to extract words from the current page. The panel displays a list of words with checkboxes, showing the word and its context. Select the words you want to import into your mute list—use "Select All" to choose all. Click "Copy to Clipboard (for Twitter/X)" to copy the selected words to your clipboard. Then go to Twitter/X settings > Privacy and safety > Mute and block > Muted words, and paste the list. Click "Export Selected" to download a text file with the selected words. Use "Clear History" to reset the import history.

THE TECHNICAL MECHANISM

This script uses text extraction to identify words from page content. It splits text by common delimiters (newlines, commas, periods) and cleans each word by removing leading/trailing punctuation and converting to lowercase. It filters out short words (less than 3 characters), numbers, and non-alphabetic terms. It also scans list elements (li, .item, [class*="list-item"]) to extract words in structured lists. Words are deduplicated and stored with their source context (the line or item text they came from). The script stores the import history in GM_setValue so you don't see already-imported words in future scans. The export function creates a plain text file with the selected words. The clipboard copy uses GM_setClipboard to copy the selected words as a newline-separated list. All operations are client-side and do not send any data externally.

THE PANEL

The panel is draggable anywhere on the screen and remembers its position between sessions. It can be collapsed to a small floating bubble to minimize distraction, and expanded again with a single click. The panel's width can be adjusted, and pressing the Escape key closes it instantly. All settings—import history and auto-scan preference—are persisted locally using GM_setValue, so your data remains intact across page reloads and browser restarts.

PLEASE NOTE

This userscript requires the free BotGentz extension to function. The script extracts words from page text—it may not capture all words correctly. The script helps you prepare a mute word list—it does not directly add words to your Twitter/X account. You'll need to paste the copied list into Twitter/X's mute settings manually. The extraction relies on the current structure of the page—if the page uses a different format, the script may need to be updated. The script does not access your Twitter/X account or API; it only reads what is visible on the page. No data from your browsing is stored or transmitted anywhere—all processing occurs entirely in your browser.