Section: 2003 (1)
rclock (ouR CLOCK)
--- clock and appointment reminder for X11
--- is an analog clock for X intended as an
replacement that conserves memory and has extra features:
enters reverse video if there is mail waiting; an appointment reminder
is also builtin.
The options supported by
- -display displayname
Attempt to open a window on the named X display.
In the absence of this option, the display specified by the DISPLAY
environment variable is used.
- -geometry geom
Create the window with the specified X window geometry [default 80x80].
- -bg color
Window background color [default white].
- -fg color
Window foreground color [default black].
- -fn fontname
Select font used for reminders [default 7x14].
Do not display today's date on the face of the clock.
Start iconified, if supported by the window manager.
- -adjust ddhhmm
Adjust the clock by +/-
minutes) to fix an incorrect clock without being root or for working in
- -update n
Update clock face every
seconds [default 30].
a seconds hand is displayed.
- -mail n
Check for new mail every
seconds [default 60].
The actual interval is a multiple of the clock update interval.
- -mailfile mailfile
Override environmental variable MAIL with
as location for mail.
- -mailspawn cmd
when the face of the clock is clicked by the mouse button.
Specify the preferred icon window size [default 65x65].
Some of these options may not be available based on how rclock was compiled.
to determine which features are available.
No X resources are used --- only command-line options.
TITLES AND ICONS
The window and icon titles are set to the day of the week and the date.
The date is also displayed on the lower half of the clock unless the
option is specified.
The icon window is "active" and will show the time, if supported by
the window manager.
file lists the messages to display and/or the programs to run at
specified times and dates.
At the specified time,
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
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
may be one of two formats (blank and comment lines will be ignored):
hh:mm [dd] MM/DD/YY message[; program]
[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:
is empty and
has been specified, it is executed without a dialog box.
If time/date are also not specified,
is executed on start-up.
may contain escape values (\n: newline, \;: semicolon).
Here's a silly example file that shows some of the permissible
# ~/.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?; rxvt -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!
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
uses the environment variable
to determine the location of the user's mail spool file unless
option is specified.
is not very smart about dealing with errors encountered while reading the
Each reminder must be a single line not exceeding 255 characters.
Reminder windows are sometimes not redrawn (left blank) when raised or
Rob Nation <firstname.lastname@example.org
Modifications by mj olesen <olesen@me.QueensU.CA>
Same as the current rxvt maintainer.