Table of Contents
rclock (ouR CLOCK) -- clock and appointment reminder for X11
rclock [options]
rclock -- version 2.6.3 -- 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:
- -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].
- -iconic
- Start iconified, if supported by the window manager.
- -adjust ddhhmm
- Adjust
the clock by +/- ddhhmm (dd = days, hh = hours, mm = minutes) to fix an
incorrect clock without being root or for working in another time-zone.
- -update n
- Update clock face every n seconds [default 30]. If n=1, a seconds
hand is displayed.
- -mail n
- Check for new mail every n seconds [default
60]. The actual interval is a multiple of the clock update interval.
- #geom
- Specify the preferred icon window size [default 65x65].
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?; 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!
# 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 rxvt maintainer.
Table of Contents