{"id":15205446,"url":"https://github.com/Neet-Nestor/Telegram-Media-Downloader","last_synced_at":"2025-10-02T23:35:20.107Z","repository":{"id":40325687,"uuid":"502268029","full_name":"Neet-Nestor/Telegram-Media-Downloader","owner":"Neet-Nestor","description":"A script allowing you to download images and videos from Telegram web even if the group restricts downloading.","archived":false,"fork":false,"pushed_at":"2024-09-22T23:40:39.000Z","size":1012,"stargazers_count":1396,"open_issues_count":26,"forks_count":132,"subscribers_count":11,"default_branch":"main","last_synced_at":"2024-09-25T15:54:40.082Z","etag":null,"topics":["greasyfork","greasymonkey","greasymonkey-userscript","javascript","telegram","userscript"],"latest_commit_sha":null,"homepage":"https://greasyfork.org/en/scripts/446342-telegram-media-downloader","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Neet-Nestor.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-06-11T06:20:37.000Z","updated_at":"2024-09-25T08:54:42.000Z","dependencies_parsed_at":"2023-02-12T06:55:14.725Z","dependency_job_id":"76160812-cbf1-4e66-b531-c1ca88ca9607","html_url":"https://github.com/Neet-Nestor/Telegram-Media-Downloader","commit_stats":{"total_commits":54,"total_committers":5,"mean_commits":10.8,"dds":"0.12962962962962965","last_synced_commit":"56e62233133006ca850293c51f7393568599326d"},"previous_names":[],"tags_count":15,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Neet-Nestor%2FTelegram-Media-Downloader","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Neet-Nestor%2FTelegram-Media-Downloader/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Neet-Nestor%2FTelegram-Media-Downloader/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Neet-Nestor%2FTelegram-Media-Downloader/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Neet-Nestor","download_url":"https://codeload.github.com/Neet-Nestor/Telegram-Media-Downloader/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":219876107,"owners_count":16554735,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["greasyfork","greasymonkey","greasymonkey-userscript","javascript","telegram","userscript"],"created_at":"2024-09-28T06:01:43.384Z","updated_at":"2025-10-02T23:35:20.099Z","avatar_url":"https://github.com/Neet-Nestor.png","language":"JavaScript","funding_links":["https://ko-fi.com/neetnestor"],"categories":["JavaScript"],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# Telegram Video Downloader / Telegram Media Downloader\n\n**Unlock Telegram: Download Anything You Like.**\n\n[![GitHub License](https://img.shields.io/github/license/Neet-Nestor/Telegram-Media-Downloader)](./LICENSE)\n[![Greasy Fork Version](https://img.shields.io/greasyfork/v/446342-telegram-media-downloader)](https://greasyfork.org/scripts/446342-telegram-media-downloader)\n[![Greasy Fork Downloads](https://img.shields.io/greasyfork/dt/446342-telegram-media-downloader)](https://greasyfork.org/scripts/446342-telegram-media-downloader)\n\n\u003c/div\u003e\n\n## Overview\nThis 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.\n\n(Note: some features are only available for specific Telegram webapp version. e.g. Audio message download is only available for the K webapp version.)\n\n### What are user scripts?\nUser 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.\n\n## Installation\n### Greasy Fork\n1. install a user script manager\n\n    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.\n\n    - Chrome: [Tampermonkey](https://chrome.google.com/webstore/detail/tampermonkey/dhdgffkkebhmkfjojejmpbldmpobfkfo) or [Violentmonkey](https://chrome.google.com/webstore/detail/violent-monkey/jinjaccalgkegednnccohejagnlnfdag)\n    - Firefox: [Greasemonkey](https://addons.mozilla.org/firefox/addon/greasemonkey/), [Tampermonkey](https://addons.mozilla.org/firefox/addon/tampermonkey/), or [Violentmonkey](https://addons.mozilla.org/firefox/addon/violentmonkey/)\n    - Safari: [Tampermonkey](https://chrome.google.com/webstore/detail/tampermonkey/dhdgffkkebhmkfjojejmpbldmpobfkfo) or [Userscripts](https://apps.apple.com/app/userscripts/id1463298887)\n    - Microsoft Edge: [Tampermonkey](https://chrome.google.com/webstore/detail/tampermonkey/dhdgffkkebhmkfjojejmpbldmpobfkfo) or [Violentmonkey](https://chrome.google.com/webstore/detail/violent-monkey/jinjaccalgkegednnccohejagnlnfdag)\n    - Opera: [Tampermonkey](https://chrome.google.com/webstore/detail/tampermonkey/dhdgffkkebhmkfjojejmpbldmpobfkfo) or [Violentmonkey](https://chrome.google.com/webstore/detail/violent-monkey/jinjaccalgkegednnccohejagnlnfdag)\n    - Maxthon: [Violentmonkey](https://chrome.google.com/webstore/detail/violent-monkey/jinjaccalgkegednnccohejagnlnfdag)\n\n    (Note, If you are using Tampermonkey extension in a Chrome-based browser, following [instructions](https://www.tampermonkey.net/faq.php#Q209) to enable Developer Mode.)\n\n2. Install this script by visiting Greasy Fork:\n    https://greasyfork.org/scripts/446342-telegram-media-downloader\n\n### Manual Installation\n1. install a user script manager\n\n    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.\n\n    - Chrome: [Tampermonkey](https://chrome.google.com/webstore/detail/tampermonkey/dhdgffkkebhmkfjojejmpbldmpobfkfo) or [Violentmonkey](https://chrome.google.com/webstore/detail/violent-monkey/jinjaccalgkegednnccohejagnlnfdag)\n    - Firefox: [Greasemonkey](https://addons.mozilla.org/firefox/addon/greasemonkey/), [Tampermonkey](https://chrome.google.com/webstore/detail/tampermonkey/dhdgffkkebhmkfjojejmpbldmpobfkfo), or [Violentmonkey](https://chrome.google.com/webstore/detail/violent-monkey/jinjaccalgkegednnccohejagnlnfdag)\n    - Safari: [Tampermonkey](https://chrome.google.com/webstore/detail/tampermonkey/dhdgffkkebhmkfjojejmpbldmpobfkfo) or [Userscripts](https://apps.apple.com/app/userscripts/id1463298887)\n    - Microsoft Edge: [Tampermonkey](https://chrome.google.com/webstore/detail/tampermonkey/dhdgffkkebhmkfjojejmpbldmpobfkfo) or [Violentmonkey](https://chrome.google.com/webstore/detail/violent-monkey/jinjaccalgkegednnccohejagnlnfdag)\n    - Opera: [Tampermonkey](https://chrome.google.com/webstore/detail/tampermonkey/dhdgffkkebhmkfjojejmpbldmpobfkfo) or [Violentmonkey](https://chrome.google.com/webstore/detail/violent-monkey/jinjaccalgkegednnccohejagnlnfdag)\n    - Maxthon: [Violentmonkey](https://chrome.google.com/webstore/detail/violent-monkey/jinjaccalgkegednnccohejagnlnfdag)\n\n    (Note, If you are using Tampermonkey extension in a Chrome-based browser, following [instructions](https://www.tampermonkey.net/faq.php#Q209) to enable Developer Mode.)\n    \n2. Open Tampermonkey Dashboard, drag \u0026 drop src/tel_download.js into it and clicks the \"install\" button\n\n## How to Use\nThis script only works on Telegram Webapp.\n\nFor 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.\n\nFor channels and chats that disable downloading and restrict saving content, this script will add the download button back for images, GIFs and videos.\n\n![Image Download](https://media2.giphy.com/media/v1.Y2lkPTc5MGI3NjExY2VjNmU2ZDM0YTFlOWY4YTMzZDZmNjVlMDE2ODQ4OGY4N2E3MDFkNSZlcD12MV9pbnRlcm5hbF9naWZzX2dpZklkJmN0PWc/lqCVcw0pCd2VA3zqoE/giphy.gif)\n![GIF Download](https://media0.giphy.com/media/v1.Y2lkPTc5MGI3NjExMzYwMzM3ZTMzYmI1MzA4M2EyYmY0NTFlOTg4OWFhNjhjNDk5YTkzYiZlcD12MV9pbnRlcm5hbF9naWZzX2dpZklkJmN0PWc/wnYzW4vwpPdeuo62nQ/giphy.gif)\n![Video Download](https://media1.giphy.com/media/v1.Y2lkPTc5MGI3NjExMXcxYnJxaXMxcW05YW5rZ2YzZzE0bTU4aTBwYXI1N3pmdnVzbDFrdSZlcD12MV9pbnRlcm5hbF9naWZfYnlfaWQmY3Q9Zw/EEPbblwmSpteAmwLls/giphy.gif)\n![Story Download](https://media0.giphy.com/media/v1.Y2lkPTc5MGI3NjExZ3Z5Y2VzM2QzbW1xc3ZwNTQ2N3Q0a3lnanpxdW55c2Qzajl5NXZsaCZlcD12MV9pbnRlcm5hbF9naWZfYnlfaWQmY3Q9Zw/xJFjBGi8isHPR5cuHl/giphy.gif)\n\nFor 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.\n\n### Supported Webapp Versions\nThere are 2 different versions of telegram webapps:\n- https://webk.telegram.org / https://web.telegram.org/k/ (**Recommended**)\n- https://webz.telegram.org / https://web.telegram.org/a/\n\nThis 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.\n\n### Check Downloading Progress\nA progress bar will show on the bottom-right of the screen for videos. You can also check [DevTools console](https://developer.chrome.com/docs/devtools/open/) for logs.\n\n## Contributing\n\nWe welcome contributions from the community! If you’d like to contribute to Telegram Media Downloader, follow these steps:\n\n### Reporting Issues\nIf you find a bug, compatibility issue, or have a feature request, please:\n\n1. Check if the issue has already been reported in the Issues tab.\n2. If not, create a new issue with a clear title and description. Attach screenshots or logs if applicable.\n\n### Submitting Pull Requests\n\n1. **Fork the repository**: Click on the \"Fork\" button in the top-right of the repo.\n\n2. **Clone your fork**:\n\n    ```bash\n    git clone https://github.com/YOUR-USERNAME/Telegram-Media-Downloader.git\n    cd Telegram-Media-Downloader\n    ```\n\n3. **Create a new branch** for your feature or bugfix:\n\n    ```bash\n    git checkout -b feature-or-bugfix-name\n    ```\n\n    Make your changes and ensure the script still works correctly on supported Telegram webapps.\n\n4. **Make your changes** and ensure the script still works correctly on supported Telegram webapps.\n\n5. **Commit your changes** with a descriptive message:\n\n    ```bash\n    git commit -m \"Add feature/fix issue: Brief description\"\n    ```\n\n6. **Push to your fork:**\n\n    ```bash\n    git push origin feature-or-bugfix-name\n    ```\n\n7. **Submit a Pull Request (PR):**\n\n    - Go to the original repository: [Neet-Nestor/Telegram-Media-Downloader](https://github.com/Neet-Nestor/Telegram-Media-Downloader).\n\n    - Click \"New Pull Request\" and select your branch.\n\n    - Add a description of your changes and submit.\n\n### Development Guidelines\n- Keep your code clean and well-documented.\n- Follow the existing coding style.\n- Test your changes on both Telegram WebK and WebZ versions.\n- Ensure compatibility with major user script managers like Tampermonkey and Violentmonkey.\n\n### Help with Translations\nWe 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:\n\n#### How to Contribute a Translation\n\nCheck for existing translations in the [`docs/greasyfork`](/docs/greasyfork/) folder of the repository.\n\nAdd a new file in docs/\u003clanguage-code\u003e.md, using the appropriate language code (e.g., docs/fr-FR.md for French, docs/de-DE.md for German).\n\nTranslate the content from [`docs/greasyfork/en-US.md`](/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](#submitting-pull-requests) section above.\n\n#### Language Codes\nUse standard IETF Language Tag (e.g., `es-ES` for Spanish, `ja-JP` for Japanese). You can find a full list of codes [here](https://docs.dyspatch.io/localization/supported_languages/).\n\n## Support Author\nIf you like this script, you can support me via [Venmo](https://venmo.com/u/NeetNestor) or [buy me a coffee](https://ko-fi.com/neetnestor) :)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FNeet-Nestor%2FTelegram-Media-Downloader","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FNeet-Nestor%2FTelegram-Media-Downloader","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FNeet-Nestor%2FTelegram-Media-Downloader/lists"}