Skip to content

Ultimate System Performance Monitor & Memory Optimizer that runs straight from your Terminal

License

Notifications You must be signed in to change notification settings

itsWickedSyntax/MEM-CLEAN

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 

Repository files navigation

🚀 MEM-CLEAN 🧹

⚡ Ultimate System Performance Monitor & Memory Optimizer ⚡

Python Linux Active MIT License

🎨 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! 🎪