Source Code For The Alarm Program

First you must download the source tarball.

Download Current Version

Copy or move the tarball to a directory of your choosing then:

tar -xzf alarm-1.0.tar.gz
cd alarm-1.0/
sudo make install
make clean

On First Run

When you run the program for the first time you will be asked to edit a file installed in $HOME/.config/alarm.txt
The first line in that file contains a path name to a media player and next line is a path to a video file to play.
Edit this file to suit your requirements.

How To Use The Program

The program operates in two modes, alarm clock mode and timer mode, ie a cooking timer.

alarm -a timespec # alarm clock.
alarm timespec # timer.

Timespec by example:

  • `alarm 1` # an unadorned number is minutes.
  • `alarm :60` # set for 60 seconds.
  • `alarm 1:30` # set for 90 seconds.
  • `alarm :90` # set for 90 seconds.
  • `alarm 1:00:00` # set for 1 hour.
  • `alarm 60:` # set for 1 hour.
  • `alarm 1::` # set for 1 hour.
  • `alarm :3600` # set for 1 hour.
  • `alarm -a 6:00:00` # next occurence of 6 am.
  • `alarm -a 6::` # next occurence of 6 am.

The only restriction on numbers in timespec is that no number may be negative.

But no alarm does not do anything clever. It does not boot your computer or awaken it from suspension or hibernation. You do need to leave the beast on to use it for an alarm clock.


Home page

Free Software

Software index

Go to the top of the page