This bot requires Python 3.8 or higher
A bot forwarding broadcast Telegram channel posts to Discord channels. The main purpose of this bot is to provide a one-way connection from Telegram announcements to Discord announcements for Oulun Tietoteekkarit ry (University of Oulu CSE student guild).
Simply put the bot listens to a Telegram channel, and after a new message sends it to all configured Discord channels in a Discord compatible format. In addition to new messages, edits, replies and forwards are fully supported. Only attachments and other non-text media are yet to be supported.
The telegram library used in this bot is also made by me and has its own repository telegram.py.
For images of the features see section Images.
Before running the bot an application and API tokens for both Telegram API and Discord API are needed.
To run an instance of this bot by yourself, all that is required is to configure the config.toml file.
A prefilled template can be found from config_example.toml. There can currently be only one Telegram channel to listen
and an arbitrary amount of Discord channels where the
messages are forwarded.
The capability of editing and replying to old Discord messages depends solely on if they are found in the bots'
database. This can be adjusted with variable message_cleanup_threshold in preferences.
IDs for both Discord and Telegram are always integers, and for Telegram they start with -100.
IDs can be edited in the configuration file and then reloaded in runtime by using command reload through Discord.
Bot settings are a way to configure Discord bot settings for each run. This means that modifying bot settings requires a restart for the whole bot for them to make effect. Following bot settings are currently available:
-
command_prefix: String or iterable of strings. This determines accepted command prefix(es) for the Discord bot. For further information and notes about iterable prefixes, see the discord.py command prefix documentation. -
activity_status: String value. This value can be used to set the bot status in Discord. Empty string can be used to have no status at all. -
dm_only_commands: Boolean value. Determine if bot commands should be accepted only through Discord direct messages. Setting this value to false allows bot commands to be executed in any Discord channel it can read.
Preferences can be used to control the bots message forwarding behaviour in more readable way. Preferences can be
modified and then reloaded in runtime by using Discord bot command reload.
Following preferences are currently available:
-
prefer_telegram_usernames: Boolean value. In forwarded user messages prefer their username over their real name(s) if possible. Has no effect for forwarded channel posts. -
send_orphans_as_new_message: Boolean value. Send edits and replies not found from the database as completely new messages. Do note that e.g. short replies to old messages can look out of place this way, and some context should perhaps be given. -
message_cleanup_threshold: Integer value. Inclusive age in days for Discord message references to be deleted from the database in 6 hour intervals. References at least this old will be deleted, and cannot be replied or edited in Discord anymore. -
update_age_threshold: Integer value. Inclusive maximum age in seconds for hanging Telegram messages to forward to Discord, due to e.g. lag spikes or bot downtimes. -
database_path: String value. Path to the sqlite3 database file used for storing message references.
Once the bot is listening to a Telegram channel and has some Discord channels defined, it forwards all messages to Discord and serializes them into an internal database for possible edits and replies. The messages are sent to Discord as soon as they are received, but discord.py internal ratelimiting may affect the speed if messages are sent rapidly.
Example of the fully supported nested text formatting:
Messages can of course also be edited:
...And replied to:
The maximum length for messages is 4096 characters like in free Telegram version:
MIT Licence
Full licence: LICENCE