Alarm clock toy project for RMU
Switch branches/tags
Nothing to show
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.



Basically the project is a glorified alarm clock, or the 'reminder' part of a calendar application. You tell a server you have an event at a given time and/or given duration and it sends you a reminder at the point in time the event is due to start or end (or at some configurable duration before). You can snooze the reminder (for some configurable duration), or turn it off. You can have multiple reminders going at once.

There are basically three components:

  • the 'client' which sends user event requests to
  • the 'server' which keeps track of when reminders are due and sends them to
  • the 'alarm' which notifies the user in some way and sends user 'snooze' or 'off' requests to the server

The main constraints are

  1. The interface for setting up reminders has to be almost as easy as turning the dial of an egg timer;
  2. The communication between the client requesting a reminder and the server sending the reminder is asynchronous;
  3. The alarm mechanism (on the client side) should be able to be 'obtrusive', and not necessarily run in the same process as the client program that sends reminder requests to the server; but
  4. The default alarm mechanism should be something very basic that makes few assumptions about what software the client has installed.


The client interface is via command line.


remindr 10                          # generic reminder in 10 minutes
remindr 30s                         # reminder in 30 seconds
remindr 25 get up and stretch       # message reminder
remindr 10:30 walk the dog          # reminder at specified time
remindr --end 11pm-12:30pm meeting  # reminder at end of timed event

Project roadmap

I am implementing a simplified app in two different ways and comparing them, before working in more detail on the alarm mechanism and client interface. See the ROADMAP file for more details.

Note As of Sep 21, only the first phase (Eventmachine implementation) has been done.

I've put in the scaffolding for the second phase but not much else.