Telegram-Media-Downloader README

The project's README from github.com/Neet-Nestor/Telegram-Media-Downloader. As one markdown file: README.md.

Telegram Video Downloader / Telegram Media Downloader

Unlock Telegram: Download Anything You Like.

GitHub License Greasy Fork Version Greasy Fork Downloads

Overview

This user script unlocks and enables download of images, GIFs, audios, and videos in Telegram webapps from chats, stories, and even private channels where downloading is disabled or restricted.

(Note: some features are only available for specific Telegram webapp version. e.g. Audio message download is only available for the K webapp version.)

What are user scripts?

User scripts put you in control of your browsing experience. Once installed, they automatically make the sites you visit better by adding features, making them easier to use, or taking out the annoying bits. The user scripts on Greasy Fork were written by other users and posted to share with the world. They're free to install and easy to use.

Installation

Greasy Fork

  1. install a user script manager

    To use user scripts you need to first install a user script manager. Which user script manager you can use depends on which browser you use.

    (Note, If you are using Tampermonkey extension in a Chrome-based browser, following instructions to enable Developer Mode.)

  2. Install this script by visiting Greasy Fork: https://greasyfork.org/scripts/446342-telegram-media-downloader

Manual Installation

  1. install a user script manager

    To use user scripts you need to first install a user script manager. Which user script manager you can use depends on which browser you use.

    (Note, If you are using Tampermonkey extension in a Chrome-based browser, following instructions to enable Developer Mode.)

  2. Open Tampermonkey Dashboard, drag & drop src/tel_download.js into it and clicks the "install" button

How to Use

This script only works on Telegram Webapp.

For channels and chats that allow saving content, this script will have no effect. Please just use the official download button provided by the telegram webapp instead.

For channels and chats that disable downloading and restrict saving content, this script will add the download button back for images, GIFs and videos.

Image Download GIF Download Video Download Story Download

For videos, a progress bar will show on the bottom-right corder after you started downloading. For images and audios, there won't be a progress bar.

Supported Webapp Versions

There are 2 different versions of telegram webapps:

This script should work on both versions of webapp, but some features are only available in the /k/ version (such as voice message downloads). If certain features are not working, switching to the /k/ version is recommended.

Check Downloading Progress

A progress bar will show on the bottom-right of the screen for videos. You can also check DevTools console for logs.

Contributing

We welcome contributions from the community! If you’d like to contribute to Telegram Media Downloader, follow these steps:

Reporting Issues

If you find a bug, compatibility issue, or have a feature request, please:

  1. Check if the issue has already been reported in the Issues tab.
  2. If not, create a new issue with a clear title and description. Attach screenshots or logs if applicable.

Submitting Pull Requests

  1. Fork the repository: Click on the "Fork" button in the top-right of the repo.

  2. Clone your fork:

    git clone https://github.com/YOUR-USERNAME/Telegram-Media-Downloader.git
cd Telegram-Media-Downloader

  3. Create a new branch for your feature or bugfix:

    git checkout -b feature-or-bugfix-name

    Make your changes and ensure the script still works correctly on supported Telegram webapps.

  4. Make your changes and ensure the script still works correctly on supported Telegram webapps.

  5. Commit your changes with a descriptive message:

    git commit -m "Add feature/fix issue: Brief description"

  6. Push to your fork:

    git push origin feature-or-bugfix-name

  7. Submit a Pull Request (PR):

Development Guidelines

Help with Translations

We want Telegram Media Downloader to be accessible to users worldwide! If you’d like to help translate the script’s Greasy Fork page, follow these steps:

How to Contribute a Translation

Check for existing translations in the docs/greasyfork folder of the repository.

Add a new file in docs/.md, using the appropriate language code (e.g., docs/fr-FR.md for French, docs/de-DE.md for German).

Translate the content from docs/greasyfork/en-US.md into your language while keeping the formatting intact. Submit a Pull Request following the steps in the Submitting Pull Requests section above.

Language Codes

Use standard IETF Language Tag (e.g., es-ES for Spanish, ja-JP for Japanese). You can find a full list of codes here.

Support Author

If you like this script, you can support me via Venmo or buy me a coffee :)

Telegram-Media-Downloader (Neet-Nestor/Telegram-Media-Downloader)

firefox-extension
Searching Database…

6.1K ·GitHub
Telegram-Media-Downloader
What is this?A userscript that restores the download button for images, GIFs, audios and videos on Telegram Web when a chat or channel has disabled content saving.
Is this a browser extension or a userscript I run inside one?It is a userscript (not a standalone extension): you need a userscript manager like Tampermonkey, Violentmonkey or Greasemonkey installed in your browser, then install this script into it.
How do I install and set it up?Install a userscript manager (Tampermonkey/Violentmonkey/Greasemonkey depending on browser), then either install the script from its Greasy Fork page, or manually drag-and-drop src/teldownload.js into the Tampermonkey dashboard and click install.
Which browsers and script managers are supported?Works with Chrome, Firefox, Safari, Microsoft Edge, Opera and Maxthon, each paired with a compatible manager: Tampermonkey or Violentmonkey (plus Greasemonkey/Userscripts on some browsers).
Does it work for every Telegram chat and feature?It only adds a download button back where saving is restricted; chats that already allow downloads are unaffected, and some features like voice message downloads only work on the 'K' webapp version.
Does it work on Telegram's desktop app or only the web version?It only works on Telegram Web (the webapp in the browser), not the native desktop or mobile apps.
How do I know if a download is working for videos?A progress bar appears in the bottom-right corner of the screen while a video downloads, and you can also check the DevTools console for logs.
What should I do if a feature like voice message download isn't working?Switch from the default Telegram webapp version to the /k/ version, since some features such as voice message downloads are only available there.
Can I use the official Telegram download button instead?Yes, if a chat or channel already allows saving content, this script does nothing and you should just use Telegram's built-in download button.
What are similar projects?cat-catch, maxurl, video_vip, UserScript, desktop_gifs, streamfirefly, TwitchAdSolutions, return-youtube-dislike
Which topics is it in?greasyfork, multi-platform, userscript, gif, video-downloader, firefox, scripting, script, firefox-extension, chrome, downloader, chrome-extension
Creator
Neet-Nestor
Size
1 MB
Stars
6.1K
Updated
CommitMar 09
Age
4y
Commits · 90 Days