InboxZero Tool (Gmail Label Manager)

InboxZero Tool is a powerful desktop application designed to help you clean up your Gmail inbox, reach Inbox Zero, and organize your digital life efficiently. It leverages the Gmail API to perform deep cleaning, advanced filtering, and bulk management tasks that the standard Gmail interface makes difficult.

Key Features

• 🧹 Deep Clean & Permanent Delete: Bypass the Trash folder to instantly delete thousands of emails and free up storage space.
• 🔍 Advanced Search:
  • Regex Filtering: Use Python Regular Expressions (e.g., ^no-reply.*) to filter senders locally.
  • Flexible Date Ranges: Quickly filter by "Last Month", "Last Year", or custom periods.
• 📊 Top Senders Analysis: Discover who is filling up your inbox.
• 🖱️ Context Menu Actions: Right-click on any sender to:
  • View all their emails.
  • Create a filter instantly.
  • Copy their address.
• 🏷️ Label & Filter Management: Create, rename, delete, and list labels and filters with ease.
• 📂 Large File Finder: One-click search for emails larger than 10MB.
• 🗑️ Empty Trash: Permanently delete all emails in the Trash folder.

⚠️ Warning: This tool performs destructive actions (permanent deletion). Use with caution and verify your queries before executing bulk actions.

---

Screenshots

---

Installation

Prerequisites

• Python 3.9+
• Gmail API Credentials (OAuth 2.0 Client ID for Desktop).

Setup

1. Clone the repository:

   git clone https://github.com/oxedinc/gmail-inbox-zero-tool.git
   cd gmail-inbox-zero-tool

2. Create a virtual environment:

   python -m venv .venv
   source .venv/bin/activate  # Windows: .venv\Scripts\activate

3. Install dependencies:

   pip install -e .

4. Configure Credentials:

   • Place your credentials.json file in the credentials/ folder.
   • On first run, a browser window will open to authorize the app.

Usage

Run the application:

python run.py

Tips

• Search Tab: Use this for analysis. Right-click on results to take action.
• Regex Field: Enter a Python regex pattern (e.g., @newsletter\.com) to filter the "Top Senders" list.
• Query Field (q): Accepts standard Gmail search operators (e.g., is:unread, larger:5M).

Project Structure

gmail_label_manager/
├── src/gmail_manager/  # Source code
├── credentials/        # OAuth credentials (ignored by git)
├── tests/              # Unit tests
├── run.py              # Entry point
└── README.md           # Documentation

Tags

python, gmail-api, email-cleaner, inbox-zero, productivity-tools, tkinter-gui, email-automation, spam-filter, bulk-delete, email-management, google-api, desktop-app, regex-search, digital-declutter, email-organizer, gmail-tools, open-source, python3, gui-application, automation

License

This project is licensed under the MIT License - see the LICENSE file for details.