rclock (ouR CLOCK) clock and appointment reminder for X11
rclock version 2.21a3 is an analog clock for X intended as an xclock(1) replacement that conserves memory and has extra features: rclock enters reverse video if there is mail waiting; an appointment reminder is also builtin.
The options supported by rclock:
No X resources are used only command-line options.
The window and icon titles are set to the day of the week and the date. The icon window is "active" and will show the time, if supported by the window manager.
The ~/.rclock file lists the messages to display and/or the programs to run at specified times and dates. At the specified time, rclock will pop-up a window in the center of the screen to display the message or will simply run the scheduled program. rclock will reads the ~/.rclock file at startup, and every 10 minutes (to look for changes) and after a message window has been dismissed (to find the next appointment).
An entry in ~/.rclock may be one of two formats (blank and comment lines will be ignored):
hh:mm [dd] MM/DD/YY message[; program] or
[hh:mm [dd] MM/DD/YY [message]]; program
hh - hour (0-23; * = current) mm - minute (0-59; * = 0) dd
- days-of-week (some/all/none of umtwrfs; * = all) MM - month (1-12; * =
current) DD - day of month (1-31; * = current) YY - year (0-99 or
1900-????; * = current) message - message to display program
- program to execute
The days-of-the-week use the following abbreviations:
u=Sunday, m=Monday, t=Tuesday, w=Wednesday,
r=Thursday, f=Friday, s=Saturday, *=all.
If message is empty and program has been specified, it is executed without a dialog box. If time/date are also not specified, program is executed on start-up. Note message may contain escape values (\n: newline, \;: semicolon).
Here's a silly example file that shows some of the permissible constructs:
# ~/.rclock - My appointment file
# startup functions ; xsetroot -solid Black & # cron functions 10:00; xsetroot -solid Grey25 & 14:00; xsetroot -solid Grey75 & # daily/weekly reminders 08:15 mtwrf * Good Morning!\nRead News?; xvt -e News 12:00 mtwrf * Lunch Time! 17:00 mtwrf * Go Home 23:00 mtwrf * Still Here? Go to bed 08:10 twrf * Did you do your time card yesterday? 15:00 f * Friday, do your time card early! 16:00 mtwr * Do your time card 16:30 mtwrf * Did you do your time card? *:00 us * It's the weekend, why are you here? 8:15 f */13/* Friday the 13th! Careful! 8:15 * 4/1/* fkrkrmfismsmkd...dkdfk 8:16 * 4/1/* April Fools! # birthdays/anniversaries 16:00 05/21/* Pam's Birthday (next week) 16:00 05/24/* Pam's Birthday (in a few days) # once-of appointments 08:30 03/15/94 Dentist appointment 08:30 03/15/1999 Dentist appointment 08:30 03/15/2004 Dentist appointment
rclock uses the environment variable MAIL to determine the location of the user's mail spool file.
rclock is not very smart about dealing with errors encountered while reading the ~/.rclock file. Each reminder must be a single line not exceeding 255 characters. Reminder windows are sometimes not redrawn (left blank) when raised or uncovered.
Rob Nation nation@rocket.sanders.lockheed.com
Modifications by mj olesen olesen@me.QueensU.CA
Same as the current xvt maintainer.