🍷 SysCleaner — System Cleaner & Optimizer TUI for Windows

SysCleaner is a powerful, interactive Terminal User Interface (TUI) application designed to scan, analyze, and free up disk space on Windows systems. Designed with an elegant Marsala Color Palette (#955251), keyboard-navigable menus, rich tables, and standalone .exe distribution.

---

   _____            ________                          
  / ___/__  _______/ ____/ /__  ____ _____  ___  _____
  \__ \/ / / / ___/ /   / / _ \/ __ `/ __ \/ _ \/ ___/
 ___/ / /_/ (__  ) /___/ /  __/ /_/ / / / /  __/ /    
/____/\__, /____/\____/_/\___/\__,_/_/ /_/\___/_/     
     /____/                                           

[ADM] System Scanner & Cleaner -- Windows
------------------------------------------------------------

---

✨ Key Features

• 🖥️ System Dashboard: Complete SSD overview including drive model, total capacity, used and free space with a visual disk usage progress bar, plus folder size distribution across system directories.
• 📦 Installed Applications Scanner: Lists all Control Panel software sorted by size. Supports silent MSI uninstallation with interactive safety confirmation prompts.
• 📁 Large Files Scanner: Scans for the largest files across your system (default > 50 MB), displaying top 50 rankings, extension breakdown, and selective file deletion.
• 🧹 Temp & Cache Cleaner: Intelligent cleanup of system caches (%TEMP%, Windows\Temp, Prefetch), web browsers (Chrome, Edge), desktop apps (Spotify, Discord, Roblox, Steam), and package managers (pip, npm, nuget).
• 🔍 Registry Scanner (Orphan Keys): Identifies and removes uninstalled program registry leftover keys safely.
• ❤️ Disk Health Monitor: Real-time SMART status monitoring for SSD/HDD, volume health integrity, and recent disk error log inspection.

---

🎨 Marsala Color Palette

The interface features a harmonious, high-contrast visual design centered around the Marsala color scheme:

Color	Hex Code	Usage
Marsala Core	#955251	Headers, panel borders, and primary progress bars
Light Marsala	#B87373	Table borders and section separators
Dark Marsala	#6B3A3A	Subtitles and highlighted backgrounds
Gold	#D4A574	Table headers and active menu selections
Cream / Warm White	#F5E6D3	Labels, values, and primary body text

---

🛠️ Built With

• Questionary — Arrow-key (↑ ↓) interactive menus, multi-select checkboxes, and confirmation prompts.
• Rich — Rich text formatting, styled data tables, progress bars, and callout panels.
• PyFiglet — ASCII art header banners.
• Colorama — Cross-platform ANSI color rendering in Windows terminal.
• PyInstaller — Standalone .exe compilation (no Python environment needed).

---

🚀 Usage Instructions

Option 1: Standalone Executable (.exe)

Download the latest pre-compiled binary from Releases. Simply double-click SysCleaner.exe to run. No installation or Python setup required.

Option 2: Running from Source Code

1. Clone the repository:

   git clone https://github.com/yan-fab/syscleaner.git
   cd syscleaner

2. Install requirements:

   pip install -r requirements.txt

3. Launch the TUI:

   python app.py

   Or double-click run.bat.

---

🏗️ Building the Executable

To compile a new standalone executable using PyInstaller:

build.bat

The output binary will be created in dist/SysCleaner.exe.

---

📝 License

Distributed under the MIT License.