TG Downloader is a premium, secure Google Chrome Extension (Manifest V3) designed to download restricted and private videos, voice messages, photos, and stories directly from the Telegram Web client interfaces (both Z/A and K variants).
- Bypass Restrictions: Save media from channels and groups where copying, saving, or forwarding permissions are disabled by administrators.
- Smart Download Overlay: Injects a clean, non-intrusive download button onto videos and high-resolution images automatically.
- Real-Time Progress Dashboard: Monitor active downloads, speed, and chunk assembly with a glassmorphic dashboard in the corner of your page.
- Parallel Downloads: Download multiple files simultaneously with individual progress bars.
- 100% Local & Secure: Runs entirely inside your browser. No credentials, cookies, or downloaded data ever leave your computer.
Click on the extension icon in your Chrome toolbar to view your dashboard, check connection status, and view your saved statistics.
Hover over or play any video or image on Telegram Web to see the floating download button. Click it to begin downloading, and track progress instantly.
Need to grab multiple videos at once? TG Downloader supports parallel downloading to save you time.
To load the extension into your browser:
- Download and Extract: Save the extension project folder to your local computer.
- Open Extensions: In Google Chrome, go to
chrome://extensions/. - Developer Mode: Turn ON the "Developer mode" switch in the top-right corner.
- Load Extension: Click Load unpacked in the top-left and select the extracted extension folder.
- Pin it: Click the extension puzzle piece icon in the Chrome toolbar and pin TG Downloader for quick access.
- Navigate to web.telegram.org and log in.
- Open any conversation, channel, group, or story.
- Simply click the Download Video or Download Image button overlaying the media player/frame.
- The file will be compiled and saved directly into your computer's Downloads folder once the progress bar hits 100%.
- Button does not appear: Play the video for a second to initialize the streaming feed, or reload the page if you just installed the extension.
- HTTP 302, 403, or 404 errors: Completely refresh the Telegram Web tab so the downloader script can sync with Telegram's backend decryption worker.
- Files above 2GB: Very large files may hit browser memory limits. Ensure you have free RAM and a stable internet connection.
For developers and technical overviews:
graph TD
A[Isolated World: content.js] -->|1. Observes DOM / Coordinates| B[HTML Video / Image Element]
A -->|2. Injects overlays safely| C[Floating Layer on document.body]
A -->|3. Dispatches CustomEvent| D[Main World: main-world.js]
D -->|4. Chunked Fetch via SW| E[Telegram Web Service Worker]
E -->|5. Decrypts & Stream chunks| D
D -->|6. Compiles Blobs / File Access| F[Disk / Downloads]
The extension separates DOM-manipulation logic (in content.js) from network range-header fetching logic (in main-world.js) to seamlessly interact with Telegram Web's Service Worker without crashing React rendering loops. For details, see DEVELOPER.md.
This software is governed by a custom license:
- Personal Use: Free for individual, non-commercial use in its original, unmodified form.
- Modifications & Distribution: Modifying the source code, distributing modified copies, or commercial redistribution requires a paid license and prior written authorization.
For full license details, see the LICENSE file.