A Python-based desktop utility that automates routine system cleanup tasks—like deleting temporary files, empty folders, and recycle bin contents—while ensuring data safety through whitelist protection and email-based confirmation.
- ✅ Scheduled Cleanup: Run automatic cleanups on custom days and times.
- 📧 Email Confirmation: Sends a confirmation email before cleanup; proceeds only on “YES” reply.
- 🧾 Whitelist Protection: Never deletes user-defined critical files or folders.
- 📈 Disk Usage Reporting: See storage saved before and after each cleanup.
- 🔔 Desktop Notifications: Instant feedback after completion or cancellation.
- 🖥️ User-Friendly GUI: Configure schedule, whitelist, and email in a Tkinter interface.
- 🧰 Cross-Platform Support: Works on both Windows and Linux systems.
- Python 3.x
- Tkinter – GUI
psutil
,plyer
,schedule
,smtplib
,imaplib
,json
,threading
- Clone the Repository
git clone https://github.com/your-username/your-repo-name.git cd your-repo-name
2.Install Required Libraries
pip install psutil plyer schedule
python main.py
Make sure to set up your Gmail app password for sending emails (due to 2FA).
Email sender/receiver Whitelist file Scheduled day and time Stored in config.json
This tool never performs cleanup without user confirmation via email. You stay in full control with features like: Email prompts Manual "Stop Cleanup" button Whitelist enforcement
Cloud-based cleanup scheduling AI-based cleanup suggestions Voice assistant or chatbot interface Remote control via web dashboard
P. Thirupathi Reddy M. Amani P. Akshitha R. Ramana V. Nikitha
Mr. E. Satish Babu, Assistant Professor, Dept. of CSE, Jyothishmathi Institute of Technology and Science
This project is for academic demonstration purposes. For reuse or adaptation, please contact the authors.
See the full project report for detailed literature review, architecture, testing, and results.