Smart Unsubscriber
Batch unsubscribe from mailing lists 📭
A CLI tool that detects mailing list emails by scanning for List-Unsubscribe headers and newsletter patterns, then helps batch unsubscribe from them.
Newsletter Overload
Mailing lists pile up over years. Unsubscribing one by one is painful and most people just ignore them, letting inbox clutter grow.
- 1Hundreds of mailing list subscriptions
- 2Unsubscribing one by one takes forever
- 3Hard to even find all subscriptions
- 4Wanted automated detection and batch action
Detect and Sweep
Scans emails for List-Unsubscribe headers and known newsletter patterns. Shows all subscriptions ranked by volume, then batch unsubscribe.
Auto Detection
Finds subscriptions via headers and sender patterns
Volume Ranking
See which lists send the most email
Batch Unsubscribe
Unsubscribe from multiple lists at once
Tracking
Remembers what you've already unsubscribed from
Screenshots
Technical Deep Dive
Architecture
Python script using gog CLI for Gmail access. JSON tracking file for unsubscribe state.
Tech Stack
Challenges & Solutions
Identifying newsletters accurately
Combination of List-Unsubscribe headers, known domains, and sender patterns
Safe batch operations
Preview mode and confirmation before any unsubscribe action
Results & Impact
Clean up years of newsletter subscriptions in minutes.
Highlights
- Finds subscriptions you forgot about
- Batch action saves hours of clicking
- Tracking prevents re-subscription
Lessons Learned
- →Email headers contain useful metadata
- →Batch operations need safety rails
- →Simple detection heuristics work surprisingly well