EmailCleaner

If you have a very cluttered email inbox or a mailbox overfilled with useless promotion emails, going through them one by one and deleting them is time-consuming and boring. That's why to help myself and others, I created this project that uses the Gmail API to make the deletion of thousands of mail take no more than three clicks.

This application works only for Gmail.

Demo

All messages are PERMANENTLY deleted and are not moved to trash box!

How to use

On the project GUI, from left to right, there are three main widgets:

1. Email selection dropdown
2. Option selection dropdown
3. Execute button

Email selection dropdown
This is used to select the organizations or people messagin you. All emails from them are automatically selected.

Option selection dropdown
This is used to select an options from an option list that includes the following:

• Scan Inbox: The first and only option, when opening the app, after scanning the inbox, more option will appear.
• Delete: This option lets you delete all the mail from a single sender or organization, which needs to be selected from the mail selection dropdown.
• Save: This option saves a sender's or organization's mails from batch deletion, which needs to be selected from the mail selection dropdown.
• Batch Delete: This option lets you delete all emails from senders or organizations that are in the mail selection dropdown menu, except the ones that are saved.
• Clear Saved: This option lets you clear the saved senders making them present in the mail selection menu thus making them deletable again.

Execute Button
This button when clicked will execute the command in the option menu dropdown.

The GUI has a message display field that will give instruction and information or error messages, making the project usage more straight forward.

Outside App Requirements

• Python 3.10.7 or greater
• The pip package management tool
• A Google account with Gmail enabled
• A Google Cloud project

Managing Gmail API

Follow these instructions.

Installation

• After completing the Gmail developer account and downloading the json file, rename it to credentials.json and put it in the app directory.
• Create a virtual environment.
• Activate the virtual environment.
• Install requirements.txt

Run The App

• Run main.py