Skip to content

CubicrootXYZ/RemindMe

This branch is up to date with main.

Folders and files

NameName
Last commit message
Last commit date

Latest commit

45e3315 Β· Feb 14, 2025
Feb 2, 2025
Oct 20, 2024
Jan 15, 2023
Nov 23, 2024
Jun 10, 2022
May 1, 2024
Aug 25, 2024
Jul 31, 2021
Jul 17, 2022
Feb 14, 2025
Jul 31, 2021
Oct 20, 2024
Nov 23, 2024
Jan 22, 2025
Feb 11, 2025
Feb 11, 2025
May 5, 2024

Repository files navigation

Matrix reminder and calendar bot - RemindMe

GitHub license GitHub issues Actions Status

Logo

A matrix bot that handles reminders and knows your agenda.

⚠️ The main branch currently contains the v2 which is not backwards compatible. v1 is moved to the similiar named branch. ⚠️

Example

Example chat interaction

πŸ“‹ Features

  • Schedule reminders
  • Edit and delete reminders
  • Timezone support
  • Natural language understanding
  • Quick actions via reactions
  • Daily message with open reminders for the day
  • Repeatable reminders
  • Import reminders from an Ical link (via API)
  • iCal export of all reminders
  • Allow bot to be invited (enable in settings)
  • Whitelist of matrix accounts to interact with (enable in settings)
  • HTTP API (enable in settings)

Not yet ported to v2:

  • Block users (via API)

The following features are seen as experimental, we do not recommend them for use in production. Data losses or data leaks might happen.

  • Multi-User channels

πŸ‘©β€πŸ”§ Contribute

See our contribution guidelines.

πŸ” How to use the bot

After you have installed the bot it will invite every user in the config in a channel. Accept the invite and you are ready to interact with it.

New Reminder

To make a new reminder talk to the bot like this:

  • make laundry at sunday 16:00
  • walking with the dog 6am
  • brunch with alan at sunday

It tries to understand your natural language as best as it can.

List all available commands

To get all commands just type one of these lines:

  • commands
  • list all commands
  • show all commands
  • help

βš™οΈ Installation

See our installation guides. We provide docker container images or you can build the binary yourself.

πŸ“š Further documentation

Take a look into our wiki. It provides you with further information and troubleshooting guides.

API

The bot offers an API. It needs to be enabled in the settings where the api key for the "Admin-Authentication" needs to be set.

Checkout the API documentation.