rumpelsepp/rbot
1
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity
My collection of silly matrix bots
37 commits 1 branch 0 tags 112 KiB
Find a file
Stefan Tatschner 204145a754 Add BERT stuff
2020-08-02 10:21:05 +02:00
.gitignore Add urlbot and modularize bot module 2020-04-23 09:24:12 +02:00
bot.py Cleanup import mess 2020-05-28 08:07:47 +02:00
LICENSE Initial commit 2020-02-16 23:50:48 +01:00
README.md Update readme 2020-04-23 13:19:30 +02:00
remindbot.py Add urlbot and modularize bot module 2020-04-23 09:24:12 +02:00
urlbot.py Add BERT stuff 2020-08-02 10:21:05 +02:00

README.md

rbot

This is rumpelsepp's collection of matrix bots. There is a small “library” for theses bots in bot.py.

Run

All bots can be run on any computer from the command line with zero configuration. No special setup (e.g. reverse proxy, …) is required. A dedicated matrix user is required for each bot.

urlbot

A simple bot who spits out the HTML title of an URL. To avoid spam the bot only considers lines where the URL is the only content. http or https prefix es required.

remindbot

Remindbot is a very simple matrix bot for leightweight reminders. It's in its early days, expect bugs, feel free to test and send feedback!

Usage

The bot is bound to a matrix user, for my usage it is @remindbot:myhomeserver.de. In a direct chat a (kind of) shell like interface is exposed:

  • notify TIMESPEC [MESSAGE]: Send the specified message at TIMESPEC.
  • table: Show the queued reminders
  • rm ID [ID [ID]…]: Delete task(s) with ID.
  • help: Show a help page

Timespec

The timespec is simple, these variants exist:

  • 5: 5 seconds
  • 5[smhd]: 5 seconds, minutes, hours, days
  • HH:MM: time on current day
  • tomorrow HH:MM: time on the next day
  • YYYY:mm:dd HH:MM: arbitrary day+time

24h format must be used.

Caveats

Only use a direct chat (for now)

Do not run the bot in a room with more people. I want that the bot react only on mentions, but this is not implemented yet! Currently, it parses every message which would spam the chatroom. Only use the bot in direct conversations, for now.

No state

Currently, the bot looses all queued tasks on restart. This is on the radar.

Table is global

The scope of the task table must be filtered per room. Currently, it returns the whole table. Do not report this as a privacy issue, please. This will be addressed soon.

Bugs/Patches

I assume there are lots of bugs in this fresh piece of software. Just write an email, or send patches to: ~rumpelsepp/public-inbox@lists.sr.ht