diff --git a/README.md b/README.md index a5904e1..aed0461 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,131 @@ -# 7Cooler-Ultimate +# 📊 7Cooler Ultimate -7Cooler Ultimate - Une suite complète et élégante de monitoring matériel en temps réel (CPU, GPU, RAM, Disques, Réseau) optimisée pour Ubuntu 24.04 et Zorin OS 18 Pro. Codé en Python avec PyQt6. \ No newline at end of file +[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0) +[![Python](https://img.shields.io/badge/Python-3.12+-yellow.svg)](https://www.python.org/) +[![Framework](https://img.shields.io/badge/UI-PyQt6-green.svg)](https://www.qt.io/) +[![Platform](https://img.shields.io/badge/Platform-Ubuntu%20%7C%20ZorinOS-orange.svg)](https://zorin.com) + +**7Cooler Ultimate** est une suite complète, moderne et ultra-fluide de surveillance matérielle en temps réel, conçue spécifiquement pour s'intégrer nativement à l'écosystème de **Zorin OS 18 Pro** et **Ubuntu 24.04 LTS**. Écrit en Python 3 et propulsé par PyQt6, l'application combine un design minimaliste "Premium" en noir et blanc avec des animations asynchrones avancées. + +--- + +## ✨ Fonctionnalités Majeures + +* **🎛️ Tableau de bord Holistique :** Une vue claire avec jauges circulaires vectorielles dessinées sur mesure pour le CPU et le GPU. +* **🌡️ Monitoring Avancé (Multi-cœurs) :** Suivi indépendant de la température de chaque cœur de votre processeur avec alertes visuelles en cas de surchauffe. +* **🎮 Prise en charge GPU (NVIDIA & AMD) :** Intégration native avec `nvidia-smi` et les capteurs `amdgpu` pour récupérer dynamiquement la charge et les températures graphiques. +* **📈 Analyse des ressources :** Graphiques de charge lissés pour la mémoire vive (RAM), le fichier d'échange (SWAP) et l'utilisation des disques. +* **🌐 Débit Réseau :** Mesure précise et en temps réel de la vitesse de téléchargement (DL) et d'envoi (UL). +* **🎨 Personnalisation "Zorin Style" :** Changez la couleur d'accentuation globale (Bleu, Rouge, Vert, Violet, Blanc) en un clic depuis l'onglet Paramètres. +* **🥷 Mode Arrière-plan (System Tray) :** L'application se minimise proprement dans la barre des tâches. Une infobulle dynamique vous garde informé sans encombrer votre écran. +* **🚀 Performance Multi-threadée :** La collecte des données matérielles est isolée dans un thread asynchrone pour garantir une interface utilisateur à 60 FPS constants, sans aucun gel. + +--- + +## 🛠️ Prérequis + +L'application s'appuie sur les bibliothèques système d'Ubuntu. Pour exécuter le code source, assurez-vous d'avoir installé : + +```bash +sudo apt update +sudo apt install python3 python3-pyqt6 python3-psutil lm-sensors + +``` + +> 💡 **Note pour les utilisateurs NVIDIA :** Assurez-vous que les pilotes propriétaires (fournissant la commande `nvidia-smi`) sont correctement installés pour activer le suivi GPU. + +--- + +## 🚀 Installation + +### Option 1 : Via le paquet Debian (Recommandé) + +Téléchargez la dernière version du fichier `.deb` depuis l'onglet *Releases* de votre dépôt et installez-la via votre terminal : + +```bash +sudo apt install ./7cooler-ultimate_1.0_amd64.deb + +``` + +L'application sera alors disponible immédiatement dans votre menu d'applications Zorin / Ubuntu sous le nom **7Cooler Ultimate**. + +### Option 2 : Exécution depuis les sources + +1. Clonez votre dépôt : +```bash +git clone [https://git.7ka1.com/7ka1/7Cooler-Ultimate.git](https://git.7ka1.com/7ka1/7Cooler-Ultimate.git) +cd 7Cooler-Ultimate + +``` + + +2. Lancez le script principal : +```bash +python3 7cooler_ultimate.py + +``` + + + +--- + +## 📦 Comment compiler le paquet `.deb` ? + +Si vous modifiez le code source et souhaitez générer un nouveau paquet distribuable, exécutez ce script de build étape par étape dans votre terminal : + +```bash +# 1. Créer l'architecture requise +mkdir -p 7cooler-ultimate_1.0_amd64/DEBIAN +mkdir -p 7cooler-ultimate_1.0_amd64/usr/bin +mkdir -p 7cooler-ultimate_1.0_amd64/usr/share/applications + +# 2. Copier le code source dans le dossier binaire +cp 7cooler_ultimate.py 7cooler-ultimate_1.0_amd64/usr/bin/7cooler-ultimate + +# 3. Générer le fichier de contrôle DEBIAN (control) +cat << 'EOF' > 7cooler-ultimate_1.0_amd64/DEBIAN/control +Package: 7cooler-ultimate +Version: 1.0 +Section: utils +Priority: optional +Architecture: amd64 +Depends: python3, python3-pyqt6, python3-psutil, lm-sensors +Maintainer: ska1 +Description: 7Cooler Ultimate - Le moniteur ultime pour Zorin OS et Ubuntu (CPU, GPU, RAM, Reseau). +EOF + +# 4. Générer le raccourci du menu d'applications (.desktop) +cat << 'EOF' > 7cooler-ultimate_1.0_amd64/usr/share/applications/7cooler-ultimate.desktop +[Desktop Entry] +Version=1.0 +Type=Application +Name=7Cooler Ultimate +Comment=Monitoring ultime du systeme +Exec=/usr/bin/7cooler-ultimate +Icon=utilities-system-monitor +Terminal=false +Categories=Utility;System; +EOF + +# 5. Ajuster les permissions de sécurité Debian obligatoires +chmod 755 7cooler-ultimate_1.0_amd64/DEBIAN +chmod 755 7cooler-ultimate_1.0_amd64/usr/bin/7cooler-ultimate + +# 6. Compiler le paquet final +dpkg-deb --build 7cooler-ultimate_1.0_amd64 + +``` + +--- + +## 📄 Licence + +Ce projet est distribué sous la licence **GNU GPL v3**. Consultez le fichier `LICENSE` pour plus de détails. Cela signifie que vous êtes libre de copier, modifier et distribuer ce logiciel, à condition que vos modifications restent sous cette même licence open-source. + +--- + +*Développé avec passion par [7ka1](https://www.google.com/search?q=https://git.7ka1.com/7ka1) pour la communauté Linux.* + +``` + +``` \ No newline at end of file