🎬 Advanced Telegram Chat Video Downloader v2.10.0

A production-grade Chrome extension to reliably download videos from Telegram Web (web.telegram.org/k), with adaptive streaming support, history tracking, and a clean popup-based UI.

---

✨ Features

🎥 Video Detection

• Detects Telegram Web chat videos directly from DOM
• Works only inside chat (ignores viewer/modals)
• Automatically scans and updates video list
• Keeps previously detected videos after refresh

📋 Popup-Based UI

• Clean popup interface (no buttons injected into page)
• Lists all detected videos
• Displays:
  • Title
  • Size (if available)
  • Video ID
  • Download status
• One-click download per video

⬇️ Download System (Core Engine)

• Adaptive segmented downloading (range-based)
• Handles Telegram /k/stream/... endpoints correctly
• Automatically adjusts to server chunk behavior
• Validates:
  • Content-Range
  • Chunk size
  • Total size integrity
• Prevents corrupted files via strict validation

🧠 Smart Fallback

• Falls back to full download if:
  • Range not supported
  • Server behaves inconsistently
• Handles partial responses safely

📦 File Handling

• Uses real Content-Type to determine extension
• Filenames include:
  • Telegram video ID
  • Timestamp

🗂️ History & State

• Persistent storage using chrome.storage.local
• Tracks known and downloaded videos
• Marks downloaded videos in UI
• Stores metadata like download time and filename

⚡ Bulk Actions

• Download individual videos
• "Download All New" (skips already downloaded)
• Refresh list without losing previous data

🛡️ Stability & Reliability

• Prevents duplicate downloads
• Handles Telegram streaming quirks
• Stops background tasks when extension reloads

---

🚀 Installation

1. Open chrome://extensions/
2. Enable Developer Mode
3. Click Load unpacked
4. Select the extension folder

---

📌 Usage

1. Open https://web.telegram.org/k/
2. Open a chat with videos
3. Click extension icon
4. Refresh list and download

---

📦 Version

v2.10.0 -- Stable release

---

🛠️ Git Instructions

Creating a new repository on the command line

git init
git checkout -b main
git add README.md
git commit -m "first commit"
git remote add origin https://git.joykalyan.guru/me/advanced-telegram-video-downloader.git
git push -u origin main

Pushing an existing repository from the command line

git remote add origin https://git.joykalyan.guru/me/advanced-telegram-video-downloader.git
git push -u origin main

Daily Workflow

git add .
git commit -m "Regular bug fixes"
git push -u origin main

---

💡 Future Roadmap

• Retry failed chunks automatically

• Parallel chunk downloading (performance boost)

• UI progress bars per video

• Sorting/filtering in popup

• Export download history

• Multi-tab sync support

---

Built for reliability. Ready for shipping.