mirror of
https://github.com/maubot/maubot
synced 2025-08-29 10:00:38 +00:00
59 lines
3.6 KiB
Markdown
59 lines
3.6 KiB
Markdown
# maubot
|
|
|
|
[](LICENSE)
|
|
[](https://github.com/maubot/maubot/releases)
|
|
[](https://mau.dev/maubot/maubot/container_registry)
|
|
[](https://github.com/psf/black)
|
|
[](https://pycqa.github.io/isort/)
|
|
|
|
A plugin-based [Matrix](https://matrix.org) bot system written in Python.
|
|
|
|
## Documentation
|
|
|
|
All setup and usage instructions are located on
|
|
[docs.mau.fi](https://docs.mau.fi/maubot/index.html). Some quick links:
|
|
|
|
* [Setup](https://docs.mau.fi/maubot/usage/setup/index.html)
|
|
(or [with Docker](https://docs.mau.fi/maubot/usage/setup/docker.html))
|
|
* [Basic usage](https://docs.mau.fi/maubot/usage/basic.html)
|
|
* [Encryption](https://docs.mau.fi/maubot/usage/encryption.html)
|
|
|
|
## Discussion
|
|
Matrix room: [#maubot:maunium.net](https://matrix.to/#/#maubot:maunium.net)
|
|
|
|
## Plugins
|
|
Open a pull request or join the Matrix room linked above to get your plugin listed here.
|
|
|
|
The plugin wishlist lives at <https://github.com/maubot/plugin-wishlist/issues>.
|
|
|
|
### Official plugins
|
|
* [sed](https://github.com/maubot/sed) - A bot to do sed-like replacements.
|
|
* [factorial](https://github.com/maubot/factorial) - A bot to calculate unexpected factorials.
|
|
* [media](https://github.com/maubot/media) - A bot that replies with the MXC URI of images you send it.
|
|
* [dice](https://github.com/maubot/dice) - A combined dice rolling and calculator bot.
|
|
* [karma](https://github.com/maubot/karma) - A user karma tracker bot.
|
|
* [xkcd](https://github.com/maubot/xkcd) - A bot to view xkcd comics.
|
|
* [echo](https://github.com/maubot/echo) - A bot that echoes pings and other stuff.
|
|
* [rss](https://github.com/maubot/rss) - A bot that posts RSS feed updates to Matrix.
|
|
* [reminder](https://github.com/maubot/reminder) - A bot to remind you about things.
|
|
* [translate](https://github.com/maubot/translate) - A bot to translate words.
|
|
* [reactbot](https://github.com/maubot/reactbot) - A bot that responds to messages that match predefined rules.
|
|
* [exec](https://github.com/maubot/exec) - A bot that executes code.
|
|
* [commitstrip](https://github.com/maubot/commitstrip) - A bot to view CommitStrips.
|
|
* [supportportal](https://github.com/maubot/supportportal) - A bot to manage customer support on Matrix.
|
|
* †[gitlab](https://github.com/maubot/gitlab) - A GitLab client and webhook receiver.
|
|
* [github](https://github.com/maubot/github) - A GitHub client and webhook receiver.
|
|
* [tex](https://github.com/maubot/tex) - A bot that renders LaTeX.
|
|
* [altalias](https://github.com/maubot/altalias) - A bot that lets users publish alternate aliases in rooms.
|
|
* [satwcomic](https://github.com/maubot/satwcomic) - A bot to view SatWComics.
|
|
* [songwhip](https://github.com/maubot/songwhip) - A bot to post Songwhip links.
|
|
* [manhole](https://github.com/maubot/manhole) - A plugin that lets you access a Python shell inside maubot.
|
|
|
|
### Deprecated/unmaintained plugins
|
|
* [jesaribot](https://github.com/maubot/jesaribot) - A simple bot that replies with an image when you say "jesari".
|
|
* Superseded by reactbot
|
|
* [gitea](https://github.com/saces/maugitea) - A Gitea client and webhook receiver.
|
|
|
|
### 3rd party plugins
|
|
While not a comprehensive list, https://maubotplugins.mssj.me aims to be a crowd-sourced list of plugins from around the
|
|
web.
|