https://github.com/mautrix/telegram

A Matrix-Telegram hybrid puppeting/relaybot bridge
https://github.com/mautrix/telegram

bridge matrix matrix-appservice matrix-org python telegram telegram-client telethon

Last synced: about 1 month ago
JSON representation

A Matrix-Telegram hybrid puppeting/relaybot bridge

• Host: GitHub
• URL: https://github.com/mautrix/telegram
• Owner: mautrix
• License: agpl-3.0
• Created: 2017-11-12T15:42:45.000Z (about 8 years ago)
• Default Branch: master
• Last Pushed: 2025-05-07T12:02:36.000Z (8 months ago)
• Last Synced: 2025-05-14T08:04:38.340Z (8 months ago)
• Topics: bridge, matrix, matrix-appservice, matrix-org, python, telegram, telegram-client, telethon
• Language: Python
• Homepage: https://matrix.to/#/#telegram:maunium.net
• Size: 3.26 MB
• Stars: 1,450
• Watchers: 28
• Forks: 195
• Open Issues: 157
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE
  • Roadmap: ROADMAP.md

Awesome Lists containing this project

• awesome-starred - mautrix/telegram - A Matrix-Telegram hybrid puppeting/relaybot bridge (telegram)

README

          
# mautrix-telegram

![Languages](https://img.shields.io/github/languages/top/mautrix/telegram.svg)

[![License](https://img.shields.io/github/license/mautrix/telegram.svg)](LICENSE)

[![Release](https://img.shields.io/github/release/mautrix/telegram/all.svg)](https://github.com/mautrix/telegram/releases)

[![GitLab CI](https://mau.dev/mautrix/telegram/badges/master/pipeline.svg)](https://mau.dev/mautrix/telegram/container_registry)

[![Code style](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)

[![Imports](https://img.shields.io/badge/%20imports-isort-%231674b1?style=flat&labelColor=ef8336)](https://pycqa.github.io/isort/)

A Matrix-Telegram hybrid puppeting/relaybot bridge.

## Sponsors

* [Joel Lehtonen / Zouppen](https://github.com/zouppen)

## Documentation

All setup and usage instructions are located on

[docs.mau.fi](https://docs.mau.fi/bridges/python/telegram/index.html).

Some quick links:

* [Bridge setup](https://docs.mau.fi/bridges/python/setup.html?bridge=telegram)

  (or [with Docker](https://docs.mau.fi/bridges/general/docker-setup.html?bridge=telegram))

* Basic usage: [Authentication](https://docs.mau.fi/bridges/python/telegram/authentication.html),

  [Creating chats](https://docs.mau.fi/bridges/python/telegram/creating-and-managing-chats.html),

  [Relaybot setup](https://docs.mau.fi/bridges/python/telegram/relay-bot.html)

### Features & Roadmap

[ROADMAP.md](https://github.com/mautrix/telegram/blob/master/ROADMAP.md)

contains a general overview of what is supported by the bridge.

## Discussion

Matrix room: [`#telegram:maunium.net`](https://matrix.to/#/#telegram:maunium.net)

Telegram chat: [`mautrix_telegram`](https://t.me/mautrix_telegram) (bridged to Matrix room)

## Preview

![Preview](preview.png)