Kumi
5c1d165774
Corrected the string formatting in the logging and messaging code for user lock/unlock operations. Fixed the use of incorrect quotation marks which led to syntax errors and inconsistent message formats. This ensures that log messages and notifications are properly formatted, enhancing readability and reducing potential debugging confusion. |
||
|---|---|---|
| .forgejo/workflows | ||
| src/matrix_roomba | ||
| .gitignore | ||
| config.dist.yaml | ||
| LICENSE | ||
| pyproject.toml | ||
| README.md | ||
| requirements.txt | ||
Matrix-Roomba
Roomba is a moderation bot for Matrix, designed to help manage rooms and enforce content policies. The bot can block/unblock rooms, shut down rooms, and notify users of shutdowns. It integrates with Synapse's administrative API and supports optional encryption through Pantalaimon.
Installation
pip install matrix-roomba
Create a configuration file in config.yaml based on the config.dist.yaml provided in the repository.
At the very least, you need to provide the following configuration:
homeserver: "https://matrix.example.com"
user_id: "@roomba:example.com"
access_token: "YOUR_ACCESS_TOKEN"
moderation_room_id: "!moderation_room_id:example.com"
Ensure that the bot user is an admin on the homeserver, as it needs to be able to moderate rooms. Also add the user to the moderation room before starting the bot.
We recommend using pantalaimon as a proxy, because the bot itself does not support end-to-end encryption.
You can start the bot by running:
Usage
- Start the bot:
roomba
- Send a message to the moderation room to get a list of available commands:
!roomba
Commands
In the moderation room, send commands to manage rooms:
- Block a room: !roomba block <room_id>
- Unblock a room: !roomba unblock <room_id>
- Shutdown a room: !roomba shutdown <room_id> [--purge]
- For help: !roomba
License
This project is licensed under the MIT License - see the LICENSE file for details.