{"id":23875309,"url":"https://github.com/zenonel/telegrammediarelaybot","last_synced_at":"2026-05-06T00:37:52.248Z","repository":{"id":269914602,"uuid":"898428116","full_name":"ZenonEl/TelegramMediaRelayBot","owner":"ZenonEl","description":"TelegramMediaRelayBot is a self-hosted Telegram bot that automates downloading and forwarding videos from multiple platforms. It simplifies media sharing by eliminating manual downloads and supports proxies. Perfect for automating content exchange with your acquaintances!","archived":false,"fork":false,"pushed_at":"2025-10-15T14:01:51.000Z","size":8840,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-15T16:22:56.512Z","etag":null,"topics":["automation","content-sharing","dotnet","media-downloader","proxy-support","self-hosted","social-media","telegram-bot","video-sharing","yt-dlp"],"latest_commit_sha":null,"homepage":"https://zenonel.github.io/TelegramMediaRelayBot-Site/","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ZenonEl.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-12-04T11:28:16.000Z","updated_at":"2025-08-11T04:31:26.000Z","dependencies_parsed_at":"2024-12-27T06:22:40.725Z","dependency_job_id":"30f84659-b6f6-4c2c-a9f8-0d3af42b84e8","html_url":"https://github.com/ZenonEl/TelegramMediaRelayBot","commit_stats":null,"previous_names":["zenonel/telegrammediarelaybot"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/ZenonEl/TelegramMediaRelayBot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ZenonEl%2FTelegramMediaRelayBot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ZenonEl%2FTelegramMediaRelayBot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ZenonEl%2FTelegramMediaRelayBot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ZenonEl%2FTelegramMediaRelayBot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ZenonEl","download_url":"https://codeload.github.com/ZenonEl/TelegramMediaRelayBot/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ZenonEl%2FTelegramMediaRelayBot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279260716,"owners_count":26136177,"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","status":"online","status_checked_at":"2025-10-16T02:00:06.019Z","response_time":53,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["automation","content-sharing","dotnet","media-downloader","proxy-support","self-hosted","social-media","telegram-bot","video-sharing","yt-dlp"],"created_at":"2025-01-03T18:19:48.528Z","updated_at":"2025-10-17T00:32:25.999Z","avatar_url":"https://github.com/ZenonEl.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n \u003cimg src=\"Logo.jpg\" width=\"512\" height=\"384\" alt=\"Logo\"\u003e\n\u003c/p\u003e\n\n\u003cdiv align=\"center\"\u003e \n \n![License](https://img.shields.io/badge/License-AGPL--3.0-blue)\n![.NET Version](https://img.shields.io/badge/.NET-8.0-purple)\n![Telegram Bot API](https://img.shields.io/badge/Telegram%20Bot%20API-22.1.3-green)\n[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/ZenonEl/TelegramMediaRelayBot)\n\n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\n\n[README на русском языке](docs/README_RU.md)\n\n\u003c/div\u003e\n\n**TelegramMediaRelayBot** is a self-hosting bot for Telegram that allows you and your contacts to automatically download and send videos from multiple [platforms](https://github.com/yt-dlp/yt-dlp/blob/master/supportedsites.md) (thanks to [yt-dlp](https://github.com/yt-dlp/yt-dlp/tree/master)). The bot simplifies the process of sharing media files, eliminating the need to manually download and send videos to those who don't use a particular platform.\n\n\n#### Mini-Story of the Project Idea\nThe idea for this project originated from my girlfriend's complaints about having to manually download videos from TikTok for my convenience, as I do not use the platform myself. This led me to the idea of creating a bot that would automatically download videos and send them. However, over time, I became so engrossed in the project that I decided to scale it up.\n\nNow, it does not just download videos and send them to a single user; it has evolved into something much greater—a constantly developing and growing mini-ecosystem that every user can recreate and invite the people they need into. This simplifies content sharing between users in various situations.\n\nThus, the project has transformed into a multifunctional tool for content exchange that can adapt to the needs of each user.\n\n---\n\n\n## Key Features\n\n- **Video Download**: Support for multiple platforms via **yt-dlp** and **gallery-dl** (**gallery-dl** needs to be downloaded independently).\n- **Contact Forwarding**: Ability to add contacts within the bot to whom downloaded videos will be automatically forwarded.\n- **Proxy**: Support for proxies (including Tor) for downloading videos.\n\n## Project Details\nFor more detailed familiarization with the functionality of my project and its features, you can refer to the detailed documentation. It is available on my website at [link](https://zenonel.github.io/TelegramMediaRelayBot-Site) or in the folder [docs](documentation/en/index.md), which is located in the root directory of the project. In the documentation you will find information not only about the functionality, but also about the process of setting up, installing and using my solution. I recommend you to familiarize yourself with it in order to use all the functions of our project as efficiently as possible. \n\n---\n\n## Changelog\n\nThe full history of changes can be found in [CHANGELOG.md](CHANGELOG.md).\n\n## Future Plans\n- Plugin support system and pre-built plugins for monetisation: It is planned to create a system of plugins that will extend the functionality of the bot. This will include plugins that allow you to use the bot for tasks related to commercial activities. These plugins will provide additional tools for convenient management and new features, making the bot a universal solution for both personal use and the possibility of monetising it.\n- (Under review) **Mobile device support**: For users who can't keep the bot running smoothly on the servers, there may be an option to run the bot directly on their mobile phone. If possible, the database will also be synchronised with the main database.\n- ~~(Under consideration) Adding support for **gallery-dl** to download media from even more platforms.~~\n- More detailed contact management (~~deletion~~, editing, etc.).\n- ~~Creating and managing contact groups within the bot~~.\n- (Under consideration) Support for text formatting.\n- ~~Ability to recreate the personal link within the bot (with the option to delete all contacts or keep them).~~\n- ~~Ability to enable a filter for accessing the bot (for example, you can only start using the bot by using someone's referral link).~~\n- (Under consideration) Administrative functions for managing the bot within itself.\n- ~~Creating a ready-to-use executable file.~~\n- And various other improvements and fixes ✨\n\n## Roadmap\n\nDevelopment plans and current goals for the new version are available on the latest release page. You can follow the progress of the tasks right there.\n\n## Logging\nThe bot logs all actions to the console. In the future, logging to a file is planned. Logs can be configured in the settings file.\n\n\n\n## License\nThe project is distributed under the **AGPL-3.0** license. Details can be found in the [LICENSE](LICENSE) file.\n\n\n\n## Feedback\nIf you have questions, suggestions, or find a bug, please create an [issue](https://github.com/ZenonEl/TelegramMediaRelayBot/issues) in the repository.\nOr you can contact me at [Mastodon](https://lor.sh/@ZenonEl)\n\n\n\n## Contributing\nThe project is not currently accepting contributions, but this may change in the future. Stay tuned for updates!\n\n\n\n## Copyright (C) 2024-2025 ZenonEl\n\nThis program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzenonel%2Ftelegrammediarelaybot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzenonel%2Ftelegrammediarelaybot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzenonel%2Ftelegrammediarelaybot/lists"}