mxbt 0.3.7

Yet another Matrix bot library.

mxbt

Yet another Matrix bot library, built on matrix-nio.

Feauters

• Simple and powerfull bots creating
• Custom emojis support
  • Getting
  • Sending
  • Creating
• Files sending (external & internal)
• Native mentions
• Access to matrix-nio features
• Event filters
• Bot modules support
• Wait for event system
• E2EE support (check docs before)

Installation

With pip:

$ pip install mxbt

With git and python:

$ git clone https://codeberg.org/librehub/mxbt
$ cd mxbt
$ python -m pip install . 

Getting started

More examples here or in docs.

from mxbt import Bot, Context, Creds, Config, Filter, Listener
import asyncio

bot = Bot(
    creds=Creds.from_env(               # You also can use Creds.from_json and just Creds() 
        homeserver="MATRIX_HOMESERVER",
        username="MATRIX_USERNAME",
        password="MATRIX_PASSWORD"
    ),                               
    config=Config()                     # Config has many options for bot, like prefix, selfbot, encryption, etc...
)
lr = Listener(bot)

@lr.on_command(prefix="?", aliases=["test", "t"])
async def ctx_echo(ctx: Context) -> None:       # Context object contains main info about event
    await ctx.reply(ctx.body)                   # Reply message to event room

if __name__ == "__main__":
    asyncio.run(lr.start_polling())

.env structure

MATRIX_HOMESERVER=https://matrix.org/
MATRIX_USERNAME=user
MATRIX_PASSWORD=password

Built with mxbt

Project	Description	Project	Description
sofie	A simple selfbot	charon	Simple bridge between some messengers
cryptomx	A crytpocurrency notification bot	taskmx	Simple project tasks bot

Special thanks

• matrix.org for beautiful protocol.
• simplematrixbotlib for base parts of API, Listener and Callbacks code ideas. Code from simplematrixbotlib is included under the terms of the MIT license - Copyright (c) 2021-2024 Isaac Beverly
• matrix-nio for cool client library.

Support

Any contacts and crytpocurrency wallets you can find on my profile page.