WinClearCache Tool v2.0

WinClearCache is a fast, lightweight, and comprehensive system optimization tool designed to safely purge temporary files, browser caches, system logs, update files, and recycle bin data.

The primary utility is built natively for Windows as an Executable (.exe) and Batch Script (.bat) for instant, dependency-free execution. Additionally, WinClearCache v2.0 includes a Python Edition (WinClearCache.py) to extend cross-platform support across Windows, Linux, and macOS.

---

What's New in v2.0 🚀

• Core Executable & Batch Updates:
  • Real-time live verbose execution output during scans.
  • Interactive menu with Dry-Run mode to preview file deletions safely.
  • Fixed space-in-username path bugs (e.g., C:\Users\spidey\...).
  • Absolute path log directory display upon completion.
  • Enhanced multi-profile browser cache purging.
• Cross-Platform Python Module Support:
  • Multi-platform support for Windows, Linux, and macOS.
  • Purges temporary folder contents safely without deleting root system directories.
  • Integrated disk space analysis using psutil.

---

Executables & Downloads ⤵️

• Executable Application: Download WinClearCache.exe
• Batch Script: WinClearCache.bat
• Python Script: WinClearCache.py

---

Complete Execution Commands Reference ⚙️

Important: Running with Administrator or Root privileges is strongly recommended to clear system-level folders (such as Windows Update cache, Event Logs, or /var/log).

1. Windows Executable (WinClearCache.exe)

• Standard Interactive Launch (CMD / PowerShell):

  WinClearCache.exe

---

✍️ Author

Naresh R - Desktop Support Engineer | IT Infrastructure Enthusiast | Content Creator

• GitHub: @theNareshofficial
• YouTube: @nareshtechweb930
• Location: Bengaluru, Karnataka, India
• Philosophy: Learn → Build → Hack

---

🐍 Python Setup with Requirements

Method 1: Using requirements.txt (Recommended)

# Navigate to project directory
cd WinClearCache

# Install all dependencies from requirements.txt
pip install -r requirements.txt

# Or with Python 3 explicitly
pip3 install -r requirements.txt

# On Linux/macOS with sudo (if needed)
sudo pip3 install -r requirements.txt

Method 2: Manual Installation

# Install psutil directly
pip install psutil

# Or specific version
pip install psutil==5.9.0

Verify Installation

# Check if psutil is installed correctly
python -c "import psutil; print('psutil version:', psutil.__version__)"

# Or with Python 3
python3 -c "import psutil; print('psutil version:', psutil.__version__)"

Run WinClearCache After Setup

# Windows
python WinClearCache.py --full

# Linux/macOS
python3 WinClearCache.py --full

# With verbose output
python WinClearCache.py --full --verbose

---

🤝 Contributing

We warmly welcome contributions from the community! Whether you're fixing bugs, adding features, improving documentation, or sharing ideas, your contribution matters.

How to Contribute

1. Fork the Repository

   # Click "Fork" on GitHub to create your copy

2. Clone Your Fork

   git clone https://github.com/YOUR_USERNAME/WinClearCache.git
   cd WinClearCache

3. Create a Feature Branch

   git checkout -b feature/your-feature-name
   # Example: feature/add-custom-folder-cleanup

4. Make Your Changes

   • Fix bugs
   • Add new features
   • Improve documentation
   • Optimize code

5. Test Your Changes

   # Test with dry-run first
   python WinClearCache.py --dry-run
   
   # Test full functionality
   python WinClearCache.py --full --verbose

6. Commit Your Changes

   git commit -m "Add: meaningful description of your changes"
   # Examples:
   # git commit -m "Add: support for Chrome profile cleanup"
   # git commit -m "Fix: permission denied on system temp files"
   # git commit -m "Improve: documentation clarity"

7. Push to Your Branch

   git push origin feature/your-feature-name

8. Create a Pull Request

   • Go to GitHub and open a Pull Request
   • Describe your changes clearly
   • Link any related issues

Contribution Guidelines

• Bug Reports: Include error messages, OS version, and reproduction steps
• Feature Requests: Explain the use case and expected behavior
• Code Quality: Keep code clean, readable, and well-commented
• Testing: Test your changes on Windows, Linux, and macOS if possible
• Documentation: Update README and comments for new features

Areas for Contribution

• Bug fixes and error handling
• New cleanup targets and features
• Better documentation and tutorials
• Cross-platform testing and feedback
• International language support

Questions or Ideas?

• Open an Issue: For bugs or feature discussions
• Start a Discussion: For questions or ideas
• Contact: Reach out on GitHub or YouTube

---

🙏 Thank You

Special thanks to the open source community for inspiration, guidance, and the amazing tools that make projects like this possible.

Every contribution, no matter how small, makes a difference. Thank you for being part of the WinClearCache journey!

---

Happy Cleaning! 🧹