Skip to main content

πŸ’¬ Usage

🌐 Adding Contacts β€” Create Your Mini Digital Network​

TelegramMediaRelayBot is a convenient tool that simplifies and speeds up content sharing between users of different platforms. The bot acts as a universal intermediary, allowing you to share media files along with your thoughts without unnecessary complications.

For example, if some of your friends are always on YouTube, while others are on Reddit, they no longer need to create additional accounts, download extra apps, or look for workarounds. Simply connect to TelegramMediaRelayBot, and content sharing will become instant and convenient for everyone.

With this bot, you can:

  • Easily share media files between users of different platforms.
  • Avoid the need to register on new services or use multiple apps.
  • Ultimately save time by eliminating unnecessary steps.

Connect all members of your media circle to TelegramMediaRelayBot and enjoy simple and fast content sharing!

How to connect members of your media circle:

  1. πŸ”„ Initiate Connection
    Send the /start command and click the "Add Contact" button in the menu.
    β†’ The bot will request a unique link from the user, like:
    1234ab56-cde-78fg-01hi-2j34k56790

  2. πŸ”— Exchange Identifiers

    • Your link can be found in the "My Link" section.
    • Share it with future contacts β€” for example, via a QR code or a private message.

  3. 🀝 Confirm the Contact

    • Paste the received link into the input field and send it to the bot.
    • If everything is correct, you’ll see a brief user profile.

  4. ⏳ Wait for a Response

    • Your request will be sent to the recipient, and they will receive a notification.
    • Once they accept the invitation (via the "Review Incoming Requests" section), you can start exchanging content with each other.
    tip

    Don’t hesitate to use groups: Contacts can and should be grouped into different categories like Colleagues, Friends, Bird Lovers Society πŸ¦β€β¬›οΈ β€” for targeted distribution to multiple contacts at once.

πŸš€ Downloading and Forwarding Content β€” Magic in Three Steps​

πŸ“₯ Working with Links​

Simply send the bot a link + description (if needed, and always on a new line) in the format:

https://youtu.be/your_awesome_video  
Check out this cosmic dance of the northern lights! 🌌 #nature #wow
caution

If you use a description, make sure it starts on a new line!

β†’ The bot will handle the rest:

  1. Identify the platform β€” whether it’s YouTube, TikTok, Instagram, or any other service.
  2. Download the content in optimal quality (with the ability to customize preferences in the configuration).
  3. Forward the video exactly where and to whom it needs to go. ✨

πŸ”„ Automatic Distribution​

  • Your file will instantly be sent to all specified contacts from your list.
    Conditions: Contacts must be in your list. You must not be muted by these contacts. Distribution settings must be configured correctly.
tip

Tip: Use hashtags in the description!
This will allow you to easily find content in chat history. For example, search by tags like #cats or #work.
Built-in hashtags also work, but custom ones are more convenient and personalized.

πŸ”— Supported Platforms​

The bot works with 1000+ sources thanks to yt-dlp integration β€” the full list is here.
Possible in the future: integration with gallery-dl for downloading entire galleries and archives!

✨ The project is constantly evolving: new features are popping up like mushrooms after the rain! πŸ„
To stay updated and not miss anything important:

  • Follow my account on Mastodon.
  • Or simply stay informed through the person who invited you to this exciting digital media whirlpool! πŸ˜‰