A Twitter bot to remember things or threads.

• About
• Usage
  • Example Usage
• Time Options
• FAQ
  • Why was the message off by a few minutes?
  • Where is this bot running?
  • How do I see all my reminders?
  • How do I delete/edit a reminder?
• Running
• License

For example, someone tweets a playlist while you're in a meeting. Simply reply to the tread by tagging "@slashRemindMe" and a suitable time when you would like to be reminded. The reminder is sent as a tweet only to you.

Did a politician just make claims about future? @slashRemindMe a year "to check these claims" on the tweet, and see if they were right or not.

Think of @slashRemindMe as a "save for later" natively on Twitter. Here's some example uses.

Simply create a tweet in the format @slashRemindMe TIME OPTION "MESSAGE" (with quotes).

Time option and message order don't matter. They are also optional. Meaning if you can do a simple @slashRemindMe it will default to 1 day and a standard message. Everything before @slashRemindMe is not caught and everything after is.

The message will be shown in the reminder tweet.

• Good claims. I'll check them later. @slashRemindMe 4pm
• @slashRemindMe 16 Jan 2016 "Pres debate happening"

• Bot tries to figure out your timezone. If it cannot, it defaults to UTC.
• There are more options than stated here. Try to see if you can find more and I'll add them!
• EOY means end of year
• EOM means end of month
• EOD means end of day
• BOLDED TIMES INDICATE A SET IN STONE TIME (which can cause problems if you don't live in UTC)
• It's better to use 10 minutes, 24 hours, 4pm on 1 dec etc than tomorrow/next week/next month because of above

The bot currently goes to sleep every 2 minutes to save on resources. Meaning your message can be as late as 2 minutes + any connection issues it is having with Twitter.

Currently I'm running this bot on a 1GB DigitalOcean instance (yes, that's an affiliate link. Use that to get a free VPS). The bot is not resource-intensive and uses a couple dozen MBs of RAM.

That is currently not possible.

That is currently not possible.

• Docker
• Docker Compose
• Docker Machine (Mac OS X)

Create a file called config.env that looks like config_example.env. Fill in the necessary values.

For Twitter config:

1. Register your app
2. Get your app's key and secret.
3. Create token and get the token and secret.

Then, to run the bot:

$ docker-compose up

If you're using Docker Machine, follow these instructions for installation:

# Provision the docker engine
$ docker-machine create --driver virtualbox remindbot

# Set the environment
$ eval "$(docker-machine env remindbot)"

# See the IP address of the host
$ docker-machine ip remindbot

# Start the container
$ docker-compose up

Apache 2.0

Strongly inspired by the reddit bot.