A plugin-based Matrix bot system.
Go to file
Tobias Schönberg 33d7892e13 Fix choosing SPDX license during plugin init
The keys used to be lower case, but were changed to mixed case
in this commit:

068e268c63

The identfier are now used as inputted by the user.
2022-08-14 21:53:19 +02:00
.github/workflows Update and unpin black 2022-03-28 22:24:08 +03:00
docker Remove legacy alembic command in docker/run.sh 2022-06-24 18:21:53 +03:00
examples Add missing file 2022-03-27 20:05:34 +03:00
maubot Fix choosing SPDX license during plugin init 2022-08-14 21:53:19 +02:00
.dockerignore Remove .md files from .dockerignore 2020-07-12 18:06:31 +03:00
.editorconfig Add changelog in a file 2022-03-25 20:51:44 +02:00
.gitignore Add missing file 2022-03-25 20:28:16 +02:00
.gitlab-ci-plugin.yml Add GitLab CI file used by all plugins 2022-06-19 14:23:06 +03:00
.gitlab-ci.yml Don't fail CI if removing one of the standalone tags fails 2021-11-30 12:37:34 +02:00
.pre-commit-config.yaml Fix typo in pre commit config 2022-05-27 22:48:23 +03:00
CHANGELOG.md Bump version to 0.3.1 2022-03-29 20:40:01 +03:00
dev-requirements.txt Update and unpin black 2022-03-28 22:24:08 +03:00
Dockerfile Update Docker image to Alpine 3.15 2022-03-25 20:51:40 +02:00
Dockerfile.ci Update Docker image to Alpine 3.15 2022-03-25 20:51:40 +02:00
LICENSE Initial commit 2018-06-14 01:41:05 +03:00
MANIFEST.in Add changelog in a file 2022-03-25 20:51:44 +02:00
optional-requirements.txt Add support for asyncpg plugin databases 2022-03-26 13:59:49 +02:00
pyproject.toml Update and unpin black 2022-03-28 22:24:08 +03:00
README.md Add urlpreview and metric plugins to readme 2022-03-25 19:53:19 +02:00
requirements.txt Update mautrix-python 2022-07-10 14:42:41 +03:00
setup.py Add changelog in a file 2022-03-25 20:51:44 +02:00

maubot

Languages License Release GitLab CI Code style Imports

A plugin-based Matrix bot system written in Python.

Documentation

All setup and usage instructions are located on docs.mau.fi. Some quick links:

Discussion

Matrix room: #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 - A bot to do sed-like replacements.
  • factorial - A bot to calculate unexpected factorials.
  • media - A bot that replies with the MXC URI of images you send it.
  • dice - A combined dice rolling and calculator bot.
  • karma - A user karma tracker bot.
  • xkcd - A bot to view xkcd comics.
  • echo - A bot that echoes pings and other stuff.
  • rss - A bot that posts RSS feed updates to Matrix.
  • reminder - A bot to remind you about things.
  • translate - A bot to translate words.
  • reactbot - A bot that responds to messages that match predefined rules.
  • exec - A bot that executes code.
  • commitstrip - A bot to view CommitStrips.
  • supportportal - A bot to manage customer support on Matrix.
  • gitlab - A GitLab client and webhook receiver.
  • github - A GitHub client and webhook receiver.
  • tex - A bot that renders LaTeX.
  • altalias - A bot that lets users publish alternate aliases in rooms.
  • satwcomic - A bot to view SatWComics.
  • songwhip - A bot to post Songwhip links.
  • manhole - A plugin that lets you access a Python shell inside maubot.

3rd party plugins

  • subreddit linkifier - A bot that condescendingly corrects a user when they enter an r/subreddit without providing a link to that subreddit
  • giphy - A bot that generates a gif (from giphy) given search terms
  • trump - A bot that generates a Trump tweet with the given content
  • poll - A bot that will create a simple poll for users in a room
  • urban - A bot that fetches definitions from Urban Dictionary.
  • twilio - Maubot-based SMS bridge
  • tmdb - A bot that posts information about movies fetched from TheMovieDB.org.
  • invite - A bot to generate invitation tokens from matrix-registration
  • wolframalpha - A bot that allows requesting information from WolframAlpha.
  • pingcheck - A bot to ping the echo bot and send rtt to Icinga passive check
  • ticker - A bot to return financial data about a stock or cryptocurrency.
  • weather - A bot to get the weather from wttr.in and return a single line of text for the location specified
  • youtube previewer - A bot that responds to a YouTube link with the video title and thumbnail.
  • reddit previewer - A bot that responds to a link of a reddit post with the sub name and title. If available, uploads the image or video.
  • pocket - A bot integrating with Pocket to fetch articles and archive them.
  • alternatingcaps - A bot repeating last message using aLtErNaTiNg cApS.
  • metric - A bot that will reply to a message that contains imperial units and replace them with metric units.
  • urlpreview - A bot that responds to links with a link preview embed, using Matrix API to fetch meta tags

† Uses a synchronous library which can block the whole maubot process (e.g. requests instead of aiohttp)

Deprecated/unmaintained plugins

  • jesaribot - A simple bot that replies with an image when you say "jesari".
    • Superseded by reactbot
  • gitea - A Gitea client and webhook receiver.