Gmail Bulk Unsubscribe from Selected Senders

WHAT IT DOES

This userscript helps you clean up your Gmail inbox by identifying and bulk-selecting senders you want to unsubscribe from. It scans Gmail inbox or email list pages for sender email addresses, displays a list of unique senders with checkboxes, and allows you to select multiple senders to bulk unsubscribe. It detects the unsubscribe link in emails or opens the sender's website to find the unsubscribe page. The script shows the number of emails from each sender, filters by sender domain, and maintains a list of already unsubscribed senders to avoid duplicates. It exports the list of selected senders and provides a confirmation step before taking action.

WHERE IT RUNS

The script works on Gmail inbox pages, email list pages, and any webpage with sender email addresses. 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 sender data and unsubscribe 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 senders" to extract email addresses from the current page. The panel displays a list of unique senders with checkboxes, showing the number of emails per sender and their domain. Select the senders you want to unsubscribe from—use "Select All" to choose all. Click "Unsubscribe Selected" to mark them as unsubscribed and add them to your history. Click "Export Selected" to download a text file with the selected email addresses. Use "Clear History" to reset the unsubscribe history.

THE TECHNICAL MECHANISM

This script uses regex pattern matching to extract email addresses from page text and HTML elements. It scans for email patterns (e.g., user@domain.com) and looks for sender-specific elements with class names like "sender", "from", "author", or data-email attributes. It deduplicates senders, filters out those already in the unsubscribe history, and counts email occurrences in the page text. The script stores the unsubscribe history in GM_setValue so you don't see already-unsubscribed senders in future scans. The export function creates a plain text file with the selected email addresses. 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—unsubscribe 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 email addresses from page text and helps you track which senders you've unsubscribed from. It does not automatically send unsubscribe requests—you'll need to manually click unsubscribe links in emails or visit sender websites. The script is a helper tool to identify and track senders you want to unsubscribe from. The extraction relies on the current text patterns on the page—if Gmail or other email clients update their UI, the script may need to be updated. The script does not access your Gmail 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.