vulkjjc / Gmail-deleter

Simple python script for mass deleting of emails on Gmail.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Gmail-deleter

Getting started

This script will help you delete unnecessary emails on gmail. It will provide you with options to delete all emails, emails from certain category and emails from a certain user . It also has additional features for emptying trash, deleting spam emails, getting statistics for email size, or displaying frequency of sent/received emails to/from a certain user.

Prerequisites

  • Python
  • The pip package management tool for Python
  • Access to Internet and a web browser
  • A Google account with Gmail account enabled
  • matplotlib for Python

Turn on Gmail API

Follow the instructions

Installation

  • Optional: Create a virtual environment

  • Run:

    pip install --upgrade google-api-python-client

(Check requirements.txt for additional informations about requirements for installation)

Usage

  • Copy json file generated from Gmail API to the repository directory

Run script inside src folder with:

python gmail_deleter.py

You can add extra options -s or --secret with a path to your "credentials.json" file.

python gmail_deleter.py -s credentials.json

The script provides the following options:

  • deletion of all messages
  • deletion of all messages from a certain category (i.e. Promotions, Forums, Social...)
  • deletion of all messages from a certain user
  • emptying trash
  • emptying spam

If one of the first three options are selected, those messages will be moved to the trash.

About

Simple python script for mass deleting of emails on Gmail.

License:GNU General Public License v3.0


Languages

Language:Python 100.0%