Bridger

Multi-Platform Chat Bridge

Active Development
View Code

Project Overview

A lightweight, fully asynchronous Python application that creates multi-way bridges between Telegram, Discord, and WhatsApp.

Bridger is a lightweight, fully asynchronous Python application that creates multi-way bridges between Telegram chats, Discord channels, and WhatsApp groups/chats. Messages, media, reactions, and reply threads flow seamlessly across any number of configured bridges. It supports rich media types and message chunking, and runs easily via a simple YAML configuration natively.

Project Stats

Stars8
LicenseGNU GPLv3
DurationJul 2023 - Mar 2026

Key Features

  • Multi-way text bridging sent on any platform appear on all others
  • Replies are matched and natively threaded on the receiving platforms
  • Reaction sync across platforms
  • Rich media and documents support
  • Support for multiple bridge setups
  • Flexible bot/user accounts setups
  • Long message chunking automatically
  • Containerized deployment with Docker

Technologies Used

Python
SQLite / Database
Docker
Git & GitHub

Technical Implementation

My technical contributions to this project include (but may not be limited to):

  • Engineered a robust, fully asynchronous core using asyncio to handle concurrent message streams and rich media processing across multiple platforms without blocking.
  • Implemented a central Router architecture to act as a message broker, dynamically broadcasting messages, replies, and reactions securely across connected platform clients.
  • Integrated discord.py, Pyrogram, and neonize libraries to create highly resilient and feature-complete interfaces for Discord, Telegram, and WhatsApp respectively.
  • Designed an asynchronous local database using aiosqlite to maintain strict cross-platform message mappings, enabling completely native reply threading and synchronous reaction mapping.
  • Developed intelligent payload parsing for cross-platform rich media capabilities (photos, videos, audio/voice notes, documents, stickers) resolving platform-specific format discrepancies seamlessly.
  • Structured the project with a modular, extensible architecture using a class registry, easily accommodating future platform integrations.
  • Engineered dynamic configurations parsed using PyYAML, supporting complex multigraph bridge topologies out of the box with zero runtime hassle.
  • Handled diverse authentication flows autonomously, seamlessly maintaining both bot tokens and user account sessions directly.
  • Containerized the application using Docker with persistent data bounds configured through robust volume mounts ensuring long-lasting uptime.