README.md aktualisiert

README.md

@@ -1,2 +1,59 @@
-# TG-Video-Downloader
+# Telegram Web Video Downloader
 
+Eine Chrome/Edge/Firefox-Erweiterung, die **Download-Buttons** zu allen Videos in Telegram Web (web.telegram.org) hinzufügt und dabei **intelligente, saubere Dateinamen** vergibt – besonders perfekt für Serien-Alben mit Episodenlisten.
+
+## Features
+
+- ⬇️ **Direkter Download-Button** auf jedem Video (inkl. Alben)
+- 🏷️ **Automatische, korrekte Dateinamen**  
+  Beispiel: `Emily in Paris - S03E01 - Wer die Wahl hat….mp4`  
+  Oder: `NCIS Sydney - S03E04 - Die Wahrheit ist im Outback.mp4`
+- ⚡ **Schneller paralleler Chunk-Download** (wenn möglich) mit Fallback auf stabilen sequentiellen Modus
+- 📂 Funktioniert mit Einzelvideos, Filmen und großen Serien-Alben
+- 🔄 Vollständig dynamisch – Buttons werden auch bei neuen Nachrichten automatisch hinzugefügt
+- 🛡️ Keine externen Server, alles läuft lokal im Browser
+
+## Installation (fertige Version aus Releases)
+
+Die einfachste und empfohlene Methode:
+
+1. Gehe zur [Releases-Seite](https://git.viper.ipv64.net/M_Viper/TG-Video-Downloader/releases).
+
+2. Lade die neueste Version herunter (Datei mit Namen wie `TG-Downloader.zip`).
+
+3. Entpacke die ZIP-Datei an einen beliebigen Ort auf deinem Computer.
+
+4. Öffne deinen Browser und gehe zu den Erweiterungen:
+   - **Chrome / Edge**: `chrome://extensions/`
+
+5. Aktiviere den **Entwicklermodus** (oben rechts).
+
+6. Klicke auf:
+   - **Chrome / Edge**: „Entpackte Erweiterung laden“
+
+7. Wähle den **entpackten Ordner** aus (der Ordner, in dem `manifest.json` liegt).
+
+8. Öffne https://web.telegram.org  
+   **Empfehlung**: Nutze die **WebZ-Version** unter https://web.telegram.org/z/ für bessere Performance und schnellere Downloads.
+
+9. Du siehst jetzt auf jedem Video einen roten **⬇ DOWNLOAD**-Button.
+
+## Wie es funktioniert
+
+- `content.js` erkennt alle Videos, fügt die Download-Buttons hinzu und ermittelt den besten Dateinamen aus dem Telegram-Text (priorisiert Serien-Alben mit `SxxExx`).
+- Beim Klick auf den Button wird ein Custom Event an `inject.js` gesendet.
+- `inject.js` übernimmt den eigentlichen Download mit optimiertem Chunking (parallel, wenn möglich) und zeigt eine schöne Progress-Bar an.
+
+## Bekannte Hinweise
+
+- Telegram Web (insbesondere die WebK-Version unter `/k/`) zeigt oft harmlose Fehlermeldungen wie `progressive.ts` oder `FetchEvent rejected`. Diese stammen von Telegram selbst und beeinflussen den Download **nicht**.
+- Bei instabilem Netzwerk kann der schnelle parallele Chunk-Modus automatisch auf den stabilen sequentiellen Modus umschalten (langsamer, aber zuverlässig).
+- **Tipp**: Nutze https://web.telegram.org/z/ für weniger Console-Fehler und häufiger erfolgreiche parallele Downloads.
+
+## Lizenz
+
+GPL-3.0 License
+
+---
+
+Viel Spaß beim Serien sammeln! 🚀