🚀 MEM-CLEAN 🧹

⚡ Ultimate System Performance Monitor & Memory Optimizer ⚡

🎨 CREATED BY 'WickedSyntax' WITH ❤️ 🎨

---

🎯 A badass Linux system monitoring and optimization tool that provides real-time system statistics and powerful cleanup capabilities! 🎯

---

🌟 FEATURES THAT WILL BLOW YOUR MIND 🌟

🧠 MEMORY MONITORING 📊 Real-time RAM usage percentage & stats 💡 Available memory tracking 🧹 Memory cache clearing superpowers 🔥 Lightning-fast performance analysis

⚡ CPU MONITORING 🎯 CPU usage percentage tracking 🏗️ Core count & frequency information 👑 Top memory-consuming process hunter 🚀 Real-time performance insights

💾 STORAGE MONITORING 📈 Disk usage percentage & statistics 🆓 Free space tracking 🔍 Large file detection & reporting 📁 Smart storage analysis

🧹 SYSTEM CLEANUP BEAST 🗑️ Memory cache clearing (sudo required) 🧽 Temporary file obliteration 🎯 Large file identification for review 🚀 Full system optimization

---

🎮 HOW TO USE THIS BEAST 🎮

🎪 Interactive Mode (The Fun Way!) 🎪

🎯 ./MEM-CLEAN
# or the cool shortcut
🚀 ./mem-clean

💻 Command Line Ninja Mode 💻

📋 ./MEM-CLEAN --help                 # 📖 Show the sacred help scrolls
📊 ./MEM-CLEAN --status               # 🎯 Quick system status check
🧹 ./MEM-CLEAN --clean                # 💨 Clear that memory cache!
🔍 ./MEM-CLEAN --large-files          # 🕵️ Hunt down those chunky files
🗑️ ./MEM-CLEAN --temp-clean           # 🧽 Obliterate temporary junk
👑 ./MEM-CLEAN --processes            # 🔥 Show the memory hogs

# 🎛️ Advanced Wizardry Options
🧙‍♂️ ./MEM-CLEAN --large-files --directory /path/to/scan --size 50 --limit 10

---

📦 REQUIREMENTS & SETUP 📦

🛠️ What You Need:

• 🐍 Python 3.6+ (The snake that rules them all)
• 📊 psutil library (pip3 install psutil)
• 🐧 Linux operating system (Tux approved!)
• 👑 sudo privileges (For the memory cache clearing magic)

🚀 Installation Steps:

1️⃣ git clone <this-awesome-repo> || download MEM-CLEAN folder
2️⃣ chmod +x MEM-CLEAN mem-clean  # 🔐 Grant execution powers
3️⃣ pip3 install psutil           # 📊 Install the monitoring magic
4️⃣ ./MEM-CLEAN                   # 🎉 Launch and enjoy!

---

🛡️ SAFETY FIRST! 🛡️

🔒 Safety Feature	📝 Description
🕵️ Non-Destructive Scanning	Read-only large file detection
🧹 Safe Cleanup	Only touches standard temp locations
👀 Process Monitoring	No termination capabilities
🚨 Error Handling	Graceful permission issue handling

---

🎪 INTERACTIVE MENU - THE CONTROL CENTER 🎪

🎯 Option	🎪 Action	📝 Description
1️⃣	📊 System Status	Display RAM, CPU, and storage stats
2️⃣	🧹 Clear Memory Cache	Free up system memory (sudo needed)
3️⃣	🔍 Find Large Files	Hunt files above size threshold
4️⃣	🗑️ Clean Temp Files	Remove temporary & cache files
5️⃣	👑 Top Memory Hogs	List processes eating your RAM
6️⃣	🚀 Full System Cleanup	Complete optimization blast
0️⃣	👋 Exit	Say goodbye (but why would you?)

---

🎨 SCREENSHOTS & EXAMPLES 🎨

🖥️ System Status Display

🧠 RAM USAGE:
   🟢 36.2% used (2.1GB / 7.7GB)
   Available: 4.9GB

⚡ CPU USAGE:
   🟡 22.0% (4 cores)
   Frequency: 2351 MHz

💾 STORAGE USAGE:
   🔴 93.0% used (211.2GB / 227.1GB)
   Free Space: 14.9GB

📁 Large Files Detection

📁 LARGE FILES DETECTED:
Size (GB)  Size (MB)    File Path
────────────────────────────────────────
7.71 GB    7895.6       ~/Downloads/huge-file.gguf
3.81 GB    3899.1       ~/Downloads/big-model.gguf

---

🤝 CONTRIBUTING 🤝

Want to make this tool even more awesome? 🎉

1. 🍴 Fork this bad boy
2. 🌟 Create your feature branch (git checkout -b feature/AmazingFeature)
3. 💫 Commit your changes (git commit -m 'Add some AmazingFeature')
4. 🚀 Push to the branch (git push origin feature/AmazingFeature)
5. 🎁 Open a Pull Request

---

📜 LICENSE 📜

This project is licensed under the MIT License - see the LICENSE file for details.

Free to use, modify, and distribute! 🎉

---

🌟 SHOW SOME LOVE 🌟

If this tool saved your system (and your sanity), consider:

⭐ Starring this repo
🐦 Sharing it with friends
💝 Contributing improvements
☕ Buying me a coffee (just kidding, stars are enough!)

---

🎯 Made with 💖 by WickedSyntax 🎯

🚀 "Making Linux systems run like rockets since 2024!" 🚀

---

🎪 Happy System Monitoring! 🎪