🧹 Clean.me

One-Click Windows PC Cleaner

A sleek, modern desktop application that cleans your PC in seconds

Built with ❤️ by CCC Suite

---

✨ Features

• 🎯 One-Click Cleanup: Simple, elegant interface with a single button
• 🎨 Liquid Glass UI: Modern glassmorphism design with interactive effects
• 🛡️ Safe Cleaning: Only removes non-essential files and temporary data
• 📊 Real-time Feedback: Progress indicator and detailed cleanup results
• ⚡ Worker Threads: Non-blocking cleanup operations for smooth UI
• 🚀 Comprehensive Coverage: Cleans 60+ different locations including:
  • Windows temporary files and cache
  • Browser data (Chrome, Edge, Firefox)
  • Application cache (Teams, Slack, Zoom, Spotify, Discord)
  • System logs and crash dumps
  • Recycle bin and Windows update cache

🎬 Screenshots

Modern glassmorphism UI with one-click cleanup

🔧 What Gets Cleaned

✅ Safe Locations

• System Temp: C:\Windows\Temp, %TEMP%
• Browser Cache: Chrome, Edge, Firefox cache and cookies
• App Data: Teams, Slack, Zoom, Spotify, Discord logs/cache
• Windows Logs: Event logs, crash dumps, CBS logs
• Prefetch: Windows prefetch files
• Update Cache: Windows Update temporary files
• Recycle Bin: Deleted files in recycle bin

❌ Never Touched

• Personal documents and files
• Installed programs and settings
• Critical system files
• Active registry keys

📦 Installation

💾 Download Release Visit our Releases page Download the latest Clean.me Setup.exe Run the installer (requires admin privileges) Launch from your desktop or start menu System Requirements: Windows 10 or later 200MB disk space Administrator access

🛠️ Build from Source # Clone the repository git clone https://github.com/git-x-ai/clean.me.git cd clean.me # Install dependencies npm install # Run the application npm start # Build for distribution npm run build Requirements: Node.js 16+ Git Windows 10+

🚀 Development

Prerequisites

• Node.js 16+ and npm
• Windows 10 or later
• Git for version control

Quick Start

# Clone and install
git clone https://github.com/git-x-ai/clean.me.git
cd clean.me
npm install

# Development with hot reload
npm run dev

# Build CSS (watch mode)
npm run build:css:watch

# Build for production
npm run build

Available Scripts

Command	Description
npm start	Start the application
npm run dev	Development mode with CSS build
npm run build	Build CSS and create distributable
npm run build:css	Build Tailwind CSS (minified)
npm run build:css:watch	Watch and rebuild CSS on changes
npm run dist	Create distribution without publishing

Project Structure

clean.me/
├── src/                 # Source code
│   ├── main.js         # Electron main process
│   ├── renderer.js     # UI renderer process
│   ├── cleanup.js      # Cleanup worker management
│   ├── cleanup-worker.js # Cleanup logic (worker thread)
│   ├── index.html      # Main UI
│   ├── debug.html      # Debug console
│   ├── input.css       # Tailwind CSS input
│   └── styles.css      # Generated CSS (auto-generated)
├── assets/             # Images and icons
│   ├── logo.png        # App logo
│   ├── favicon.ico     # Taskbar icon
│   ├── github.svg      # GitHub icon
│   └── wizard.bmp      # Installer sidebar
├── build/              # Build scripts and manifests
├── docs/               # Documentation
└── dist/               # Build output (generated)

🛡️ Security

Clean.me is designed with security in mind:

• No network access - Works entirely offline
• Safe operations only - Never modifies critical system files
• Open source - Full transparency of operations
• Minimal permissions - Only requests necessary access

See our Security Policy for details.

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

Quick Start

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Test thoroughly
5. Submit a pull request

📋 Requirements

• OS: Windows 10 or later
• Permissions: Administrator privileges (for system file cleanup)
• RAM: 100MB minimum
• Storage: 200MB for installation

📄 License

This project is dual-licensed for maximum flexibility:

• ✅ Free for personal and educational use - Use, modify, and share freely
• 🔒 Modifications must be contributed back - Help improve the project
• 💼 Commercial use requires permission - Contact us for licensing

See the LICENSE file for complete details.

For commercial licensing inquiries, visit our Discord.

🙏 Acknowledgments

• Built with Electron
• Styled with Tailwind CSS
• Icons and design inspiration from modern UI/UX principles

📞 Support & Community

🐛 Bug Reports	💡 Feature Requests	💬 Community
Open an Issue	Request a Feature	Join Discord

📖 Documentation	🌐 Website	⭐ Support Us
Read the Docs	CCC Suite	Star on GitHub

---

🎯 Part of the CCC Suite

Made with ❤️ for the Windows community by CCC Suite

_{⭐ Star this repo if you find it helpful!
🔄 Share with others who need a clean PC!
🤝 Contribute to make it even better!}