Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/zenonel/telegrammediarelaybot

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!
https://github.com/zenonel/telegrammediarelaybot

automation content-sharing dotnet media-downloader proxy-support self-hosted social-media telegram-bot video-sharing yt-dlp

Last synced: 3 months ago
JSON representation

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!

Awesome Lists containing this project

README 

          


 Logo




 

 

![License](https://img.shields.io/badge/License-AGPL--3.0-blue)

![.NET Version](https://img.shields.io/badge/.NET-8.0-purple)

![Telegram Bot API](https://img.shields.io/badge/Telegram%20Bot%20API-22.1.3-green)

[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/ZenonEl/TelegramMediaRelayBot)









[README на русском языке](docs/README_RU.md)






**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.



#### Mini-Story of the Project Idea

The 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.



Now, 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.



Thus, the project has transformed into a multifunctional tool for content exchange that can adapt to the needs of each user.



---



## Key Features



- **Video Download**: Support for multiple platforms via **yt-dlp** and **gallery-dl** (**gallery-dl** needs to be downloaded independently).

- **Contact Forwarding**: Ability to add contacts within the bot to whom downloaded videos will be automatically forwarded.

- **Proxy**: Support for proxies (including Tor) for downloading videos.



## Project Details

For 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. 



---



## Changelog



The full history of changes can be found in [CHANGELOG.md](CHANGELOG.md).



## Future Plans

- 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.

- (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.

- ~~(Under consideration) Adding support for **gallery-dl** to download media from even more platforms.~~

- More detailed contact management (~~deletion~~, editing, etc.).

- ~~Creating and managing contact groups within the bot~~.

- (Under consideration) Support for text formatting.

- ~~Ability to recreate the personal link within the bot (with the option to delete all contacts or keep them).~~

- ~~Ability to enable a filter for accessing the bot (for example, you can only start using the bot by using someone's referral link).~~

- (Under consideration) Administrative functions for managing the bot within itself.

- ~~Creating a ready-to-use executable file.~~

- And various other improvements and fixes ✨



## Roadmap



Development 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.



## Logging

The bot logs all actions to the console. In the future, logging to a file is planned. Logs can be configured in the settings file.



## License

The project is distributed under the **AGPL-3.0** license. Details can be found in the [LICENSE](LICENSE) file.



## Feedback

If you have questions, suggestions, or find a bug, please create an [issue](https://github.com/ZenonEl/TelegramMediaRelayBot/issues) in the repository.

Or you can contact me at [Mastodon](https://lor.sh/@ZenonEl)



## Contributing

The project is not currently accepting contributions, but this may change in the future. Stay tuned for updates!



## Copyright (C) 2024-2025 ZenonEl



This 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.