Skip to content

RaneKun/Windows-Cache-Cleaner

Repository files navigation

🧹 Windows Cache Cleaner

Windows Cache Cleaner Icon

A simple, safe, and powerful tool to clean unnecessary cache files on Windows — without touching anything important.


📖 Overview

Windows Cache Cleaner is a user-friendly desktop application that helps you reclaim disk space by safely removing temporary files, cache data, and other unnecessary junk that accumulates over time on Windows systems.

Version 2.0 brings a completely redesigned experience with multi-threading, real-time progress tracking, and an intuitive interface that makes cache cleaning effortless.


✨ Key Features

🎯 Smart & Safe Cleanup

  • 19 Different Cleanup Options — From browser caches to Windows Update remnants
  • Safe by Design — Only targets non-critical cache folders
  • Detailed Tooltips — Hover over any option to see exactly what it cleans
  • Confirmation Dialogs — Prevents accidental deletions

⚡ Powerful Performance

  • Non-Blocking UI — Application stays responsive during cleanup
  • Real-Time Progress — Live progress bar and status updates
  • Analyze Mode — Preview how much space you'll free before cleaning
  • Cancellable Operations — Stop cleanup at any time

📊 Transparency & Control

  • Live Operation Log — See exactly what's being cleaned in real-time
  • Detailed Reports — Shows files deleted, space freed, and any errors
  • Persistent Settings — Remembers your cleanup preferences
  • Comprehensive Logs — All operations logged to file for review

🎨 User Experience

  • Comic Sans MS UI — Friendly, approachable interface
  • Windows Theme Integration — Matches your system accent color
  • Select All / Analyze / Clean — Three-step workflow
  • No Installation Required — Portable standalone executable

🚀 What This Tool Cleans

This cleaner targets only safe-to-remove cache folders, including:

Category What Gets Cleaned Typical Space Saved
🗂️ Temp Files Windows & User temporary files 1-10 GB
🌐 Browser Caches Chrome, Edge, Firefox, Opera, Brave 500 MB - 5 GB
📦 Windows Update Downloaded update files 500 MB - 5 GB
🎮 GPU Shader Cache NVIDIA, AMD shader compilations 100 MB - 2 GB
🏪 Windows Store UWP app caches 200 MB - 3 GB
📸 Thumbnails Icon and thumbnail caches 50 MB - 500 MB
💥 Crash Dumps System and app crash files 100 MB - 5 GB
📝 System Logs Windows event and error logs 100 MB - 2 GB
⚙️ WinSxS Component store cleanup (via DISM) 2 GB - 20 GB
...and more! Prefetch, WebCache, RDP cache, etc. Variable

Total Potential Savings: 5 GB to 50+ GB depending on system age and usage


📂 What's Included

Windows-Cache-Cleaner/
│
├── 📄 README.md                          ← You are here
├── 📄 LICENSE                            ← RaneKun Open-Use License
├── 📄 CHANGELOG.md                       ← Version history
│
├── 🖼️ windows_cache_cleaner.ico         ← Application icon
│
├── 🔧 windows_cache_cleaner_IMPROVED.py  ← Full source code (Python + PyQt6)
│
├── 🛠️ build_exe.bat                      ← Build script (Windows)
├── 🛠️ build_exe.py                       ← Build script (Python)
├── 📄 BUILD_INSTRUCTIONS.md              ← How to build the .exe
│
└── 📦 dist/
    └── Windows Cache Cleaner.exe         ← Standalone executable

🎮 How to Use

Option 1: Standalone EXE (Recommended)

  1. Download the latest release from the Releases page
  2. Extract the ZIP file
  3. Right-click Windows Cache Cleaner.exeRun as administrator
  4. Select cleanup options (or click "Select All")
  5. Optional: Click "Analyze 🔍" to preview space savings
  6. Click "Run Cleanup 🚀"
  7. Wait for completion and review the results

Option 2: Run from Source

Requirements:

  • Python 3.10 or higher
  • PyQt6

Steps:

# Install dependencies
pip install PyQt6

# Run the application
python windows_cache_cleaner_IMPROVED.py

🛡️ Safety & Security

What Makes This Tool Safe?

No Critical System Files — Only cleans cache folders that Windows recreates automatically
Admin Rights Required — Ensures you're aware of what the tool is doing
Detailed Tooltips — Full transparency about what each option does
Confirmation Dialogs — Asks before making any changes
Comprehensive Logging — Everything is logged for review
Open Source — You can inspect the code yourself

Antivirus False Positives

Note: Some antivirus software may flag the .exe as suspicious. This is a false positive common with PyInstaller-built executables.

Why this happens:

  • PyInstaller bundles the Python interpreter into the .exe
  • This packaging method can resemble some malware packers
  • The tool requires admin rights (which is flagged by heuristics)

What you can do:

  • Check the source code yourself (it's fully available)
  • Build the .exe yourself using the included build scripts
  • Add the .exe to your antivirus whitelist
  • Submit it to your antivirus vendor as a false positive

🎨 Screenshots

Main Interface

Screenshot 2026-01-20 030250

Analyze Mode

Screenshot 2026-01-20 030254

Live Operation Log

Screenshot 2026-01-20 030400

🔧 Building from Source

Want to build the .exe yourself?

Quick Build (Windows):

  1. Put all files in a folder
  2. Double-click build_exe.bat
  3. Wait 2-5 minutes
  4. Find your .exe in the dist folder

Manual Build:

# Install PyInstaller
pip install pyinstaller

# Build the executable
pyinstaller --onefile --windowed --name "Windows Cache Cleaner" --icon=windows_cache_cleaner.ico --add-data "windows_cache_cleaner.ico;." windows_cache_cleaner_IMPROVED.py

See BUILD_INSTRUCTIONS.md for detailed build instructions.


📊 Version History

v2.0.0 (Current)

Major Rewrite — Complete overhaul with modern features

New Features:

  • Multi-threaded cleanup (UI never freezes)
  • Real-time progress bar and status updates
  • Analyze mode (preview space savings)
  • Live operation log
  • Stop/cancel functionality
  • Size tracking (shows exactly how much space freed)
  • Confirmation dialogs
  • Better error handling

Improvements:

  • Comic Sans MS font throughout
  • Windows accent color integration
  • Proper app data directory (%LOCALAPPDATA%\WindowsCacheCleaner)
  • Better code organization and documentation
  • No debug print spam

Bug Fixes:

  • Fixed UI freezing during cleanup
  • Fixed missing Select All button functionality
  • Fixed DISM cleanup console window issue

v1.0.0

Initial public release


💡 Tips & Best Practices

  1. Run Regularly — Weekly or monthly cleanups keep your system fresh
  2. Analyze First — Use Analyze mode to see what you'll gain
  3. Close Browsers — Close all browsers before cleaning browser caches
  4. Keep Logs — Review logs if something seems off
  5. Safe Options — Start with safe options, add more aggressive ones later

🐛 Known Issues

  • Antivirus False Positives — See "Safety & Security" section above
  • Some Files May Be Locked — Files in use won't be deleted (this is normal and safe)
  • DISM Takes Time — WinSxS cleanup can take 5-15 minutes (be patient)

🤝 Contributing

This is a personal project, but feedback and suggestions are welcome!

Ways to contribute:

  • Report bugs via Issues
  • Suggest new cleanup locations (if safe)
  • Share your experience and results
  • Improve documentation
  • Submit bug fixes (pull requests welcome)

📜 License

This project is released under the RaneKun Open-Use License.

You CAN:

✅ Use the tool freely for personal use
✅ Read and study the source code
✅ Modify the code for personal use
✅ Share the original or modified versions
✅ Use it for educational purposes

You CANNOT:

❌ Sell this software or derivatives
❌ Use it in commercial projects without permission
❌ Remove or modify attribution to RaneKun
❌ Claim it as your own work

You MUST:

✔️ Give proper credit to the original creator (RaneKun)
✔️ Include the original license in any distributions
✔️ Keep modifications open source (if distributed)

TL;DR: Free for personal use. No selling. Keep it credited. 🙂

Full license text is available in the LICENSE file.


👤 Author

Created by RaneKun

  • Icon taken from the web
  • UI/UX designed by RaneKun
  • Code written by RaneKun (with the help of Claude)

This is a hobby project built to help Windows users keep their systems clean and fast.


🙏 Credits & Acknowledgments

Built with:

Inspired by:

  • CCleaner (before it got bloated)
  • BleachBit
  • The need for a simple, trustworthy cache cleaner

💬 Support & Feedback


⚠️ Disclaimer

This tool is provided "as is" without warranty of any kind. While it only targets safe cache folders, use at your own risk. Always keep backups of important data.

The author is not responsible for any data loss or system issues that may occur from using this tool.


🌟 Star This Project!

If you find this tool useful, consider giving it a ⭐ on GitHub!

It helps others discover the project and motivates continued development.


Made with ❤️ by RaneKun

Keep your Windows clean, fast, and clutter-free! 🧹✨

About

A powerful, safe, and user-friendly cache cleaner for Windows 10/11. Free up disk space with real-time progress tracking and detailed transparency.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors