Skip to content

peerjakobsen/mailstrom-app

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

20 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Platform: macOS License: MIT Status: In Development Website

Mailstrom

Bulk-clean your Gmail inbox by sender — see who's flooding you, unsubscribe, and delete in one click.

Features

  • Sender tree view — Emails grouped by domain and sender with counts
  • Bulk delete — Select senders and trash all their emails at once
  • Unsubscribe detection — Finds unsubscribe links and opens them in your browser
  • Smart categorization — Auto-detects newsletters, notifications, and transactional emails
  • Incremental sync — Only fetches new emails after the initial scan
  • Privacy-first — Everything runs locally on your Mac, no cloud servers

Tech Stack

  • Framework: Flutter (Dart)
  • State management: Riverpod
  • Database: SQLite via Drift
  • API: Gmail API with OAuth 2.0
  • Platform: macOS (Windows/Linux planned)

Install

  1. Download Mailstrom.dmg from the latest release
  2. Open the DMG and drag mailstrom.app to Applications
  3. Remove the quarantine flag (required for unsigned apps):
    xattr -cr /Applications/mailstrom.app
  4. Open the app from Applications

Development

git clone https://github.com/peerjakobsen/mailstrom-app.git
cd mailstrom-app/mailstrom
flutter pub get
flutter run -d macos

You'll need a google_oauth_credentials.json file with your Google OAuth client credentials in the project root. See Google's OAuth 2.0 guide for setup.

License

MIT

Website

mailstrom.mentilead.com

About

Bulk-clean your Gmail inbox by sender — see who's flooding you, unsubscribe, and delete in one click.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages