From f4eea39b7bd647af63c5a5c28845c3e93b8e379f Mon Sep 17 00:00:00 2001 From: UNFR Date: Thu, 2 Apr 2026 08:40:51 +0000 Subject: [PATCH] Ajouter README.md --- README.md | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) create mode 100644 README.md 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 ``. 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