commit b47d67299c49064f8d7b02f4bb581e144a010836
Author: Johnny <tuxgyver@gmail.com>
Date:   Fri Sep 11 07:35:14 2026 +0200

    first commit

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..d6c34a6
--- /dev/null
+++ b/README.md
@@ -0,0 +1,131 @@
+<div align="center">
+
+# 🌐 StabilityTester
+
+> 📊 Application de surveillance de stabilite de connexion internet
+
+[![Python 3.7+](https://img.shields.io/badge/python-3.7+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](https://opensource.org/licenses/MIT)
+[![Status: Active](https://img.shields.io/badge/status-active-brightgreen.svg)]
+
+</div>
+
+---
+
+## 🚀 A propos
+
+StabilityTester est une application Python complete avec interface graphique qui permet de verifier, surveiller et alerter sur la stabilite d'une connexion internet.
+
+---
+
+## 🎯 Fonctionnalites
+
+### 🔍 Tests Reseau
+- 🏓 Ping vers plusieurs serveurs
+- 🌐 Test de connexion HTTP
+- 📡 Resolution DNS
+- ⬇️ Vitesse de telechargement
+- ⬆️ Vitesse d'upload
+- ⚡ Test de vitesse complet (optionnel)
+- 📉 Mesure du jitter
+
+### 📊 Analyse de Stabilite
+
+**Score global (0-100)** base sur 5 criteres ponderes:
+- Taux de succes: 30%
+- Temps de disponibilite: 25%
+- Latence: 20%
+- Vitesse Download: 15%
+- Vitesse Upload: 10%
+
+**Barre de progression coloree:**
+- 🟢 Vert (80-100): Excellente stabilite
+- 🟠 Orange (60-79): Bonne stabilite
+- 🟡 Orange (40-59): Stabilite moyenne
+- 🔴 Rouge (< 40): Faible stabilite
+
+### 🔔 Systeme d'Alerte
+- Notifications systeme
+- Alertes sonores
+- Historique des alertes
+
+### 🎨 Interface Graphique
+6 onglets: Tableau de bord, Tests, Historique, Alertes, Parametres, Statistiques
+
+---
+
+## 📦 Installation
+
+### Prérequis
+- Python 3.7+
+- pip
+
+### Installation rapide
+```bash
+cd StabilityTester
+make install
+# ou
+pip install -r requirements.txt
+```
+
+---
+
+## 🎮 Utilisation
+
+### Lancement
+```bash
+make run
+# ou
+python3 main.py
+# ou
+./run.sh
+```
+
+### Controles
+- Demarrer/Arreter la surveillance
+- Test unique manuel
+- Exporter les donnees
+- Sauvegarder/Charger l'etat
+- Minimiser en tache de fond
+
+---
+
+## 📊 Score de Stabilite
+
+Calcule en temps reel et affiche sous forme de barre de progression coloree.
+
+---
+
+## 💾 Export et Sauvegarde
+
+- Exporter: Enregistre l'historique dans un fichier JSON
+- Sauvegarder: Enregistre l'etat actuel
+- Charger: Restaure un etat precede
+
+---
+
+## 🔧 Fonctionnement en Tache de Fond
+
+- Minimiser: La surveillance continue en arriere-plan
+- Les alertes restent actives
+
+---
+
+## 🐛 Resolution des Problemes
+
+```bash
+make test    # Verifier l'installation
+make clean   # Nettoyer les fichiers temporaires
+```
+
+---
+
+## 📜 Licence
+
+MIT License
+
+---
+
+<div align="center">
+Made with ❤️ and Python
+</div>