Reminder System

Set personal reminders and get notified at the right time

Overview

The reminder system lets you set personal reminders for yourself. The bot will send you a notification when the time is up. Perfect for remembering tasks, events, or anything you need to be reminded about.

Reminders are personal - only you will receive notifications for your reminders.

---

Commands

remind

Set a new reminder for yourself.

Syntax

~remind <time> <message>

Parameters:

• time — When to remind you (10s minimum, 1y maximum)
• message — What to remind you about (max 200 characters)

Time Format:

• s = seconds (e.g., 30s)
• m = minutes (e.g., 15m)
• h = hours (e.g., 2h)
• d = days (e.g., 5d)
• M = months (e.g., 2M = 60 days)
• y = years (e.g., 1y = 365 days)

Limits:

• Minimum: 10 seconds
• Maximum: 1 year
• Message: 200 characters max

Aliases: reminder, remindme
Permissions: None

remind list

View all your active reminders.

Syntax

~remind list

What It Shows:

• All your active reminders
• Reminder message
• When each reminder will trigger
• Numbered list format

Aliases: reminder list, remindme list
Permissions: None

remind clear

Clear all your active reminders.

Syntax

~remind clear

What It Does:

• Removes ALL your reminders
• Cannot be undone
• Does not affect other users’ reminders

This clears all your reminders permanently.

Aliases: reminder clear, remindme clear
Permissions: None

---

How It Works

1. Set a Reminder

   Create a reminder with time and message:

   ~remind 2h Meeting with Sarah
   
2. Bot Confirms

   The bot confirms your reminder:

   ⏰ Reminder set for in 2 hours
   
3. Get Notified

   When time is up, the bot sends you a DM or message:

   🔔 Reminder: Meeting with Sarah
   

---

Time Format Guide

Seconds

~remind 30s Quick task
~remind 45s Check status

Format: <number>s
Range: 10s - 59s
Use for: Very short reminders

Minutes

~remind 5m Break time
~remind 15m Check oven
~remind 30m Call back
~remind 90m Long meeting

Format: <number>m
Range: 1m - unlimited
Use for: Short to medium tasks

Hours

~remind 1h Lunch break
~remind 2h Team meeting
~remind 4h End of workday
~remind 12h Tomorrow morning

Format: <number>h
Range: 1h - unlimited
Use for: Same-day reminders

Days

~remind 1d Tomorrow's task
~remind 3d Appointment
~remind 7d Weekly check-in
~remind 14d Bi-weekly meeting

Format: <number>d
Range: 1d - unlimited
Use for: Multi-day reminders

Months & Years

~remind 1M Monthly review
~remind 3M Quarterly report
~remind 6M Half-year review
~remind 1y Annual renewal

Format: <number>M or <number>y
Note: 1M = 30 days, 1y = 365 days
Use for: Long-term reminders

---

Permission Requirements

No Permissions Needed

Anyone can use reminders - no special permissions required.

The bot needs permission to:

• Send messages in the channel
• Send DMs to users (for private reminders)

---

Aliases

remind

Main command

reminder

Full form

remindme

Casual alias

---

Usage Examples

Quick Reminders

# Short-term tasks
~remind 5m Check the door
~remind 10m Timer is up
~remind 15m Break time
~remind 30m Call John back

Daily Tasks

# Same-day reminders
~remind 1h Lunch meeting
~remind 2h Team standup
~remind 4h Submit report
~remind 8h End of shift

Multi-Day

# Future reminders
~remind 1d Tomorrow's appointment
~remind 3d Doctor visit
~remind 7d Weekly review
~remind 14d Bi-weekly sync

Long-Term

# Months ahead
~remind 1M Monthly report
~remind 2M Insurance renewal
~remind 6M Half-year review
~remind 1y Annual subscription

Management

# View reminders
~remind list

# Clear all reminders
~remind clear

# Set multiple reminders
~remind 30m Task 1
~remind 1h Task 2
~remind 2h Task 3

---

Common Use Cases

Work/study deadlines

~remind 1d Submit assignment
~remind 3d Project deadline
~remind 1M Final exam

Track important deadlines and assignments.

Meetings & appointments

~remind 30m Team meeting in 30 minutes
~remind 2h Doctor appointment
~remind 1d Meeting with client tomorrow

Never miss an important meeting.

Personal tasks

~remind 5m Take medicine
~remind 1h Water the plants
~remind 12h Feed the pets

Remember daily routines and chores.

Cooking & timers

~remind 10m Check the oven
~remind 15m Stir the pot
~remind 45m Dinner is ready

Set cooking timers and reminders.

Follow-ups

~remind 2h Follow up with John
~remind 1d Check if Sarah replied
~remind 3d Second follow-up

Track when to follow up on messages.

Breaks & health

~remind 30m Take a break
~remind 1h Drink water
~remind 2h Stretch and move

Remember to take care of yourself.

---

Tips & Best Practices

Setting Reminders

• Be specific in your reminder text
• Use appropriate time units (don’t use 120m, use 2h)
• Set reminders in advance, not last minute
• Keep messages under 200 characters
• Use ~remind list to track all your reminders

Managing Reminders

• Check your reminder list regularly
• Clear old reminders you no longer need
• Set buffer time (remind 15m before, not at exact time)
• Use reminders for recurring tasks
• Consider timezone - reminders use your current time

---

Troubleshooting

Not Receiving Reminders

Issue: You didn’t receive the reminder notification.

Solutions:

1. Check if bot can send DMs (enable DMs from server members)
2. Verify you haven’t blocked the bot
3. Check if the reminder was set correctly with ~remind list
4. Ensure the channel where you set the reminder still exists

”Invalid time format”

Issue: Bot doesn’t recognize your time format.

Solutions:

1. Use format: <number><unit> (e.g., 30m, not 30 minutes)
2. Valid units: s, m, h, d, M, y
3. No spaces between number and unit
4. Use whole numbers only

”Reminder must be at least 10 seconds”

Issue: Time is too short.

Solution: Set reminders for at least 10 seconds (use 10s or longer)

“Reminder cannot be more than 1 year”

Issue: Time is too long.

Solution: Maximum reminder time is 1 year (365 days)

---

Important Notes

Limitations

• Reminders are stored locally and may be lost if bot restarts
• No recurring/repeating reminders (set manually each time)
• Maximum 1 year in advance
• Minimum 10 seconds
• 200 character limit on reminder text

Delivery

• Reminders are sent via DM if possible
• Falls back to the channel where you set the reminder
• You must have DMs enabled from server members
• Bot must have permission to message you

---

Related Features

Message Counter

Track activity and stats

Giveaways

Set up timed events and giveaways

Auto Responders

Automated message responses

Welcome Messages

Automated welcome system