Logo credits: Alarm clock stickers created by Stickers - Flaticon

Remindrix

A chatbot for reminders on Matrix servers focused on multilingual support and user experience. Schedule reminders on the go in personal or group rooms - Remindrix serves as your smart, quiet assistant.

Key Features

• ⏲️ Create reminders with the /remind command or without it.
• 📅 Set natural language reminders with customizable default times.
• 🌐 Individual time zones for rooms.
• 🔤 Multilingual support both for commands and responses, with the capability to upload your own translations.
• 📋 Send a summary of missed reminders in each room.
• 🎹 Customizable command aliases, calling the bot without a command for quick reminders, and mentioning the bot in group chats to activate it.
• 👩‍💻 "Pro" or CLI mode with flags for date, time, interval, and reminder delegation to other room.

Matrix Account Features

• Login to the bot's Matrix account with a password and token, automatic device verification and backup if this is the first device for the account, and receiving a recovery key
• Manual verification with a recovery key if the bot account has been logged in to before, and backup enabled via the command line (CLI)
• Verification of other devices on which the bot is authorized
• Reset all verification settings with the ability to save or delete the backup and receive a new recovery key

Screenshots

Welcome message	Interacting with bot responses as reactions (digits are time until)	New reminder	Notification with summary of missed reminders	Setting a room's time zone

Quick Start

Docker Run

docker run -d --name remindrix --restart unless-stopped \
  -v remindrix:/app/data/remindrix \
  -e MATRIX_HOMESERVER=homeserver-url \
  -e MATRIX_TOKEN=your-token \
  ghcr.io/outarde/remindrix:latest

Docker Compose

For more persistent setup use docker-compose.yml.

Set the environment variables as shown in example.env:

1. MATRIX_HOMESERVER — Matrix homeserver address.
2. MATRIX_USERNAME and MATRIX_PASSWORD — bot's username and password. Create a user via Matrix Authentication Service (MAS): docker exec matrix-auth mas-cli manage register-user USERNAME --password PASSWORD.
3. MATRIX_TOKEN — specify this variable when authenticating via token rather than username and password.

Important

Make sure the bot's data folder /app/data is bound to the host in volumes section. Otherwise, the bot will create a new session each time it's started.

Optional Configuration

Language and other additional settings are stored in a config.yml file in a folder or volume that you have bound to the /app/data/remindrix folder inside the container. Use config.example.yml as a starting point.

Available Languages

en English 🇬🇧, de German 🇩🇪, fr French 🇫🇷, it Italian 🇮🇹, es Spanish 🇪🇸, sv Swedish, aka IKEAish 🇸🇪, pl Polish 🇵🇱, cs Czech 🇨🇿, fi Finnish 🇫🇮, ja Japanese 🇯🇵, zh Chinese Simplified 🇨🇳, ru Russian 🇷🇺, uk Ukrainian 🇺🇦.

You can also upload your custom translation.

Usage

Start a Chat

Create a conversation with the bot or add it to a room. Send the /remind, !remind or command in your chosen language to get help:

I am a reminder bot. Send: /remind and the date, time and reminder text on the same line. For example: /remind 19.08.2026 20:03 your reminder.

📅 Date

• 19.08.2026, 19/08/2026, 19-08
• 19 August, 19 aug
• today, tomorrow

🕐 Time

• 20:03, 20.03, at 20:03, 8 p.m.
• morning, afternoon, evening

If you do not specify the time, the reminder will come at 09:00.

⚙️ Commands

Put / or ! at the beginning.

• remind - create a reminder
• settings - bot settings, including time zone
• remind --help - print help for Pro mode

Feature Roadmap

Reminders Preferences:

• Optional activation of the bot without a command
• Optional requirement to mention the bot in group chats
• Time zone settings
• Individual user settings

Commands:

• Alternative text for the bot activation command
• Bot’s replies via reactions
• Delegation of reminders
• Sending a list of reminders
• Recurring reminders
• Reaction-as-a-button

Language and Translation:

• Adding languages
• Upload your own translation
• Pro/CLI mode
• More advanced parsing of reminder date and time from user messages

Other:

• Database cleanup settings
• Alarm mode
• Learn to not be late

Alternatives

🐍 matrix-reminder-bot by anoadragon

Pros:

• Boasts extensive reminder functionality, including recurring reminders and alarm-style reminders with notifications.
• Supports natural language date and time recognition with virtually no limitations.

Cons:

• Built using the matrix-nio framework, which does not support retrieving cross-signing keys or room key backups. In other words, bot device verification likely fails, requiring a fresh account with a single device. I was unable to even launch the bot on my server using the Matrix Authentication System (MAS).
• Supports only English.
• Lacks time zone support.
• Lacks user-specific settings and offers limited configuration via config.yaml.
• Infrequent updates.

🌈 RemindMe by CubicrootXYZ

Pros:

• Offers the most extensive feature set of any bot.
• Supports time zones.
• Includes an API.

Cons:

• It is essentially a task manager within a messenger - or an interface for a full-fledged task management app - rather than a simple reminder bot. Its functionality is overkill for most servers.
• Supports only English.

Other

• reminder for Maubot: supports time zones as well as multilingual command input (with an easy way to add your own language). However, it is designed for a plugin-based Matrix bot system that requires installation (though a web version of the bot is available). The last release was in 2022.
• matrix_tomato_reminder_bot by progserega: a bilingual bot based on matrix-nio with basic functionality.
• YARB by dfuchss: supports advance notifications and features a particularly interesting function for creating reminder polls with a voting deadline; these polls send the winning result to participants once the set time arrives. However, it does not support encrypted rooms or time zones. It is monolingual.
• Bots based on an obsolescent framework matrix-bot-sdk.

Beyond the Quick Start

⚙️	💬	☑️
For a full description of bot settings, see the configuration.md help page.	For details on using the bot, see usage.md.	For information on interacting with the Matrix homeserver and managing your account, including device verification, see matrix.md.

---

I am developing this bot with a focus on users, to make communication via the Matrix protocol more convenient where it is an indispensable option for personal, non-censored communication.

You can read more about the original goals of this project in this Reddit post. Your suggestions and issue reports are invaluable for me and the 🤖!