From 07ea864e8f3ec7521de38888acf2d747881fb13e Mon Sep 17 00:00:00 2001
From: "sebastian.serfling" <sebastian.serfling@stines.de>
Date: Thu, 13 Nov 2025 13:13:14 +0000
Subject: [PATCH] =?UTF-8?q?README.MD=20hinzugef=C3=BCgt?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.MD | 68 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 68 insertions(+)
 create mode 100644 README.MD

diff --git a/README.MD b/README.MD
new file mode 100644
index 0000000..20e9283
--- /dev/null
+++ b/README.MD
@@ -0,0 +1,68 @@
+    # speedcheck.sh – Ordner-Durchsatz messen & Kopierdauer hochrechnen
+
+`speedcheck.sh` ist ein Bash-Tool, das die Schreibgeschwindigkeit eines Ordners misst, indem es ihn für einen konfigurierbaren Zeitraum überwacht und anschließend berechnet, wie lange ein Kopiervorgang von **80 GB** dauern würde.
+
+Das Skript zeigt während der Messung **live** an:
+
+- wie viele Daten bereits hinzugekommen sind  
+- die aktuelle Gesamtgröße  
+- einen **Fortschrittsbalken**
+
+Am Ende erfolgt eine Zusammenfassung sowie die Hochrechnung für 80 GB.
+
+---
+
+## ✨ Features
+
+- 📡 **Live-Überwachung** des Datenzuwachses  
+- ⏱ **Konfigurierbare Beobachtungsdauer** (Standard: 300 Sekunden / 5 Minuten)  
+- 📊 **Fortschrittsbalken**  
+- 🔍 Messung der Schreibgeschwindigkeit (Bytes/s)  
+- 🧮 Hochrechnung: Zeit zum Kopieren von **80 GB**  
+- 💡 Funktioniert mit jedem Ordner (lokal, SMB, USB, NFS, …)
+
+---
+
+## 📥 Installation
+
+Skript ausführbar machen:
+
+```bash
+chmod +x speedcheck.sh
+
+🚀 Verwendung
+Standard (5 Minuten Messdauer)
+./speedcheck.sh /pfad/zum/ordner
+
+Eigene Messdauer in Sekunden
+./speedcheck.sh /pfad/zum/ordner 120
+
+Beispiel: Ordner für 2 Minuten überwachen:
+./speedcheck.sh /mnt/backup 120
+
+📤 Beispielausgabe
+Überwache Ordner: /mnt/backup
+Dauer: 300 Sekunden
+
+[#########################-------------------------]  50% | Gesamt: 12G | Zuwachs: 4.1G
+...
+
+Überwachung abgeschlossen.
+
+Neue Daten: 8.2G
+Durchsatz: 28M/s
+
+Zeit für 80 GB:
+  ≈ 0.8 Stunden
+  oder ≈ 48 Minuten
+
+🔧 Konfiguration im Skript
+
+Oben im Skript kann folgende Variable angepasst werden:
+TARGET_GB=80    # Zielgröße für die Hochrechnung
+
+📌 Hinweise
+
+Das Skript misst den realen Datenzuwachs, daher sind die Werte beim Kopieren sehr praxisnah.
+Ideal für Netzwerkshares (SMB/NFS), USB-Laufwerke oder große Datenmigrationen.
+Je länger die Messung, desto präziser die Hochrechnung.