Gmail Regex Rules Manager

Gmail Regex Rules Manager - Powerful Email Automation for Gmail

Take control of your Gmail inbox with intelligent, regex-based automation. Create custom rules to automatically organize, label, and manage your emails as they arrive - no more manual sorting!

✨ KEY FEATURES

🎯 Powerful Pattern Matching • Match emails by sender (From field) • Match emails by recipient (To field) • Match emails by subject line • Match emails by email body/snippet • Use regex patterns for precise matching • Live Regex Helper for testing patterns in real-time

⚡ Automated Actions • Automatically add or remove labels • Mark emails as read/unread • Star important emails • Mark as important/not important • Archive emails automatically • Move to trash • Combine multiple actions per rule

🔄 Real-Time Processing • Monitors Gmail for new emails automatically • Processes emails as they arrive • Configurable scan interval (1-60 minutes) • Works silently in the background • Retry logic with exponential backoff • Reliable and efficient processing

🎨 User-Friendly Interface • Clean, intuitive popup interface • Create rules with visual form builder • Drag & drop to reorder rule priority • Enable/disable individual rules • Test rules before applying them • Live regex pattern testing • Import/export rules for backup

📊 Statistics & Performance • Per-rule match statistics • See how many emails each rule processed • View last matched timestamp • Performance metrics tab • Processing time tracking • Configurable data retention • Copy stats to clipboard (TSV format)

⚙️ Advanced Settings • Adjustable log levels (error/warn/info/debug) • Configurable processing interval • Performance data retention control • Auto-processing toggle • Easy OAuth configuration

⌨️ Keyboard Shortcuts • Ctrl+N - Create new rule • Ctrl+T - Jump to test tab • Ctrl+S - Save current rule • Esc - Cancel editing

🔒 PRIVACY & SECURITY

Your data, your control: • Extension requires your own Google OAuth credentials • You maintain full control of API access • No third-party servers involved • All processing happens locally in your browser • Open source - review the code yourself • You can revoke access anytime

GETTING STARTED

1. Set Up OAuth Credentials • Follow our detailed OAUTH_SETUP guide • Create your own Google Cloud Project (free) • Get your OAuth Client ID • Configure the extension with your credentials

2. Create Your First Rule • Click the extension icon • Go to "Create Rule" tab • Enter a name (e.g., "Newsletters") • Add regex patterns (e.g., From: ".newsletter.") • Choose actions (e.g., Add label "Newsletters", Mark as read) • Click Save

3. Test Your Rules • Use the "Test" tab to verify rules work correctly • Live Regex Helper shows real-time pattern matching • See which rules match your sample emails

4. Enjoy Automation! • Extension monitors Gmail automatically • New emails are processed based on your rules • Check the Stats tab to see activity

COMMON USE CASES

📰 Newsletter Management Pattern: From contains "newsletter|subscribe|unsubscribe" Actions: Label as "Newsletters", Mark as read, Archive

🚨 Urgent Emails Pattern: Subject contains "urgent|asap|important" Actions: Star, Mark as important, Label as "Priority"

💼 Work Emails Pattern: From contains "@yourcompany.com" Actions: Label as "Work", Keep in inbox

🤖 Automated Notifications Pattern: From contains "noreply|no-reply|notifications" Actions: Label as "Automated", Archive, Mark as read

🛍️ Shopping & Receipts Pattern: Subject contains "receipt|order|invoice|shipment" Actions: Label as "Shopping", Label as "Receipts"

🗑️ Spam Management Pattern: Body contains specific spam keywords Actions: Mark as read, Move to trash

REQUIREMENTS

• Chrome browser (version 88+) • Gmail account • Google Cloud Project (free to create) • OAuth 2.0 credentials (follow our setup guide)

PERMISSIONS EXPLAINED

• Storage - Save your rules and settings locally • Identity - Authenticate with your Google account • Alarms - Schedule periodic email checks • Gmail API - Read and modify your emails (via OAuth)

SUPPORT & DOCUMENTATION

📖 Complete documentation included: • OAUTH_SETUP.md - Step-by-step credential setup • QUICKSTART.md - Get started in 5 minutes
• CHANGELOG.md - Version history • TROUBLESHOOTING.md - Common issues and solutions • Example rules - 10 pre-built patterns to import

🐛 Found a bug or have a suggestion? Visit our GitHub repository to report issues or request features.

TECHNICAL DETAILS

• Built with Chrome Extension Manifest V3 • Uses Gmail API for reliable access • Service worker architecture for efficiency • Comprehensive error handling and retry logic • Structured logging with adjustable verbosity • Performance tracking and optimization • 19 automated tests ensuring quality

VERSION HISTORY

v1.1.0 - Latest Release • OAuth configuration UI with setup guide • Live regex pattern testing • Keyboard shortcuts system • Per-rule statistics tracking • Drag & drop rule ordering • Copy stats to clipboard • Configurable settings (interval, retention, log levels) • Visual polish and animations • Comprehensive documentation

v1.0.0 - Initial Release • Regex-based email matching • Automated actions (label, read, star, archive, trash) • Real-time email monitoring • Rule management UI • Import/export functionality

OPEN SOURCE

This extension is open source! Review the code, contribute improvements, or fork it for your own needs. We welcome community contributions.

Made with ❤️ for productivity enthusiasts who want to master their inbox.

Keywords: gmail, email automation, regex, rules, labels, productivity, inbox management, email filtering, automation, organize