⚙️ CleanMaster

Outil de maintenance système Windows — 100% local, zéro cloud

---

📸 Aperçu

CleanMaster est un outil de maintenance Windows avec une interface moderne (thème sombre), conçu pour les techniciens et utilisateurs avertis. Il regroupe en un seul programme tout ce dont vous avez besoin pour garder votre machine propre et performante.

---

✨ Fonctionnalités

Onglet	Description
🏠 Accueil	Dashboard avec score de propreté, ressources live (CPU/RAM/Disque), alertes et nettoyage 1-clic
🧹 Nettoyage	Fichiers temporaires Windows, corbeille, dossiers personnalisés — aperçu avant suppression
🔍 Doublons	Détection par empreinte MD5/SHA256 en 3 passes, originaux protégés, économie calculée
💻 Système	Jauges live (refresh 5s), liste des logiciels installés, désinstallation officielle, gestionnaire démarrage
🗺️ Analyse	Treemap interactif de l'espace disque + vérificateur S.M.A.R.T. via wmic
🛡️ Récupération	Corbeille de sécurité avec restauration possible + historique des 100 derniers nettoyages
🔧 Registre	Scanner de clés orphelines (Run invalides, Uninstall vides, MRU périmés)
⚙️ Paramètres	Exclusions par mots-clés, mode simulation, planificateur Windows, thème clair/sombre

---

🔒 Sécurité & Confidentialité

• ✅ Zéro cloud — aucune donnée ne quitte votre ordinateur
• ✅ Corbeille de sécurité — les fichiers sont déplacés avant suppression définitive, restauration possible
• ✅ Mode Simulation (Dry Run) — visualisez ce qui serait supprimé sans rien toucher
• ✅ Liste d'exclusions — protégez des fichiers par mots-clés
• ✅ Confirmation systématique avant toute action irréversible
• ✅ Rapport .txt généré sur le Bureau après chaque nettoyage

---

🚀 Installation

Prérequis

• Windows 10 / 11
• Python 3.10+

1. Cloner le dépôt

git clone https://github.com/VOTRE_USERNAME/CleanMaster.git
cd CleanMaster

2. Installer les dépendances

pip install -r requirements.txt

3. Lancer

python main.py

💡 Conseil : Lancer en tant qu'Administrateur pour accéder à tous les chemins système et au registre.

---

📦 Compiler en .exe

pip install pyinstaller

python -m PyInstaller --onefile --windowed --name "CleanMaster" `
  --collect-all customtkinter `
  --hidden-import psutil `
  --hidden-import winshell `
  --hidden-import win32api `
  --hidden-import win32con `
  --hidden-import pywintypes `
  --hidden-import winreg `
  main.py

Le fichier dist/CleanMaster.exe est autonome et portable.

---

🗂️ Structure du projet

CleanMaster/
├── main.py              # Point d'entrée
├── app.py               # Fenêtre principale + navigation
├── tab_dashboard.py     # 🏠 Accueil — Vue d'ensemble
├── tab_clean.py         # 🧹 Nettoyage
├── tab_duplicates.py    # 🔍 Doublons
├── tab_system.py        # 💻 Système
├── tab_analyse.py       # 🗺️ Analyse disque + S.M.A.R.T.
├── tab_recovery.py      # 🛡️ Récupération + Historique
├── tab_registry.py      # 🔧 Registre Windows
├── tab_settings.py      # ⚙️ Paramètres
├── cleaner.py           # Core : nettoyage fichiers
├── duplicates.py        # Core : détection doublons
├── system.py            # Core : diagnostic système
├── reporter.py          # Core : rapports + planificateur
├── settings.py          # Gestion configuration JSON
└── requirements.txt

---

📋 Dépendances

Package	Rôle
customtkinter	Interface graphique moderne
psutil	CPU, RAM, Disques, Processus
winshell	Gestion corbeille Windows
pywin32	Accès registre Windows
send2trash	Envoi sécurisé en corbeille

---

📄 Licence

MIT — libre d'utilisation, modification et distribution.

---

Développé avec ❤️ et Claude (Anthropic)