https://github.com/stevenmaguire/imap-junk-pruner

Let's help keep our inboxes free from junk.
https://github.com/stevenmaguire/imap-junk-pruner

imap junk removal spam

Last synced: 6 days ago
JSON representation

Let's help keep our inboxes free from junk.

• Host: GitHub
• URL: https://github.com/stevenmaguire/imap-junk-pruner
• Owner: stevenmaguire
• License: mit
• Created: 2023-08-01T15:00:12.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2023-08-01T15:58:39.000Z (over 1 year ago)
• Last Synced: 2024-10-28T21:32:11.695Z (about 2 months ago)
• Topics: imap, junk, removal, spam
• Language: Python
• Homepage:
• Size: 8.79 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
## IMAP Junk Pruner

Let's help keep our inboxes free from junk.

### Up and running

Create a senders keyword list in `accounts` directory. Name the file `{email address}.csv`. Senders can be keywords, email addresses, domains - anything that you can use to search your inbox to find emails when prefixed with FROM.

```

# accounts/[email protected]

[email protected]

example.com

Politician Name

```

Run the tool.

```

$ python3 main.py {host} {email address} {password}

```

Available options:

| Option      | Parameters | Default | Example |

| ----------- | ----------- | ----------- | ----------- |

| Target Folder | `-tf` or `--target_folder`| `INBOX` | `-tf=INBOX/My\ Folder` |

| Buffer Folder | `-bf` or `--buffer_folder`| `None` | `-bf=INBOX/Bulk\ Delete` |

When executed, the tool will loop over the list of sender keywords, locate all matching messages, then delete them from the `target_folder`.

If a `buffer_folder` is specified, the messages will be copied to the `buffer_folder` before deleting from the `target_folder`. This is useful if you want to quarantine and review the candidate deletions.

### Tip

Unsubscribing from senders while you accumulate your sender keywords will help reduce the amount of future emails - hopefully.