Gmail Bulk Archive by Sender

WHAT IT DOES

This userscript helps you clean up your Gmail inbox by identifying and bulk-selecting senders whose emails you want to archive. 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 archive all emails from those senders. It shows the number of emails from each sender, filters by sender domain, and maintains a list of already archived senders to avoid duplicates. It exports the list of selected senders and provides a confirmation step before taking action. The script also simulates the archive action by marking emails as read or moving them to the archive label.

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 archive 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 archive—use "Select All" to choose all. Click "Archive Selected (Track)" to mark them as archived and add them to your history. Click "Search in Gmail" to open a Gmail search for all emails from the selected senders, so you can manually archive them. Click "Export Selected" to download a text file with the selected email addresses. Use "Clear History" to reset the archive 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 archive history, and counts email occurrences in the page text. The script stores the archive history in GM_setValue so you don't see already-archived senders in future scans. The search function builds a Gmail search query with "from:email1 OR from:email2" and opens it in a new tab. 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—archive 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 archived. It does not automatically archive emails—you'll need to use the "Search in Gmail" feature to find and manually archive them. The script is a helper tool to identify and track senders you want to archive. 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.