No description
Find a file
Kumi e557e20cbe
feat: add lock and unlock user commands
Introduced `!roomba lock <user_id>` and `!roomba unlock <user_id>` commands to manage user access. These commands enable locking and unlocking user accounts via Matrix bot, enhancing moderation capabilities. Updated help message to reflect new commands.
2024-08-27 15:38:46 +02:00
.forgejo/workflows refactor(workflow): remove setup and test job 2024-08-17 15:51:04 +02:00
src/matrix_roomba feat: add lock and unlock user commands 2024-08-27 15:38:46 +02:00
.gitignore feat: introduce CI/CD workflow and packaging setup 2024-08-17 15:36:04 +02:00
config.dist.yaml fix(docs): correct grammar in configuration instructions 2024-08-09 12:12:40 +02:00
LICENSE feat: introduce CI/CD workflow and packaging setup 2024-08-17 15:36:04 +02:00
pyproject.toml chore: bump version to 0.1.1 2024-08-17 15:45:18 +02:00
README.md feat: introduce CI/CD workflow and packaging setup 2024-08-17 15:36:04 +02:00
requirements.txt feat: add RoombaBot for blocking/unblocking Matrix rooms 2024-08-07 10:28:30 +02:00

Matrix-Roomba

Support Private.coffee! PyPI PyPI - Python Version PyPI - License Latest Git Commit

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

  1. Start the bot:
roomba
  1. 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.