59 lines
2.7 KiB
Markdown
59 lines
2.7 KiB
Markdown
# 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! 🚀 |