Windows-Cleaner

Windows Cleaner 🧹✨

A safe, modern, and self-updating Windows cleanup tool with a beautiful terminal UI

Windows Cleaner is a lightweight, open-source utility that intelligently removes temporary files, browser caches, and other junk from your Windows system — all from a pleasant terminal interface.

Features

• Removes temp files from Windows system folders and popular apps (Chrome, Edge, Brave, Discord, Spotify…)
• Age-based deletion — only removes files older than a configurable threshold (default: 7 days)
• Beautiful TUI built with Textual — real-time progress, confirmation modals, settings panel
• Self-updating from GitHub — automatic or manual, preserves user config via smart merge
• Modular design — legacy CLI mode + modern Textual UI coexist
• Run as admin for maximum cleaning power

Requirements

• Windows 10 / 11
• Python 3.8+ (recommended: 3.12)
• Dependencies:

  pip install textual>=0.71.0 rich colorama requests

Quick Start

1. Clone the repository

   git clone https://github.com/n1h1lius/Windows-Cleaner.git
   cd Windows-Cleaner

2. (Recommended) Create virtual environment

   python -m venv venv
   .\venv\Scripts\activate

3. Install dependencies

   pip install textual rich colorama requests

4. Run the cleaner

   • Modern Textual UI (recommended):

     python main.py --main-menu

   • Direct cleaning (legacy mode):

     python main.py

   • Using batch wrappers (run as Administrator):

     cleaner.bat          REM → modern UI / main menu
     WindowsCleaner.bat   REM → legacy direct cleaning

Development / Roadmap Ideas

• Persistent file logging (cleaner.log)

License

MIT License — see LICENSE

Author

https://github.com/n1h1lius

---

Enjoy a cleaner Windows! 🧹✨

Star the repo if you find it useful! ⭐