UnifiedMessageRelay is a framework for the purpose of bringing messages from different chat platform together. With UnifiedMessageRelay, user no longer need to view messages on different platform, or different groups. UnifiedMessageRelay brings powerful message forwarding functionality and flexible plugin API to meet your custom need. A driver API specification is also provided, so one can compose their own backend driver, and the framework will load and utilize the driver automatically.
Telegram <-> QQ:
Telegram <-> Discord:
All four platforms: QQ, Telegram, Line and Discord can forward between each other directly.
- QQ API based on CoolQ HTTP API aiocqhttp
- Mirai API based on multiple repos from Mamoe Technologies
- Telegram API based on aiogram
- Line API based on linebotx linebot
- Discord API based on Discord.py
- Forward text and image between all supported platforms
- Image is converted to supported format automatically
- Reply is preserved with best effort
- Markdown format is preserved for supported platforms
- Command API for customize triggers
- Message Hook API for even more customized needs
Limited support for Coolq Air. image sending is available for Coolq Pro.
Make sure Python 3.7+ and pip are installed. Run:
pip3 install unified-message-relay
To install every python module in one line:
pip3 install -U umr_telegram_driver umr_line_driver umr_discord_driver umr_coolq_driver umr_mirai_driver umr_extensions_demo
apt install libcairo2 ffmpeg libmagickwand-dev
Create ~/.umr/
mkdir ~/.umrCopy config.yaml to ~/.umr
The "QQ", "Telegram" or "Line" above are all custom names. Real bot driver should be configure throgh "Driver" list.
unified_message_relay -h- Start background service
unified_message_relay startor
unified-message-relay restartBy default, log will be stored in /var/log/umr/bot.log, and cache will be cleared out upon start.
- Stop the background service
unified_message_relay stopIf you need to see the log output for debugging purpose, stop the running daemon first. Then follow this command.
Remember to enable debug option in config.
unified_message_relay runHit Ctrl + C to stop.
Example extensions and commands now require extension umr-extensions-demo:
pip install umr-extensions-demoand put - umr_extensions_demo under Extensions section of config.yaml.
Send !!help to show available commands.
This command requires no extra module.
Send !!id anywhere to see chat id.
Reply message with !!id to reveal source chat id.
This command requires cmd_id.py under umr_extension_demo.
Reply to the message you want to delete with !!del
This command requires QQ_recall.py under umr_extension_demo and using coolq driver.
Mirai recall is not supported at this time.
Message containing these keyword will not be forwarded to any other chat
Send !!bk and keywords separated by space
This command requires Telegram_watermeter.py under umr_extension_demo and using telegram driver.
Message originated from these channel will not be forwarded to any other chat
Reply forwarded channel message with !!bc
This command requires Telegram_watermeter.py under umr_extension_demo and using telegram driver.
To modify saved keywords and channels, edit ExtensionConfig section in config.yaml.
Add // at the beginning of the message to avoid forwarding to any other chat.
- Use
unified-message-relay runto print log to stdout - Check if you are using Python 3.7+
- Check if binary dependencies are installed (search apt in this page)
- (If using Coolq) Check if cq-http-api is enabled in Coolq
- Check if the log suggests any missing configuration
- Check if you are on Dev branch, please switch back to master (dev may be unstable)
- Descriptions about the issue
- Logs of python3 daemon.py run (Desensitization)
- Steps to reproduce
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent