UnifiedMessageRelay

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.

Demo

Telegram <-> QQ:

Telegram <-> Discord:

All four platforms: QQ, Telegram, Line and Discord can forward between each other directly.

Supported platforms

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

Update

ChangeLog.md

Features

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.

Installation

Framework Setup

Install python dependencies on host os

Make sure Python 3.7+ and pip are installed. Run:

pip3 install unified-message-relay

TLDR

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

Install other required package on host os

apt install libcairo2 ffmpeg libmagickwand-dev

Configurations

Create ~/.umr/

mkdir ~/.umr

Copy config.yaml to ~/.umr

Why yaml instead of json?

Full Example config

The "QQ", "Telegram" or "Line" above are all custom names. Real bot driver should be configure throgh "Driver" list.

Follow the guide for your platform

Mirai

Line

Discord

Start the bot

Viewing CLI Help

unified_message_relay -h

Background process

Start background service

unified_message_relay start

unified-message-relay restart

By 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 stop

Foreground process (for debugging purpose)

If 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 run

Hit Ctrl + C to stop.

Extensions and Commands

Example extensions and commands now require extension umr-extensions-demo:

pip install umr-extensions-demo

and put - umr_extensions_demo under Extensions section of config.yaml.

Available commands

Help

Send !!help to show available commands.

This command requires no extra module.

Show chat id

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.

Delete QQ Message

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.

Add telegram blocked keyword

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.

Add telegram blocked channel

Message originated from these channel will not be forwarded to any other chat

Reply forwarded channel message with !!bc