https://github.com/simplebot-org/simplebot_tggroups
🌉 DeltaChat/Telegram relay-bot for groups
https://github.com/simplebot-org/simplebot_tggroups
bridge deltachat plugin simplebot telegram
Last synced: about 1 year ago
JSON representation
🌉 DeltaChat/Telegram relay-bot for groups
- Host: GitHub
- URL: https://github.com/simplebot-org/simplebot_tggroups
- Owner: simplebot-org
- License: mpl-2.0
- Created: 2022-10-27T11:26:33.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2023-11-15T11:20:25.000Z (over 2 years ago)
- Last Synced: 2025-04-09T06:11:12.071Z (about 1 year ago)
- Topics: bridge, deltachat, plugin, simplebot, telegram
- Language: Python
- Homepage:
- Size: 34.2 KB
- Stars: 4
- Watchers: 0
- Forks: 0
- Open Issues: 5
-
Metadata Files:
- Readme: README.rst
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
Telegram Groups Bridge
======================
.. image:: https://img.shields.io/pypi/v/simplebot_tggroups.svg
:target: https://pypi.org/project/simplebot_tggroups
.. image:: https://img.shields.io/pypi/pyversions/simplebot_tggroups.svg
:target: https://pypi.org/project/simplebot_tggroups
.. image:: https://pepy.tech/badge/simplebot_tggroups
:target: https://pepy.tech/project/simplebot_tggroups
.. image:: https://img.shields.io/pypi/l/simplebot_tggroups.svg
:target: https://pypi.org/project/simplebot_tggroups
.. image:: https://github.com/simplebot-org/simplebot_tggroups/actions/workflows/python-ci.yml/badge.svg
:target: https://github.com/simplebot-org/simplebot_tggroups/actions/workflows/python-ci.yml
.. image:: https://img.shields.io/badge/code%20style-black-000000.svg
:target: https://github.com/psf/black
A `SimpleBot`_ plugin that allows to bridge Telegram and Delta Chat groups.
For channel subscriptions use: https://github.com/simplebot-org/simplebot_tgchan
Installation
------------
To install run::
pip install simplebot-tggroups
To convert Delta Chat voice messages to mp3 before sending them to the Telegram side,
`pydub `_ is used, you might need to install ``ffmpeg`` in your
system, check: https://github.com/jiaaro/pydub#dependencies, for example to install it in an
apt-based system::
sudo apt install ffmpeg
Configuration
-------------
See https://github.com/simplebot-org/simplebot to know how to configure the bot with an e-mail account.
Before you start using the bot, you need to get your own API ID and hash, go to https://my.telegram.org,
you also need a bot token, got to `@BotFather `_ on Telegram and create a bot,
then to set API ID, API hash and bot token, execute::
simplebot -a bot@example.com telegram
After configuration you can start the bot::
simplebot -a bot@example.com serve
Then you can start bridging Telegram and Delta Chat groups, send ``/help`` to the bot in Delta Chat for
more info.
To bridge a Telegram group to a Delta Chat group:
1. Add the bot in Telegram to your group.
2. Send ``/id`` command in the Telegram group, copy the ID returned by the bot.
3. Add the bot in Delta Chat to your group.
4. Send ``/bridge 1234`` where ``1234`` is the group ID obtained in the Telegram group.
5. Then all messages sent in both groups will be relayed to the other side.
Tweaking Default Configuration
------------------------------
You can tweak the maximum size (in bytes) of attachments the bot will bridge::
simplebot -a bot@example.com telegram --max-size 5242880
By default the bot will download attachments of up to 5MB.
.. _SimpleBot: https://github.com/simplebot-org/simplebot