Awesome
CoolQ Telegram Bot X
Language: đēđ¸ English | đ¨đŗ įŽäŊä¸æ
<img src="https://raw.githubusercontent.com/JogleLew/coolq-telegram-bot-x/resource/pic/logo.png" width="200">CoolQ Telegram Bot X is a message forwarding bot. This bot can help to forward messages from one QQ / Telegram group to another. With simple config, you can customize the forwarding logic in a convenient way. Feel free to link between QQ and Telegram, or merge different messages to one place.
Features
Deep Integration
CoolQ Telegram Bot X is an integration of QQ Bot and Telegram Bot. CoolQ Message SDK ensures the stability and availability of receiving and sending QQ messages every time. Telegram C++ SDK based on official Telegram Bot API shows its power to handle different kinds of messages. Forwarding logic unit will parse and transfer messages which QQ Bot or Telegram Bot receive to another group according to forward config.
All message SDKs and forwarding logic unit are packed into a CoolQ plugin. Start CoolQ, enable the plugin, and enjoy :)
<img src="https://raw.githubusercontent.com/JogleLew/coolq-telegram-bot-x/resource/pic/readme/readme-1.png" width="300">Multi-direction Forwarding
CoolQ Telegram Bot X supports various forwarding type. No matter QQ to Telegram, or Telegram to QQ, it can parse and transfer messages correctly. Besides, QQ to QQ and Telegram to Telegram message forwarding can help you organize and merge messages from different groups.
In some cases, you may need one-direction forwarding rather than bi-direction forwarding. Don't worry, CoolQ Telegram Bot X is still capable to do it.
<img src="https://raw.githubusercontent.com/JogleLew/coolq-telegram-bot-x/resource/pic/readme/readme-2.png" width="300">Smart Message Conversion
You may notice that QQ faces are special characters. CoolQ Telegram Bot X is so smart, converting QQ faces to emoji automatically when sending to Telegram group. In future work, we will support more special message conversion.
<img src="https://raw.githubusercontent.com/JogleLew/coolq-telegram-bot-x/resource/pic/readme/readme-3.png" width="300">Installation
Quite easy, just follow these steps:
-
Install CoolQ Main Program.
For Windows users, please download CoolQ from official website.
For Linux users, it is recommended to deploy Docker image from coolq/wine-coolq.
-
Download CoolQ plugin and example configuration json file from relesase page.
-
Place the cpk file to
CoolQ_Root_Directory/app/
and place the json file toCoolQ_Root_Directory/app/top.jogle.ctbx/config/
(You need to make the new directory yourself). -
Start CoolQ Main Program, enable the plugin.
For more details, please visit the installation guide in repository wiki.
Configuration
Generally, if you need message sending to / receiving from Telegram groups, a Telegram bot token is needed to fill in config file. Then customize the forwarding rule in config file, you will find the bot works functionally.
For more details, please visit the configuration guide in repository wiki.
Join Development
The source code is a Visual Studio 2017 project, and requires a compiler supporting C++ 17 standard. Please use Microsoft/vcpkg to install dependencies: boost
ãlibiconv
ãjsoncpp
.
For more details, please visit the development guide in repository wiki.
If you find some trouble in using or developing CoolQ Telegram Bot X, you can join our Support Group (Telegram).
Alternative
You know, There is a Python version: jqqqqqqqqqq/CoolQ Telegram Bot.
What to choose? In short, the Python version focuses more on new features and extensiblility, but the C++ version cares more on convenience and simple deployment.
C++ Version | Python Version | |
---|---|---|
Forwarding direction | One-direction forwarding, bi-direction forwarding | Bi-direction forwarding |
Forwarding group | QQ - Telegram, QQ - QQ, Telegram - Telegram | QQ - Telegram |
Text forwarding | Support | Support |
Picture forwarding | Support | Support |
Audio forwarding | Unsupport (in plan) | Partly support |
Other message forwarding | Change to text message | Change to text message |
Credit
CoolQ Telegram Bot X is derived from jqqqqqqqqqq/CoolQ Telegram Bot.
CoolQ Message SDK is based on richardchien/coolq-cpp-sdk
Telegram C++ SDK uses the code from reo7sp/tgbot-cpp