🧹 Ultimate System Cleaner

A powerful and lightweight Bash utility that removes unnecessary files, cache, logs, and orphaned packages from Linux systems while maintaining stability and performance.

Built for users who want a cleaner, faster, and more responsive Linux environment without unnecessary complexity.

---

🚀 Overview

Over time, Linux systems accumulate temporary files, package cache, old logs, and other junk that consumes storage and can reduce system responsiveness.

Ultimate System Cleaner automates the cleanup process by safely removing unnecessary files while leaving important system data untouched.

Supported distributions include:

• Kali Linux
• Ubuntu
• Debian
• Most Debian-based systems

---

📸 Screenshots

🖥️ Desktop Version (Dark Mode)

---

📱 Mobile Version (Dark Mode)

---

✨ Features

✅ Cleans temporary files (/tmp, /var/tmp)

✅ Removes user cache (~/.cache)

✅ Cleans APT package cache

✅ Removes orphaned packages

✅ Trims old system logs (journal entries older than 3 days)

✅ Empties the Trash folder

✅ Synchronizes filesystem changes

✅ Interactive confirmation prompt

✅ Color-coded terminal output

✅ 100% local execution

✅ No internet connection required

---

🎯 Use Cases

Perfect for:

• Improving system responsiveness
• Recovering disk space
• Cleaning Kali Linux installations
• Maintaining development machines
• Preparing systems for backups
• Regular Linux maintenance

---

🏗️ Project Structure

Ultimate_System_Cleaner/
├── cleaner.sh
├── README.md
└── screenshots/
    ├── desktop-dark.png
    └── mobile-dark.png

---

🔄 Cleanup Workflow

User Confirmation
        │
        ▼
Temporary Files Cleanup
        │
        ▼
APT Cache Cleanup
        │
        ▼
Orphan Package Removal
        │
        ▼
System Log Cleanup
        │
        ▼
Trash Cleanup
        │
        ▼
Filesystem Sync
        │
        ▼
Cleanup Complete

---

🧩 What Gets Cleaned

Category	Location
Temporary Files	/tmp
Temporary Files	/var/tmp
User Cache	~/.cache
Trash Bin	~/.local/share/Trash
Package Cache	APT Cache
Orphan Packages	APT Dependencies
Old Logs	systemd journal (older than 3 days)

---

🧠 Technical Highlights

• Pure Bash implementation
• Uses standard Linux utilities
• No external dependencies
• Interactive workflow
• Safe cleanup scope
• Lightweight execution
• Fast processing
• Cross-distribution compatibility

---

🛠️ Installation

Clone the repository:

git clone https://github.com/linuxcoding-ADAM/Ultimate_System_Cleaner.git

cd Ultimate_System_Cleaner

chmod +x cleaner.sh

---

▶️ Usage

Run the cleaner:

./cleaner.sh

The script will:

1. Display a warning message
2. Request confirmation
3. Execute cleanup operations
4. Show progress in real time
5. Synchronize filesystem changes

---

🧰 Example Output

=========================================
🧹 Ultimate System Cleaner 🚀
=========================================

This script will remove temporary files,
logs, cache, and more.

Do you want to proceed? (y/n): y

Cleaning /tmp...
Cleaning /var/tmp...
Cleaning APT cache...
Removing orphaned packages...
Clearing system logs...
Emptying trash bin...
Syncing filesystem...

✅ System cleanup complete!
🎉 Enjoy your clean system! 🎉

---

🧪 Tested On

System	Version	Status
Kali Linux	2024.3	✅ Tested
Ubuntu	22.04 LTS	✅ Tested
Debian	12 Bookworm	✅ Tested

---

🧠 Requirements

Required:

• Bash
• sudo privileges
• Debian-based Linux distribution

Recommended:

• Updated package repositories
• Administrative access

---

🛡️ Safety Design

The script intentionally avoids:

❌ User documents

❌ Home directory files

❌ Configuration files

❌ System binaries

❌ Personal data

Cleanup operations are restricted to safe locations only.

---

⚠️ Warning & Disclaimer

This script performs file deletion operations.

Always:

• Review the source code before running
• Understand what each command does
• Use administrative privileges responsibly

The software is provided AS IS without warranty of any kind.

The author is not responsible for data loss, system damage, or misuse.

Use at your own risk.

---

🔮 Future Improvements

• Disk usage analysis
• Dry-run mode
• Cleanup statistics dashboard
• Log size reporting
• Package cleanup preview
• Scheduled automatic maintenance
• Interactive TUI interface
• Multi-distribution support

---

📄 License

Licensed under the MIT License.

---

👨‍💻 Author

Adam Mila

• Linux User
• Bash Scripting Enthusiast
• Web Developer
• Open Source Contributor
• Electrical Engineering Background

GitHub: https://github.com/linuxcoding-ADAM

---

💬 Support

Found a bug or have an improvement idea?

Open an issue:

https://github.com/linuxcoding-ADAM/Ultimate_System_Cleaner/issues

Technical feedback and contributions are always welcome.