UnsubSweep

Press Start once and it clicks Unsubscribe for each sender on Gmail's Manage subscriptions page, up to 250 per run. No Gmail API, no OAuth, no server.

UnsubSweep is a Chrome extension (Manifest V3) that works through Gmail's Manage subscriptions page for you: it clicks Unsubscribe for each sender and confirms Gmail's dialog. It uses no Gmail API, no OAuth and no server; it clicks in the Gmail tab you already have open.

Status: preparing v1 for the Chrome Web Store. It is tested against a hand-written stand-in for Gmail's page, not yet on a live Gmail account. Until the listing is live, install it with Load unpacked. Website, docs and privacy policy: unsubsweep.vercel.app (source in web/).

The extension's own popup and loop, running in demo/ against the hand-written test fixture. This is not real Gmail.

There is no undo and no selection yet. A run goes through every sender on the page, and the extension cannot re-subscribe you. Only press Start when you want to leave every list shown.

Quick start

git clone https://github.com/tahmidbintaslim/gmail-auto-unsubscribe.git

1. Open chrome://extensions, turn on Developer mode and click Load unpacked. Select the cloned folder.
2. In Gmail, open Manage subscriptions (left menu, maybe under More).
3. Click the extension icon, then Start Unsubscribing. Press Stop at any time.

No npm install is needed to use it. To watch it run without Gmail, open the hosted demo or run npm run demo.

Contents

• Features
• How it works
• What it clicks
• When a run stops
• What it never does
• Privacy and account access
• Permissions
• Install (Load unpacked)
• Use
• Try the demo (no Gmail needed)
• Tech stack
• Development
• Project structure
• Deployment
• Manual test on real Gmail
• Status and roadmap
• Known limitations

Features

• One button: press Start in the popup and it goes down the sender list, from the bottom row up, until the list is done or you press Stop.
• Confirms Gmail's one-click Unsubscribe dialog. A sender without one-click unsubscribe is skipped, or, if you tick the box, sent to its own website in a new tab (at most 5 per run).
• Live counts in the popup: unsubscribed, skipped and websites opened. Closing the popup does not stop the run; open it again to see the counts.
• Bounded: at most 250 senders per press of Start, about one second between senders, and it stops as soon as the tab leaves the subscriptions list.
• Two permissions, activeTab and scripting. No host permissions, so Chrome shows no site-access warning on install.

How it works

sequenceDiagram
    actor You
    participant Popup as Popup (popup.html and popup.js)
    participant Tab as Gmail tab (unsubscriber.js and content.js)
    participant Gmail as Gmail page
    You->>Popup: Click the icon (grants activeTab), press Start
    Popup->>Popup: Check the tab is on mail.google.com
    Popup->>Tab: chrome.scripting.executeScript: unsubscriber.js, then content.js
    Popup->>Tab: START message
    Tab->>Tab: Check the address is the subscriptions list
    loop Each sender row, bottom up, at most 250
        Tab->>Gmail: Click the row's Unsubscribe
        Gmail-->>Tab: Dialog opens
        Tab->>Gmail: Click Unsubscribe if one-click, else Cancel (or Go to website if allowed)
        Tab-->>Popup: PROGRESS counts (dropped while the popup is closed)
    end

• popup.js checks the active tab and injects the two scripts only when you press Start. Nothing runs in Gmail before that.
• unsubscriber.js holds the loop: it finds sender rows and dialogs by their English labels, clicks, counts and enforces the limits.
• content.js passes Start, Stop and status messages between the popup and the loop.

This is the beginning of the README. Read the rest at the original. Read the full README ↗