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 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. ```