Skip to content

brandonmoss-99/Telegram-Tweet-Media-Downloader-Bot

Repository files navigation

Telegram Tweet Media Downloader Bot

Tests License Docker image pulls Docker image size

What does this do?

This is a bot for the Telegram messaging service, with the purpose of downloading and saving media from tweets to a local machine (thanks to gallery-dl). It is intended to be run within a containerised solution.

Configuration

Environment variables

The following environment variables are used by the bot, and should be passed into the container's environment when run:

Required:

  • T_TOKEN - The Telegram Bot API token to use. Should be a String, "12345:AAAABBBBCCCCDDDD"
  • ALLOWED_IDS - The Telegram user IDs to accept messages from. This is required, as without it, anyone who finds your bot username on Telegram will be able to send a link, and download media to your server. Should be a comma separated String of IDs, "123456,654321"

Optional:

  • LOG_LEVEL - The lowest level of logging to output, as a String. Can be one of the following: "debug", "info", "warn", "error", or "critical". Defaults to "info"

Cookies

A valid Twitter cookie file allows gallery-dl to access the same tweets you can see. Without this, it will only be able to access what is publicly visible. A file named twitter_cookies.txt should be present in the top directory.

gallery-dl configuration

gallery-dl accepts a wide range of configuration options. An example gallery-dl.conf file is included, but this can be adjusted to your requirements (See gallery-dl configuration for more).

About

A Telegram bot to download media from Twitter URLs sent to it

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published