yabb - yet another bridge, bb 👶

                     __        __       
                    /  |      /  |      
 __    __   ______  $$ |____  $$ |____  
/  |  /  | /      \ $$      \ $$      \ 
$$ |  $$ | $$$$$$  |$$$$$$$  |$$$$$$$  |
$$ |  $$ | /    $$ |$$ |  $$ |$$ |  $$ |
$$ \__$$ |/$$$$$$$ |$$ |__$$ |$$ |__$$ |
$$    $$ |$$    $$ |$$    $$/ $$    $$/ 
 $$$$$$$ | $$$$$$$/ $$$$$$$/  $$$$$$$/  
/  \__$$ |                              
$$    $$/                               
 $$$$$$/                                

A utility to bridge Discord channels/chats and Telegram groups/group threads.

---

Setup

After cloning the repo:

cp .env.example .env  # and edit to fill in your details
cp example.config.yml config.yml  # and edit to fill in your details

 

To create a Discord application/bot:

Visit the Discord Developer Portal and create a new application.

Then:

• Installation: Disable install link
• OAuth2: Generate a link to invite to your own guild by checking off "Bot" and then "Administrator"
  • Add the bot to your server using this link
• Bot:
  • Uncheck Public Bot
  • Check Message Content Intent (so that it can read messages)
  • Reset token; save this value in your .env file under the DISCORD_BOT_TOKEN variable

 

To create a Telegram bot:

Message @BotFather to create a new bot. Set the details to your preference.

Then:

• Set bot privacy so that it can listen to all messages
  1. /setprivacy
  2. Select your bridge bot
  3. Select "Disable" option
• Copy the bot token; save this value in your .env file under the TELEGRAM_BOT_TOKEN variable
• Add the bot to your Telegram group(s)

 

To map channels between platforms:

Edit config.yml and add an entry for each channel mapping you would like to use. To get channel IDs:

Platform	Instructions	Example
Discord	Right click the channel and select "Copy Channel ID" (enable Developer Settings if you do not see this)	123456789012345678
Telegram	Right click on any message in your group chat and select "Copy Message Link". The format will be either: https://t.me/c/<chat_id>/<message_id> or https://t.me/c/<chat_id>/<thread_id>/<message_id>. If you do not have a thread_id or the thread_id is 1, you only need the chat_id, else be sure to use the thread id in the mapping config's telegram_thread_id field. Final note: prefix the chat ID with -100.	-1009876543210

See example.config.yml for reference.

 

Running

docker compose up -d