{"repo":"darcodev/email-cleaner","free":true,"listed":false,"github":"https://github.com/darcodev/email-cleaner","clone":"git clone https://github.com/darcodev/email-cleaner.git","description":"Zero-dependency Python CLI that bulk-cleans promotional email over IMAP - Gmail, Outlook, iCloud, Yahoo. Previews first; nothing deleted without asking.","language":"Python","stars":10,"topics":["cli","email","gmail","imap","inbox","python","command-line-tool","email-cleanup","icloud","inbox-cleaner"],"license":"MIT","category":"cli-tools","readme_excerpt":"email-cleaner Command line tool that clears promotional email out of your inbox over IMAP. You decide what gets cleaned (age, keywords, senders, categories), you preview it first, and nothing is permanently deleted unless you specifically ask for that. It works with Gmail, Outlook, Yahoo and iCloud out of the box, and any other IMAP server with one extra setting. No third-party packages, just the Python standard library. Contents - Why this exists - Install - Setup - App passwords - Usage - Filters in detail - The three ways to delete - How it decides what is promotional - AI-assisted filtering (optional) - Recipes - Best practices - Automating it - Safety and privacy - Troubleshooting - Exit codes - How it works - Contributing - License Why this exists Inbox filters and the Gmail Promotions tab hide marketing mail, but they do not delete the backlog. After a few years you can have tens of thousands of old receipts, newsletters and deal emails eating your storage quota. This tool goes through that backlog from the command line: you say what counts as junk, it shows you exactly what matched, and only then does it move anything. It never touches starred mail or senders you protect, and by default everything goes to Trash, where your provider keeps it recoverable for about 30 days. Install Needs Python 3.9 or newer. There are no third-party packages to install, only the standard library. The easiest way is pipx, which installs the email-cleaner command into its own isolated envi","default_branch":null,"files":null,"tree":[],"storefront":"/r/darcodev","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/darcodev/email-cleaner/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}