mirror of https://github.com/wah-su/stickerbridge.git synced 2025-04-04 23:34:40 +00:00

Telegram -> Matrix stickerpack bot | Forked from: https://codeberg.org/Didek/stickerbridge

Find a file

Dawid Rejowski 33efe80c21 Add README.md		2022-09-11 22:38:20 +02:00
.idea	Initial commit	2022-09-11 18:34:24 +02:00
.directory	Initial commit	2022-09-11 18:34:24 +02:00
.gitignore	Initial commit	2022-09-11 18:34:24 +02:00
avatar.png	Initial commit	2022-09-11 18:34:24 +02:00
bot_commands.py	Single status code for MatrixReuploader	2022-09-11 18:48:11 +02:00
callbacks.py	Initial commit	2022-09-11 18:34:24 +02:00
chat_functions.py	Initial commit	2022-09-11 18:34:24 +02:00
config.yaml.example	Add README.md	2022-09-11 22:38:20 +02:00
LICENCE.md	Add LICENCE.md	2022-09-11 20:18:23 +02:00
main.py	Create data folder on start	2022-09-11 18:47:46 +02:00
matrix_reuploader.py	Single status code for MatrixReuploader	2022-09-11 18:48:11 +02:00
README.md	Add README.md	2022-09-11 22:38:20 +02:00
requirements.txt	Initial commit	2022-09-11 18:34:24 +02:00
sticker_types.py	Initial commit	2022-09-11 18:34:24 +02:00
telegram_exporter.py	Add README.md	2022-09-11 22:38:20 +02:00

README.md

Telegram -> Matrix stickerpack importer

This bot allows for simple and quick copying Telegram stickers into Matrix rooms. Stickers can be used in clients that implemented them natively by Matrix (msc2545) like FluffyChat, Nheko and Cinny. Element currently does not support native stickers (can only display them when send by others).

Requirements

Python 3.9+ and pip
Matrix account dedicated for the bot
Telegram API keys and bot token (Please don't share it with anyone)

Instalation

Create new Matrix account dedicated for the bot
Get Telegram API key and API hash from https://my.telegram.org/apps
Create new Telegram bot and get bot token by talking to https://t.me/botfather
Clone this repository and install dependencies

git clone https://codeberg.org/ghostermonster/stickerbridge 
cd stickerbridge
pip install -r requirements.txt

Copy example config file cp config.yaml.example config.yaml
Fill the config file with creditials for Matrix account and Telegram bot you created
Run the bot python main.py

Usage

Invite the bot in a room (currently does not support encrypted rooms), type !sb help to list available commands. Type import <stickerpack name> to import stickerpack to the room, ex. import bestblobcats. After importing is completed, you will see stickerpack in the menu.