# 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! 🚀