diff --git a/README.md b/README.md
new file mode 100644
index 0000000..cf75765
--- /dev/null
+++ b/README.md
@@ -0,0 +1,23 @@
+# MarkHS pour SABnzbd
+
+Ce script de post-traitement pour SABnzbd permet de signaler automatiquement les *releases* irréparables ou défectueuses (HS). 
+
+En cas d'échec de vérification ou de réparation d'un téléchargement, le script récupère l'identifiant unique du NZB et avertit l'API afin de marquer la release comme "HS".
+
+## 🚀 Fonctionnement
+
+* **Ciblé et silencieux :** Le script ne contacte l'API **que si** le téléchargement rencontre une erreur critique (Statut SABnzbd "1" : échec de la vérification/réparation). Si le téléchargement réussit, il s'arrête immédiatement.
+* **Sécurité anti-spam :** Le script décompresse le fichier original `.nzb.gz` mis en cache par SABnzbd et vérifie la présence de la balise `<meta type="tag">`. Si cette balise est absente (fichier ne provenant pas du site), le script s'arrête sans rien envoyer. Vous pouvez l'assigner à tous vos téléchargements sans risque de requêtes inutiles vers l'API.
+
+## 🛠 Prérequis
+
+* **SABnzbd** installé et fonctionnel.
+* **Python 3** installé sur votre machine.
+
+## 📥 Installation & Configuration
+
+Contrairement à NZBGet, SABnzbd ne permet pas de générer des champs de configuration personnalisés dans son interface web. La clé API doit donc être renseignée directement dans le fichier.
+
+1. **Éditez le script :** Ouvrez le fichier `sabnzbd_markhs.py` avec un éditeur de texte et remplacez la variable `API_KEY` par votre véritable clé API (disponible dans la page de vos réglages sur le site).
+   ```python
+   API_KEY = "METTRE_VOTRE_CLE_ICI"
\ No newline at end of file